Facebook Ad Library Scraper: Competitor Ads

How to use it: 3 steps

1. Make a free Apify accountApify is the cloud platform where our tools run. The free plan gives you $5 of usage every month, no credit card needed. You pay Apify, not us.
2. Paste your input and press StartNo code needed: you fill in a form (the input). It already has a working example. For example: apify in Search terms, domains or Ad Library links. Each start is one run.
3. Download the resultsWhen the run ends, the results are in a table (the dataset). Open Output, press Export and pick Excel or CSV. JSON and the API are there too.

This tool is an Apify Actor: a small program that runs on Apify. You can also run it on a schedule, for example every Monday. New to it? Read how it works, step by step and the 8 words you need first.

What it does

Facebook Ad Library Scraper collects ads from the public Meta Ad Library. Add keywords, website domains, advertiser pages or ad IDs, pick one or more countries, and get one row per ad: text, creative links, landing page with UTM tags, start date, days running, a 0–100 winner score, variant count and, for EU and political ads, reach and spend ranges.

• Who: page name, page ID, page link, likes and categories.
• What: ad text, headline, call-to-action, format (IMAGE, VIDEO, CAROUSEL, DCO, DPA…), image and video links, detected language.
• Where it leads: landing link without the Facebook redirect, landingDomain, and utmSource, utmMedium, utmCampaign, utmContent, utmTerm.
• How long and how strong: startDate, endDate, daysRunning, variantCount (how many versions Facebook groups together) and winnerScore (0–100).
• Political and EU data: spend and impression ranges, "Paid for by" text, and with Add EU reach, demographics and payer details on: EU and UK reach, age, gender, locations, payer and beneficiary.
• Change tracking: changeStatus new or seen and a list of ads that stopped since the last run.

Who uses it

Price

Pay per event: you pay for each result the tool saves, plus a small start fee for each run. The price includes Apify platform costs. Apify bills you, not us. Prices below are for the Apify free plan.

Examples

• One result: about $0.0017.
• 1,000 results: about $0.70.
• Every day 100 results, for 30 days: about $2.13 a month.

Free to try: the Apify free plan gives you $5 of usage every month, no credit card needed. That is enough for about 7,100 results.

Prices checked on 8 November 2026. See the current price on Apify.

Questions

Details

For developers

Sample result

One result from a real test run, in JSON. Real values change from run to run. In Excel or CSV each field is a column.

{
  "adArchiveId": "1550534860016399",
  "pageName": "Perfect themes",
  "isActive": true,
  "startDate": "2026-05-19",
  "daysRunning": 166,
  "platforms": ["facebook", "instagram", "audience_network", "messenger", "threads"],
  "variantCount": 1,
  "winnerScore": 75,
  "ctaText": "Install now",
  "landingDomain": "play.google.com",
  "language": "eng",
  "detailsStatus": "ok",
  "euTotalReach": 53398,
  "endDate": null
}

Use it from code

Actor ID: cliqtomedia/facebook-ad-library. You need your Apify API token from Apify Console → Settings → API & Integrations.

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("cliqtomedia/facebook-ad-library").call(run_input={
    "searchTerms": [
        "apify"
    ],
    "countries": [
        "US"
    ]
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

curl -X POST "https://api.apify.com/v2/acts/cliqtomedia~facebook-ad-library/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["apify"], "countries": ["US"]}'

# pip install langchain-apify
# set APIFY_TOKEN in your environment
from langchain_apify import ApifyActorsTool

tool = ApifyActorsTool("cliqtomedia/facebook-ad-library")
result = tool.invoke({"run_input": {"searchTerms": ["apify"], "countries": ["US"]}})
print(result)

The cURL call waits for the results, up to 300 seconds. For longer runs, start a run (/runs) and get the results with a webhook or by checking the run. Apify API docs. LlamaIndex, MCP for AI agents and the JavaScript client: AI agents & MCP.

Use cases with this tool

Each guide shows all the steps and the other tools.

Similar tools

More in Search, SEO & ads.

Search & SEOLive on Apify

Google Ads Transparency Scraper - Ad Text, No Login

See which ads a brand runs on Google.

Social mediaLive on Apify

Threads Scraper — Posts, Profiles, Replies & Search

Get public Threads posts without login.

Search & SEOLive on Apify

Google Autocomplete Scraper: Keyword Suggestions

Get the phrases Google suggests when people start typing.

Search & SEOLive on Apify

Website JSON-LD Structured Data Scraper

Read JSON-LD structured data from a list of web pages.

Search & SEOLive on Apify

XML Sitemap URLs Extractor: Indexes & Gzip

Turn a sitemap into a clean list of page URLs.

Search & SEOLive on Apify

Website Metadata & Open Graph Scraper: Meta Tags & Canonical

Get the title, description, canonical and social tags of up to 100 pages.