Skip to main content
GET
/
v1
/
creatives
Get creatives
curl --request GET \
  --url https://api.adspo.co/v1/creatives \
  --header 'x-api-key: <api-key>'
{
  "count": 1,
  "next_cursor": null,
  "creatives": [
    {
      "creative_id": "f930d886d0fb9e86b9dd6c1200dab7ef",
      "brand_id": "857986847394146",
      "brand_name": "DRMTLGY",
      "format": "IMAGE",
      "hd_url": "https://r2.adspo.co/creatives/images/original/f930d886d0fb9e86b9dd6c1200dab7ef.jpg",
      "sd_url": "https://r2.adspo.co/creatives/images/resized/f930d886d0fb9e86b9dd6c1200dab7ef.jpg",
      "is_active": false,
      "start_date": "2026-03-16T07:00:00Z",
      "end_date": "2026-04-24T07:00:00Z",
      "runtime_days": 39,
      "ad_count": 10,
      "landing_pages": [
        "https://www.example.com"
      ],
      "countries": [
        "AU",
        "GB",
        "NZ",
        "US"
      ],
      "languages": [
        "en"
      ],
      "impression_order": 11,
      "variants": []
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Your Adspo API key.

Query Parameters

​
order_by
enum<string>
default:latest

Sort order for results.

Available options:
latest,
oldest,
longest_running,
most_ads
​
cursor
string

Pagination cursor from a previous response.

​
category
enum<string>

Filter by brand category.

Available options:
Fashion & Apparel,
Beauty & Cosmetics,
Self Care & Hygiene,
Health & Wellness,
Home & Living,
Software & Tech,
Food & Beverages,
Pet Supplies,
Active & Sports,
Outdoors & Travel,
Jewelry & Accessories,
Games & Hobbies,
Other
​
start_date
string

Filter creatives first seen on or after this date. Accepted formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, YYYY-MM-DDTHH:MM:SS. A bare date (e.g. 2024-11-12) is interpreted as 2024-11-12 00:00:00.

​
end_date
string

Filter creatives last seen on or before this date. Accepted formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, YYYY-MM-DDTHH:MM:SS. To capture all creatives through a full day, use YYYY-MM-DD 23:59:59.

​
is_active
boolean

Filter by whether the creative is currently running.

​
format
enum<string>

Filter by creative format.

Available options:
IMAGE,
VIDEO
​
runtime_min
integer

Minimum runtime in days.

​
runtime_max
integer

Maximum runtime in days.

​
ad_count_min
integer

Minimum number of ad variants using this creative.

​
ad_count_max
integer

Maximum number of ad variants using this creative.

​
impression_order_min
integer

Minimum impression order rank. Lower values indicate higher estimated impressions.

​
impression_order_max
integer

Maximum impression order rank.

​
country
string

Comma-separated or repeated. Matches creatives shown in any of these countries.

​
language
string

Comma-separated or repeated. Matches creatives in any of these languages.

​
include_ads
boolean
default:false

Returns an ads array containing all Meta ads running the creative, including details such as title, body_text, link_text, etc.

Response

A page of creatives.

​
brand_id
string | null

Facebook Ad Library page ID. Only present on brand creatives responses.

​
count
integer

Number of creatives returned in this page.

​
next_cursor
string | null

Pass this value as cursor to retrieve the next page. null when there are no more results.

​
creatives
object[]