APIs / Facebook Ad Library / Search
Facebook Ad Library: Search
Search from Facebook Ad Library as JSON. 1 credit per successful call.
GET /v1/facebook-ad-library/searchNeeds terms
Note
This endpoint needs the restricted-endpoint terms, which you can accept in your dashboard.
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
query | string | Optional | Up to 500 characters |
page_id | string | Optional | Up to 30 characters |
country | string | Optional | Up to 2 characters |
ad_type | string | Optional | ALL, POLITICAL_AND_ISSUE_ADS, CREDIT_ADS, FINANCIAL_PRODUCTS_AND_SERVICES_ADS, EMPLOYMENT_ADS, HOUSING_ADS, UNCATEGORIZED_ADS |
media_type | string | Optional | ALL, IMAGE, MEME, IMAGE_AND_MEME, VIDEO, NONE |
active_status | string | Optional | ALL, ACTIVE, INACTIVE |
publisher_platforms[] | list of string | Optional | facebook, instagram, audience_network, messenger, threads |
start_date | integer | Optional | Any |
cursor | string | Optional | Up to 4,096 characters |
Example request
curl "https://api.perceptlayer.com/v1/facebook-ad-library/search?query=climate&country=US&ad_type=POLITICAL_AND_ISSUE_ADS" \
-H "X-API-Key: $API_KEY"