LurkAPI
Get free API key
Docs · Facebook API

Facebook API

Ads running on Facebook and Instagram, from Meta's Ad Library: copy, creative, landing page, dates and platforms.

Try it liveView as markdown

Overview

Search Meta's public Ad Library by keyword or advertiser, and pull full detail for any ad. Great for competitor research, swipe files and creative trend tracking.

Source: facebook.com/ads/library.

Try it live

Pick an endpoint and run it: real data, no signup, 5 free requests a day.

Endpoint

GET/v1/facebook/adLibrary/search/ads

1 credit per request
Examples
query

Keywords to search ad text for, e.g. running shoes.

country

Where the ad ran: a 2-letter ISO country code (US, GB, DE…) or ALL. One country per request.

status

Only ads that are running now (active), only stopped ads (inactive), or both (all).

More options (9)
search_type

keyword_unordered matches all words in any order; keyword_exact_phrase matches the phrase as typed.

media_type

Creative format. meme is Facebook's name for image + text; none means text-only.

ad_type

Ad category. Political ads also carry spend and impressions ranges.

language

Language of the ad text as an ISO 639-1 code, e.g. en or es.

sort_by

total_impressions: most-seen ads first. relevancy_monthly_grouped: most recent first.

start_date

Only ads shown on or after this date (YYYY-MM-DD). The ad itself may have launched earlier.

end_date

Only ads shown on or before this date (YYYY-MM-DD).

cursor

The cursor from the previous response, to get the next page. Keep every other param the same.

trim

true drops image and video URLs (inside snapshot.cards too) for a much smaller response. All text is kept.

5 free tries a day, no signup

Press Run to fetch live data

Results come back as a table you can download as CSV, or as the raw JSON.

Endpoints

Search Ad Library adsGET /v1/facebook/adLibrary/search/ads · 1 creditFind ads in Meta's Ad Library by keyword, with their copy, media, landing page and run dates.
Ad Library ads by companyGET /v1/facebook/adLibrary/company/ads · 1 creditEvery ad one advertiser is running (or ran) on Facebook and Instagram, from Meta's Ad Library.
Ad Library ad detailsGET /v1/facebook/adLibrary/ad · 1 creditFull detail for one ad from Meta's Ad Library, by its id or URL.
Search Ad Library companiesGET /v1/facebook/adLibrary/search/companies · 1 creditFind an advertiser's Facebook page id by name in Meta's Ad Library, with followers and linked Instagram.
Public profileGET /v1/facebook/profile · 1 creditA Facebook Page's or public person's name, pictures, verification and follower counts.
Public postGET /v1/facebook/post · 1 creditA public post's text, author, engagement counts and attached media.

Call it

Every endpoint is a GET with your key in the x-api-key header. For example, Search Ad Library ads:

curl
curl "https://api.lurkapi.com/v1/facebook/adLibrary/search/ads?query=running+shoes&country=US&status=active" \
  -H "x-api-key: YOUR_API_KEY"

Use it in Claude

Once LurkAPI is connected to Claude, each endpoint is a tool Claude can call:

ToolWhat it does
facebook_search_adsSearch Ad Library ads: Find ads in Meta's Ad Library by keyword, with their copy, media, landing page and run dates.
facebook_company_adsAd Library ads by company: Every ad one advertiser is running (or ran) on Facebook and Instagram, from Meta's Ad Library.
facebook_adAd Library ad details: Full detail for one ad from Meta's Ad Library, by its id or URL.
facebook_search_companiesSearch Ad Library companies: Find an advertiser's Facebook page id by name in Meta's Ad Library, with followers and linked Instagram.
facebook_profilePublic profile: A Facebook Page's or public person's name, pictures, verification and follower counts.
facebook_postPublic post: A public post's text, author, engagement counts and attached media.