Meta Ads API: Search Meta advertisers

Searches the Meta Ad Library for advertiser pages matching required q. Returns page IDs and verification details to use with the page endpoints. Optional country and ad_type narrow results; raw returns the unprocessed payload.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

q*string

Brand, company, or advertiser page search query.

Length1 <= length

country?string

ISO 3166-1 alpha-2 country code. Examples: IN, US, GB, DE.

Length2 <= length <= 2

ad_type?string

Ad category. ALL includes all ad types; other values narrow results to the selected category.

Value in

"ALL"
"POLITICAL_AND_ISSUE_ADS"
"HOUSING_ADS"
"EMPLOYMENT_ADS"
"CREDIT_ADS"

raw?boolean

Set to true to return the unprocessed Ad Library payload instead of the normalized response.

curl -X GET "https://example.com/v1/meta/search-pages?q=flipkart" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {}}