Find advertisers by name
Look up advertisers by brand or page name. Returns the page id, ad count, page categories, follower count and Ad Library link for each match — use it to get the page id that an advertiser lookup needs.
/search-advertisers Advertisers https://api.fetchlayer.dev/facebook-ad-library/search-advertisers Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
query string required Advertiser or brand name to look up.
country string optional Two-letter country code, or ALL. (default: ALL)
adType string optional ALL or POLITICAL_AND_ISSUE_ADS. (default: ALL)
limit number optional Maximum advertisers returned (max 500), or -1 for everything available. (default: 30)
Response Fields
search-advertisers
Find advertisers by name
advertisers object[] Matching advertiser pages.
advertisers[].pageId string Page id — the handle for advertiser-ads and advertiser-profile.
advertisers[].pageName string Public page name.
advertisers[].adCount number How many ads the page is running.
advertisers[].pageCategories string[] Categories the page lists itself under.
advertisers[].pageLikeCount number Follower count on the page.
advertiserCount number Number of advertisers in this response.
derivedFromAds boolean Whether the matches were derived from ad results rather than a direct page search.
Request
curl -X POST "https://api.fetchlayer.dev/facebook-ad-library/search-advertisers" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"query":"Acme Software","country":"US","limit":10}'Response
{
"advertiserCount": 2,
"advertisers": [
{
"pageId": "987654321",
"pageName": "Acme Software",
"adCount": 84,
"pageLikeCount": 120400
}
]
}