Facebook Ad Library Scraper

Extract ads from Meta's public Ad Library: ad copy, titles, call-to-action text, destination links, image and video URLs, carousel cards, and advertiser details. Search by keyword and country, then export the results as JSON, CSV, or Excel.

What you can do with it

• Monitor the ads competitors are currently running
• Collect ad copy and creative ideas for a niche
• Track which advertisers are active for a keyword
• Feed ad data into spreadsheets, dashboards, or automation tools

Input

Field	Type	Default	Description
searchTerm	string	–	Keyword or advertiser name to search for (required)
country	string	US	Two-letter country code, for example US, GB, DE
maxResults	integer	50	Maximum number of ads to save
proxyConfiguration	object	Apify Residential	Residential proxies are recommended

Example input:

{
  "searchTerm": "running shoes",
  "country": "US",
  "maxResults": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Output

Each ad is saved as one dataset item:

{
  "ad_archive_id": "1234567890",
  "ad_library_url": "https://www.facebook.com/ads/library/?id=1234567890",
  "page_id": "987654321",
  "page_name": "Example Brand",
  "start_date": "2026-09-01T00:00:00+00:00",
  "end_date": null,
  "publisher_platforms": ["FACEBOOK", "INSTAGRAM"],
  "title": "Lightweight Running Shoes",
  "body_text": "Built for everyday comfort.",
  "cta_text": "Shop now",
  "destination_link": "https://example.com/shoes",
  "is_catalog_ad": false,
  "original_image_url": "https://...",
  "video_hd_url": null,
  "cards_carousel": []
}

Data can be downloaded as JSON, CSV, Excel, XML, or HTML from the dataset, or fetched through the Apify API.

Notes and limitations

• Catalog (dynamic product) ads store template text such as {{product.name}} in Meta's data. The Actor replaces it with the real card text when available. When Meta does not expose it, the field is null, and is_catalog_ad is true.
• Keyword search matches ads whose content mentions the keyword, so results can include advertisers other than the brand you searched for.
• Image and video URLs are temporary links hosted by Meta and expire after some time. Download any media you need to keep.
• Meta can change its website at any time, which may affect results.
• This Actor collects publicly visible Ad Library data. Make sure your use complies with applicable laws and with Meta's terms.

1. Enter a search term and country.
2. Set a small maxResults for the first run.
3. Click Start, then open the Output tab to view or export the ads.

• Residential proxies may require a paid Apify plan. If you are on the free plan and a run fails to load ads, try again with a paid plan or contact the developer.
• For best results use 4096 MB of memory.

Run it

Recommended memory: 4096 MB.