App Logo
facebook.com

Search the Meta (Facebook) Ad Library

Automatically search the Meta (Facebook) Ad Library on facebook.com. Search Meta's public Ad Library for ads running on Facebook, Instagram, Messenger and Threads, by keyword or by advertiser page, in one country or all. Returns each ad's library id and link, advertiser page, active status, start and end dates, platforms, ad text, headline, landing link, call to action, image and video links, and how many versions it has. No account needed.

Input

limit optional

Maximum ads to return (default 25, about one page). Above that, further pages are loaded; Facebook may rate-limit those from datacenter browsers.

query optional

Keyword or advertiser name to search for. Required unless pageId is given.

adType optional

Default all.

pageId optional

Numeric Facebook page id to list all ads of one advertiser (the pageId returned by this script).

country optional

2-letter ISO country code where the ads ran (e.g. FR, US), or ALL. Default ALL.

mediaType optional

Default all.

exactPhrase optional

Match the query as an exact phrase instead of any of its words.

activeStatus optional

Default active.

Output

ads required
count required
query optional
pageId optional
country optional
hasMore optional
totalApprox optional

Meta's own approximate result count.

activeStatus optional

FAQ

Search Meta's public Ad Library for ads running on Facebook, Instagram, Messenger and Threads, by keyword or by advertiser page, in one country or all. Returns each ad's library id and link, advertiser page, active status, start and end dates, platforms, ad text, headline, landing link, call to action, image and video links, and how many versions it has. No account needed.
Ask an AI agent connected to Reduck to run reduck/facebook.com/ads_library_search, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/facebook.com/ads_library_search
You do not need one. "Search the Meta (Facebook) Ad Library" drives the real facebook.com pages in a browser, so it works whether or not facebook.com offers an API for this.
Optional: limit, query, adType, pageId, country, mediaType, exactPhrase, activeStatus.
It returns ads, count, query, pageId, country, hasMore, totalApprox, activeStatus.
No. It only uses pages of facebook.com that are reachable without signing in.
It only reads. It looks things up on facebook.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/facebook.com/ads_library_search, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/facebook.com/ads_library_search
It is part of Reduck's official curated catalogue.

Related scripts

facebook.com

Get Facebook profile info

Get header and intro info for a Facebook profile or page (pass a URL or a bare id/username). Returns the type (profile or page), the name, friends, likes and follower counts as displayed, mutual friends, and the intro lines — bio plus city, work and education for people, or the description for pages. Counts come back as the strings Facebook shows (e.g. "11 K") and intro lines are returned as they appear, not sorted into city, work or school fields. Works in either the French or the English interface. An id or username Facebook will not serve returns a clear error rather than an empty record.

facebook.com

Join Facebook groups automatically

Join Facebook groups automatically from an agent, one group per call, including private groups with entry questions. Join a Facebook group by id/slug. Returns status (joined / pending / already_member) and name. Pending means a private-group request was sent, not membership.

facebook.com

Find Facebook groups by keyword

Find Facebook groups by keyword with member counts and posting activity, as structured data. Search Facebook groups by keyword. Returns groupId, name, url, privacy, members, postsPerDay. Results are infinite-scroll, capped by limit.

Start building not clicking

Get started for free