Facebook Ad Library Search Companies API
Find Meta Ad Library pages by brand — name-matched, pageId for company-ads (not profileId).
Search Meta Ad Library advertisers/pages by brand name. Results are relevance-filtered so query tokens must appear in the page name — off-brand pages that merely appeared near the keyword (e.g. Sukeban for q=nike) are dropped; empty beats spam. Each company returns id = pageId = advertiserId (pass to /facebook/company-ads), profileId when the facebook.com/{digits}/ URL uses a different numeric identity, vanity or numeric url, logo, and libraryUrl (ready view_all_page_id link). Chain: search-companies → companies[0].pageId → company-ads?url=. Flat 2 credits.
Docs: https://captapi.com/apis/facebook-ad-library-search-companies
Request
- Base URL: https://api.captapi.com
- URL: https://api.captapi.com/v1/ad-library/facebook/search-companies
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Query parameters
Company or brand name to search for (min 2 characters). Name-matched — off-brand pages are dropped.
Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.
Max items to return (default 20, max 200). Flat 2 credits per call.
Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Response
Success. The data object for this endpoint.
Changes
No recorded changes to this operation across all 3 revisions of this API.