Skip to main content
GET
Search Global Ad Library

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string | null
Required string length: 1 - 200
provider
string | null
Required string length: 1 - 80
platform
string | null
Required string length: 1 - 200
sort
string | null
Required string length: 1 - 40
recommendation_industry
string | null
Required string length: 1 - 120
advertiser
string | null
Required string length: 1 - 255
advertiser_id
string<uuid> | null
advertiser_ids
string | null
Required string length: 1 - 2400
advertiser_domain
string | null
Required string length: 1 - 255
landing_domain
string | null
Required string length: 1 - 255
country
string | null
Required string length: 2 - 1000
language
string | null
Required string length: 2 - 1000
status
string | null
Required string length: 1 - 200
creative_type
string | null
Required string length: 1 - 200
video_length
string | null
Required string length: 1 - 200
industry
string | null
Required string length: 1 - 1000
brand_industry
string | null
Required string length: 1 - 1000
business_model
string | null
Required string length: 1 - 400
theme
string | null
Required string length: 1 - 600
activity
string | null
Required string length: 1 - 200
seen_since
string<date-time> | null
seen_until
string<date-time> | null
semantic
string | null
Required string length: 1 - 400
similar_to_ad_id
string<uuid> | null
per_advertiser_limit
integer | null
Required range: 1 <= x <= 100
limit
integer
default:24
Required range: x >= 1
offset
integer
default:0
Required range: x >= 0
cursor
string | null
Required string length: 1 - 512

Response

Successful Response

limit
integer
required
offset
integer
required
total
integer
required
returned
integer
required
has_more
boolean
required
results
AdLibrarySearchAd · object[]
required
query
string | null
filters
Filters · object
unsupported_filters
Unsupported Filters · object
result_cap
integer | null
next_cursor
string | null