FACEBOOK AD LIBRARY API
Find advertisers, their ads and individual creatives.
Research Meta Ad Library from one clear workflow. Find the correct advertiser Page ID, collect ads from that advertiser, search ads by keyword, inspect a known ad by ID, or retrieve video-ad transcripts.
THE CORRECT AD WORKFLOW
Resolve the advertiser before collecting its ads.
A normal Facebook profile lookup is not an advertiser search. Use Advertiser search to find the Meta Ad Library Page ID, then pass that ID to Company ads.
Advertiser search
Search a brand name and receive matching advertiser Page IDs from Meta Ad Library.
Company ads
Use the chosen Page ID to collect ads from that exact advertiser instead of relying on a name match.
Keyword ad search
Find ad creatives whose copy or associated metadata matches a topic across advertisers.
Ad details and transcripts
Inspect a known ad ID or extract spoken content from a video creative.
ADVERTISER RESULT
The Page ID is the bridge to company ads.
Choose the record whose page name and URL match the advertiser you intend to research.
Example advertiser search result
{
"platform": "facebook",
"page_id": "140858439260130",
"page_name": "Cadbury",
"page_url": "https://www.facebook.com/CadburyUK/",
"profile_picture_url": "https://...",
"page_like_count": 16100000,
"categories": ["Food & beverage company"]
}BRAND NAME TO CREATIVE
Different questions use different Ad Library inputs.
Advertiser search resolves who is advertising; Company ads returns that advertiser's creatives; Ad search finds creatives about a keyword; Ad by ID retrieves one known record.
- 01Search the advertiserEnter a brand such as Cadbury and inspect the returned names, page links and Page IDs.
- 02Choose the correct Page IDSelect the advertiser identity that matches the company you mean.
- 03Collect or inspect adsUse Company ads for the advertiser set, Ad search for a topic, or Ad by ID for one known creative.
AD LIBRARY RESEARCH
Move from a brand name to the exact ads it is running.
Competitor ad monitoringCreative researchOffer and CTA analysisAdvertiser discovery
QUESTIONS
Facebook Ad Library questions.
Why not use the Facebook Page operation to find an advertiser?
A Facebook handle can resolve to a person or similarly named Page. Advertiser search queries Meta Ad Library identities and returns the Page ID required by Company ads.
What is the difference between Company ads and Ad search?
Company ads returns creatives from one Page ID. Ad search finds ads matching a keyword across advertisers.
Why use Ad by ID if the ad appeared in a list?
Use it when an application already stores an ad ID, when you need to refresh one creative, or when a user opens an individual-ad view without retrieving the whole list again.
How is Ad Library data billed?
Advertiser search, Company ads, Ad search and Ad by ID cost three credits per delivered item. Video transcripts use their separate transcript price.