Social Fetch
Get API key
Facebook hub

Facebook Ad Library Company Search API

Turn a brand name into Facebook page ids for Ad Library company ads — same envelope as the rest of the Facebook tag.

GET /v1/facebook/ad-library/companies/search

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Meta's Ad Library is easy to browse when you already know which Page to open. Discovery is the bottleneck: the same brand can match several Pages, legal entities, or regional aliases, and retyping names into the public UI does not scale for scheduled competitor monitoring.

`GET /v1/facebook/ad-library/companies/search` takes a required `query` string (the company or advertiser name you would type into Ad Library search) and returns matching companies in the shared Social Fetch envelope. Each row under `data.companies` includes `pageId`, `name`, and optional fields such as `category`, `likes`, `verification`, `country`, `entityType`, `pageAlias`, `pageDeleted`, `imageUrl`, and linked Instagram details when Meta reports them. `data.query` echoes the search; `data.totalCompanies` is the count in this response. Bill from `meta.creditsCharged`.

This route is advertiser discovery, not a creative dump. Once you have a `pageId`, use `GET /v1/facebook/ad-library/companies/ads` for that Page's ads. For keyword sweeps across creatives, use `GET /v1/facebook/ad-library/ads/search`. For one known archive id or Ad Library URL, use `GET /v1/facebook/ad-library/ads`. All of them share one Social Fetch API key.

Facebook Ad Library Company Search API FAQ

What does Facebook Ad Library company search return?

Matching companies under data.companies (pageId, name, and optional category, likes, verification, country, entityType, pageAlias, pageDeleted, imageUrl, and linked Instagram fields), the echoed query under data.query, and data.totalCompanies for how many company rows came back. Each response uses the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I search Facebook Ad Library companies by name?

Send GET /v1/facebook/ad-library/companies/search with x-api-key and a required query parameter. That is the only query param for this route. Full request and response shapes are in the API docs.

How much does Facebook Ad Library company search cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

How is company search different from listing company ads?

Company search finds Facebook Ad Library Pages and advertisers by name. GET /v1/facebook/ad-library/companies/ads lists ads for a known pageId (or companyName on that route). Use search first when you only have a brand string; use company ads when you already have a page id.

What is pageId used for?

pageId is the Facebook Page identifier for that company result. Pass it to GET /v1/facebook/ad-library/companies/ads when you want that Page's Ad Library ads instead of guessing a name.

Is this the same as Facebook Ad Library keyword ads search?

No. GET /v1/facebook/ad-library/companies/search finds companies and Pages by name. GET /v1/facebook/ad-library/ads/search finds ads by keyword and filters (country, status, media type, dates). Use company search when you need page ids; use ads search when you are sweeping creatives by keyword.

Do I need a Meta ads account or Marketing API token to search companies?

No. You authenticate to Social Fetch with an API key. The route reads public Ad Library company search results; it does not act on behalf of an ads account you manage.

Other Facebook endpoints