📢 Meta Ad Library Scraper: Competitor Ads, No Login

Overview

Meta Ad Library Scraper pulls every active or inactive ad Meta has for any keyword or advertiser Page ID from the Facebook and Instagram Ad Library. Feed it lab grown diamonds or a competitor's Page ID and get back ad copy, image and video creative URLs, CTAs, landing pages, run dates, ad status, and target platforms. No login, no Facebook Developer token, no rate-limit maze.

It's the fastest way to run competitor creative teardowns, download creative in bulk for a swipe file, or build a paid-media intel pipeline that watches every ad your competitors publish.

✅ No login required | ✅ No API key | ✅ Media URLs included | ✅ MCP-ready for AI agents

Features

Keyword or Page ID search. Search broadly by term or precisely by advertiser Page. Full creative payload. Ad copy, image and video URLs, CTAs, landing page. Active or historic. Choose active-only, inactive-only, or the full history. Media type filter. Image, video, meme, or all creative types. Country scoped. Any two-letter country code (US, IN, GB, AE, etc.).

How it works

The actor talks to the same Meta Ad Library search endpoint the ad-library.facebook.com front-end uses. Each search term you supply is queried independently, and Page IDs (when supplied) take priority as a precise per-advertiser filter. Results are paginated within your maxAdsPerSearch budget and flattened to one row per ad.

Every ad record includes the original image or video URLs so you can download creative for a swipe file or side-by-side comparison. Political and issue ads carry extra spend and impression data, exposed as separate fields on the record.

🧾 Input configuration

{
  "searchTerms": ["lab grown diamonds"],
  "pageIds": [],
  "country": "US",
  "adActiveStatus": "active",
  "adType": "all",
  "mediaType": "all",
  "maxAdsPerSearch": 100
}

📤 Output format

{
  "ad_archive_id": "1234567890",
  "page_id": "9876543210",
  "page_name": "Brilliant Earth",
  "page_url": "https://www.facebook.com/9876543210",
  "is_active": true,
  "start_date": "2026-06-01",
  "end_date": null,
  "publisher_platforms": ["facebook", "instagram"],
  "ad_body_text": "Ethically sourced lab-grown diamonds. Free shipping.",
  "cta_text": "Shop Now",
  "landing_url": "https://www.brilliantearth.com/...",
  "media_type": "video",
  "video_urls": ["https://scontent.xx.fbcdn.net/..."],
  "image_urls": []
}

Every ad record contains these fields:

Field	Description
🆔 ad_archive_id	Meta Ad Library archive ID
🏢 page_id	Facebook Page ID of the advertiser
🏷️ page_name	Name of the Facebook Page running the ad
🔗 page_url	URL of the advertiser's Facebook Page
✅ is_active	Whether the ad is currently active
📅 start_date	ISO date the ad started running
📅 end_date	ISO date the ad stopped, or null if still active
📱 publisher_platforms	Array of platforms (facebook, instagram, messenger, etc.)
✍️ ad_body_text	Primary text copy of the ad
🎯 cta_text	Call to action label (Shop Now, Learn More, etc.)
🌐 landing_url	Landing page the ad links to
🎞️ media_type	image, video, or carousel
🎥 video_urls	Array of video creative URLs
🖼️ image_urls	Array of image creative URLs

💼 Common use cases

Competitor creative teardown Pull every active ad for a competitor and cluster the hooks, CTAs, and offers. Track how their creative rotates across weeks and platforms.

Category & keyword scanning Search a category term (meal kit, sunglasses, lab grown diamonds) and see who is advertising and how. Discover new brands entering a category before they show up in Google Ads auction insights.

Political & issue ad monitoring Pull political ads with spend and impression data for coverage or research. Track messaging changes over a campaign period.

Ad creative library / swipe file Download creative in bulk to build an internal swipe file for your studio or client. Feed image and video URLs into an LLM for auto-tagging or theme analysis.

🚀 Getting started

1. Open the actor and add search terms, or paste one or more advertiser Page IDs for precise tracking.
2. Set the two-letter country (US, IN, GB, AE).
3. Choose ad status (active only, inactive only, or all) and media type.
4. Set maxAdsPerSearch to control cost.
5. Click Start. Records stream to the dataset as pages of results parse.

FAQ

Do I need a Facebook Developer account? No. The actor talks to the public Ad Library web endpoint and needs no API key, no app ID, and no OAuth flow.

How do I find an advertiser's Page ID? Open any ad for the advertiser inside the Ad Library. The Page ID appears in the ad detail view and in the URL. Once you have it, use pageIds for the most precise, deduplicated results.

How much does it cost? Pay per ad returned, pay as you go. No subscription, no monthly minimum.

Can I use it in an AI agent? Yes. It's exposed as an MCP tool. See below.

Use in Claude, ChatGPT & any MCP agent

https://mcp.apify.com/?tools=themineworks/meta-ad-library-scraper

Or call it programmatically with the Apify client:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('themineworks/meta-ad-library-scraper').call({
  searchTerms: ['lab grown diamonds'],
  country: 'US',
  adActiveStatus: 'active',
  maxAdsPerSearch: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

🛠️ Complete your paid-media intel pipeline

Got the ads. Now build the wider picture:

• Google Trends Scraper: track category demand for the same keyword over time.
• Trustpilot Reviews Scraper: check what customers actually think of the advertisers.
• LinkedIn Company Scraper: profile the advertiser with size, industry, HQ, and website.

Typical flow: meta-ad-library reveals the creative and offer, google-trends shows demand, trustpilot-reviews shows reality on the ground.

Questions or need a custom field set? Reach out through the Apify profile.