Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.adspo.co/llms.txt

Use this file to discover all available pages before exploring further.

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.
x-api-key: YOUR_API_KEY

Rate limits

LimitValue
Requests per minute120
Credits per month10,000
Each request costs 1 credit. Exceeding either limit returns a 429 response. Monthly quotas reset at the start of each calendar month — the resets_at field in a 429 response tells you exactly when.

Pagination

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" }
StatusMeaning
401Missing or invalid API key
404Resource not found
429Rate limit or monthly quota exceeded
500Internal server error