Skip to main content
GET
Get ads run by a specific Meta advertiser

Authorizations

X-API-Key
string
header
required

API key passed as the X-API-Key request header. Recommended for server-to-server calls.

Path Parameters

advertiserId
string
required
Minimum string length: 1
Example:

"104110961134374"

Query Parameters

status
enum<string>
Available options:
active,
inactive,
all
country
string
Example:

"US"

startDate
string
Example:

"2026-01-01"

endDate
string
Example:

"2026-06-01"

cursor
string

Response

Get ads run by a specific Meta advertiser

ads
object[]
required
nextCursor
string | null
required

Opaque pagination cursor — pass as ?cursor= for the next page; null on the last page

hasMore
boolean
required