Skip to main content
GET
Get creative

Authorizations

x-api-key
string
header
required

Your Adspo API key.

Path Parameters

creative_id
string
required

The creative ID.

Query Parameters

include_ads
boolean
default:false

Include the individual ads running this creative.

Response

The creative.

creative_id
string

Unique identifier for this creative.

brand_id
string

Facebook Ad Library page ID of the brand running this creative.

brand_name
string | null

Display name of the brand. null only when the brand record is missing.

format
enum<string>

Whether the creative uses a static image or video.

Available options:
IMAGE,
VIDEO
hd_url
string

High-resolution media URL. For videos the HD stream, for images the original.

sd_url
string

Lower-resolution media URL. For videos the SD stream, for images the resized version.

is_active
boolean

Whether the creative is currently running as an active ad.

start_date
string<date-time>

Date the creative was first observed in the Ad Library.

end_date
string<date-time> | null

Date the creative was last observed. null if the creative is still active.

runtime_days
integer

Number of days between first_seen and last_seen (or today if still active).

ad_count
integer

Number of individual ad variants using this creative.

landing_pages
string[]

Destination URLs this creative links to.

countries
string[]

Country codes where this creative has been shown.

languages
string[]

Languages this creative has been served in.

impression_order
integer | null

Estimated impression rank among active ads for this brand (lower = more impressions).

variants
object[]

Alternate copies of this creative.

hook
string | null

Opening line of the video transcript. null if unavailable or not a video creative.

visual_formats
string[]

Visual styles detected in this creative, such as "Customer Testimonial", "Demo", "High Production" or "Model / Try-on". Empty when the creative has not been classified.

ads
object[]

Individual ad variants for this creative. Only present when include_ads=true.