REST API Overview

The DesignAdvertise REST API provides programmatic access to campaigns, creative, analytics, and configuration. Use the API to build custom integrations, automate workflows, or embed DesignAdvertise capabilities into your own applications.

Base URL

https://api.designadvertise.ai/v1

All API requests use HTTPS. HTTP requests are rejected. The current API version is v1.

Authentication

Authenticate using API keys. Generate keys in Settings → API → Keys. Include your key in the Authorization header of every request.

curl -H "Authorization: Bearer da_live_abc123..." \
     https://api.designadvertise.ai/v1/campaigns

API keys have the same permissions as the user who created them. Create separate keys for different integrations, and rotate keys periodically. Revoke compromised keys immediately from the same settings page.

Rate limits

• Starter plan — 60 requests per minute, 10,000 per day
• Growth plan — 300 requests per minute, 100,000 per day
• Enterprise plan — 1,000 requests per minute, unlimited daily

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset. If you exceed your limit, the API returns 429 Too Many Requests with a Retry-After header.

Response format

All responses are JSON. Successful responses return a 'data' field. Error responses return an 'error' object with 'code', 'message', and 'details' fields. Pagination uses cursor-based pagination with 'next_cursor' and 'has_more' fields.

{
  "data": [...],
  "has_more": true,
  "next_cursor": "eyJpZCI6MTIzfQ=="
}