Skip to main content
GET
Get group creatives
Credits: 1 credit per request, which returns one page of up to 12 creatives. Each page you fetch with cursor is another request.

Authorizations

x-api-key
string
header
required

Your Adspo API key.

Path Parameters

group_id
string<uuid>
required

The group's ID, from Get groups.

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.

q
string

Search inside the creatives for a word or phrase: their ad copy, video transcripts, on-screen text and landing page URLs. Matches the exact phrase. Results keep order_by; they are not ranked by relevance. Works with every other filter.

search_in
enum<string>

Limit q to one kind of text. Leave out to search all of them.

Available options:
copy,
transcript,
on_screen_text,
landing_page
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. Times without an offset are UTC.

end_date
string

Filter creatives first seen on or before this date. With start_date, this is the window the creatives started running in. Accepted formats: YYYY-MM-DD, YYYY-MM-DD HH:MM:SS, YYYY-MM-DDTHH:MM:SS. A bare date (e.g. 2024-11-12) includes the whole day. Times without an offset are UTC. To find creatives that have stopped running, use is_active=false.

is_active
boolean

Filter by whether the creative is currently running.

format
enum<string>

Filter by creative format.

Available options:
IMAGE,
VIDEO
visual_format
enum<string>

Only creatives in this visual style, tagged from the image or video, the same list as the app's Visual format filter. Matched ignoring case. Each creative's visual_formats lists its own.

Available options:
Animation,
Before & After,
Challenge / Experiment,
Cinematic B-Roll,
Customer Testimonial,
Demo,
Employee / BTS,
Expert / Authority,
Explainer,
Flatlay,
Founder Story,
GIF / Static To Video,
High Production,
Illustration,
Interview,
Lifestyle,
Listicle / Tier List,
Low Stock / Back in Stock,
Meme,
Model / Try-on,
Native,
Offer / Discount,
Organic,
POV,
Podcast,
Product Features & Benefits,
Product Shot,
Reaction / Taste Test,
Retail Announcement,
Review / Social Proof,
Screenshot / Mockup,
Skit,
Talking Head,
Text-Heavy,
Unboxing,
Us vs Them,
Yapper
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.

group_id
string<uuid>

The group's ID. Only present on group 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[]