Curator API: Get Ads
GET https://api.curator.io/v1.2/ads returns every ad in your Curator account as JSON. Ads are your own posts that appear at set positions in a feed. The request needs your API key, and your plan must include API access. Only HTTPS is supported.
Authentication
Send your Curator API key (find it in the Curator Dashboard) in one of three ways: as a query string (?api_key=API_KEY), as a Basic auth header with the API key as the username, or as a Bearer token (Authorization: Bearer API_KEY). The key decides which account you are working in; you only see that account's ads.
Example request
curl "https://api.curator.io/v1.2/ads?api_key=API_KEY"Response
A 200 response is a JSON array of ad objects for all your feeds, active and paused, with no wrapper, no paging, and no filters. There is no endpoint for a single ad, so use this list.
[
{
"id": "gzjv2d13",
"feed_id": "FEED_ID",
"network_id": 0,
"status": "paused",
"name": "Summer sale",
"title": "",
"text": "hello",
"image": "",
"video": "",
"is_html": false,
"click_action": "nothing",
"position_start": 3,
"position_repeats": false,
"position_repeat_interval": 5,
"image_width": 5,
"image_height": 5,
"url": "",
"created_at": "2026-11-20T03:09:40.000000Z",
"slug": "gzjv2d13",
"network_name": "unknown"
}
]Ad object
Field | Description |
|---|---|
| The ad's ID, a short code such as |
| API ID of the feed the ad appears in, or |
|
|
| The ad's internal name. |
| The ad's title and text, and whether the text is HTML. |
| Image and video URLs, or empty. |
| Image size in pixels. |
|
|
| The position in the feed where the ad first appears. |
| Whether the ad repeats, and how many posts apart. |
| The network the ad is styled as, or |
| When the ad was created, in UTC. |
Errors
Status | When | Body |
|---|---|---|
401 | The API key is missing or not valid. |
|
403 | Your plan does not include API access. |
|
429 | When rate limiting is enabled, more than 60 requests per minute. |
|