Skip to main content
GET
Get creatives

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[]