Introduction

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

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.

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" }

Status	Meaning
`401`	Missing or invalid API key
`404`	Resource not found
`429`	Rate limit or monthly quota exceeded
`500`	Internal server error

Getting Started

Creatives

Brands

Boards & Spaces

Usage

Introduction

Using with AI

Authentication

Rate limits

Errors

​Using with AI

​Authentication

​Rate limits

​Pagination

​Errors

Using with AI

Authentication

Rate limits

Pagination

Errors