Skip to main content
GET
Search
This endpoint needs the restricted-endpoint terms, which you accept in your dashboard. Until then it returns 403 restricted_endpoint.
1 credit per successful call; failed calls are free. See the Facebook Ad Library API overview for every Facebook Ad Library endpoint.

Authorizations

X-API-Key
string
header
required

Query Parameters

query
string
Maximum string length: 500
page_id
string
Maximum string length: 30
country
string
Maximum string length: 2
ad_type
enum<string>
Available options:
ALL,
POLITICAL_AND_ISSUE_ADS,
CREDIT_ADS,
FINANCIAL_PRODUCTS_AND_SERVICES_ADS,
EMPLOYMENT_ADS,
HOUSING_ADS,
UNCATEGORIZED_ADS
media_type
enum<string>
Available options:
ALL,
IMAGE,
MEME,
IMAGE_AND_MEME,
VIDEO,
NONE
active_status
enum<string>
Available options:
ALL,
ACTIVE,
INACTIVE
publisher_platforms[]
enum<string>[]
Available options:
facebook,
instagram,
audience_network,
messenger,
threads
start_date
integer
cursor
string
Maximum string length: 4096

Response

Success

The response is of type object.