Using with AI
Drop one of these into any AI tool or agent alongside your API key:
https://docs.adspo.co/llms.txt
https://docs.adspo.co/llms-full.txt
The first is a summary, the second is the full docs. Works with Claude, ChatGPT, Gemini, and anything else with web access.
Authentication
All endpoints require an API key passed in the x-api-key header.
Rate limits
| Limit | Value |
|---|
| Requests per minute | 120 |
| Credits | Check your API settings |
Each request costs 1 credit. Exceeding either limit returns a 429 response.
Your quota resets at the start of each billing period — the resets_at field in
a 429 response tells you exactly when.
Paginated endpoints use cursor-based pagination. When more results are available, the response includes a next_cursor value. Pass it as the cursor query parameter to fetch the next page.
GET /v1/creatives?cursor=<next_cursor>
Cursors are tied to the order_by value used when they were generated. Do not
reuse a cursor after changing sort order.
Errors
All errors return a consistent JSON shape:
{ "error": "Human-readable message" }
| Status | Meaning |
|---|
401 | Missing or invalid API key |
404 | Resource not found |
429 | Rate limit or monthly quota exceeded |
500 | Internal server error |