# Facebook Ads Library Scraper: Meta Ad Library Monitor (`themineworks/meta-ad-library-scraper`) Actor Facebook Ads Library scraper for Meta ads on Facebook and Instagram. Paste any Ad Library link or search by keyword or Page ID, filter by start date, and get ad copy, CTAs, landing pages, run dates and image and video URLs. Monitor mode returns only new ads. No login. - **URL**: https://apify.com/themineworks/meta-ad-library-scraper.md - **Developed by:** [The Mine Works](https://apify.com/themineworks) (community) - **Categories:** Lead generation, Social media, MCP servers - **Features:** Limited permissions - **Stats:** 50 total users, 6 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.40 / 1,000 ads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Facebook Ads Library Scraper: Meta Ad Library Monitor **Updated 10 Oct 2026: paste any Ad Library link, filter by start date.** [![60 Meta ads in 26 seconds: a recorded run searched 3 brand names in the US Ad Library and delivered 60 active ads with copy, CTAs and creative links](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/meta-ad-library-scraper-hero.png)](https://console.apify.com/actors/57SKI9Cz02tOmI7Hi/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) From **The Mine Works**, makers of [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 290,000 runs across 310+ public actors. ### Why choose this actor? - **60 ads from 3 brand searches in 26 seconds, with no Facebook login.** A recorded run searched three brand names in the US Ad Library and delivered 60 active ads in 26 seconds at 512 MB. You need no Facebook account, no Meta developer app and no access token. - **The creative itself, not just the copy.** Of 313 ads in our recent runs, 289 came with image links and 203 with video links, next to the ad text, headline, call to action, landing page, start date and the platforms each ad runs on (Facebook, Instagram, Messenger, Threads, WhatsApp, Audience Network). - **You pay only for ads delivered.** $3.40 to $5.80 per 1,000 ads depending on your Apify plan. Searches that come back empty or blocked are never charged: in that same run, the third brand returned nothing and cost nothing. - **Paste the Ad Library link you are already looking at.** Copy the address of any Ad Library search, advertiser page or single ad from your browser into `adLibraryUrls`. The actor keeps the filters in the link and drops tracking tags. In our test on 10 Oct 2026, a pasted advertiser link returned 30 ads and a pasted single ad link returned that one ad. - **Only ads that started in your date window.** Set `startDateMin` and `startDateMax`. In a test on 10 Oct 2026, a keyword search for July to September 2026 kept 9 of the 30 ads on the page and left out the other 21 without charging for them. [![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/57SKI9Cz02tOmI7Hi/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) Bookmark this Actor on its Store page so it is one click away next time. **Part of The Mine Works Marketing, SEO and reviews family:** [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Trustpilot Reviews Scraper](https://apify.com/themineworks/trustpilot-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Google Trends Scraper](https://apify.com/themineworks/google-trends-pro?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Semrush Scraper](https://apify.com/themineworks/semrush-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral). ### Try it in one minute Paste this into the input's JSON tab and start the run. It returns 10 ads currently running in the US for "lab grown diamonds". We run exactly this every day as a health check, and it finishes in about 12 seconds. ```json { "searchTerms": ["lab grown diamonds"], "country": "US", "adActiveStatus": "active", "maxAdsPerSearch": 10 } ``` There are three ways to say what you want. `adLibraryUrls` takes links copied from the Ad Library in your browser: a keyword search, an advertiser's page of ads or a single ad. `searchTerms` takes keywords such as a brand, product or phrase, and matches the ad text of every advertiser, so a brand name also finds creators and resellers who mention it. `pageIds` takes numeric Facebook Page IDs, such as `"162640217636958"` (Clean Origin, a lab grown diamond brand), and returns ads from that one advertiser. You can mix all three in one run; links are searched first, then Page IDs, then keywords. The input form comes prefilled with one keyword and one Page ID, so clear the one you do not need. `country` is a two letter code such as `US`, `GB`, `IN` or `AE`, or `ALL` for every country. Apify's free plan includes $5 of credit every month, which covers about 853 ads at this actor's price (the Free plan rate of $0.0058 per ad, plus the $0.005 start fee on each of 10 runs at the default memory). #### Copy to your AI assistant ``` themineworks/meta-ad-library-scraper on Apify. Searches the public Meta (Facebook and Instagram) Ad Library by pasted Ad Library link, keyword or advertiser Page ID and returns one row per ad: advertiser, ad text, headline, call to action, landing page, start date, platforms, format, image and video URLs and the Ad Library search it came from (search_url), with no login. Call ApifyClient("TOKEN").actor("themineworks/meta-ad-library-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: adLibraryUrls (list of facebook.com/ads/library links copied from a browser; the link's own filters are used), searchTerms (list of keywords) or pageIds (list of numeric Facebook Page IDs). Optional: searchType ("keyword_unordered" default or "keyword_exact_phrase"), country (default "US", or "ALL"), adActiveStatus ("active" default, "inactive", "all"), adType ("all" default or "political_and_issue_ads"), mediaType ("all" default, "image", "video", "meme"), startDateMin and startDateMax ("YYYY-MM-DD"; keep only ads that started in that window, inclusive), publisherPlatforms (list of "facebook", "instagram", "messenger", "audience_network", "threads", "whatsapp"), contentLanguages (list of two letter codes such as "en"), maxAdsPerSearch (default 10; the Ad Library page holds about 30 ads per search, so use more terms or Page IDs for more), proxyConfiguration (default Apify residential), monitorMode (default false; true delivers and charges only ads not delivered by an earlier run with the same input). Ad rows have no _type; each run also writes one row with _type "summary" and, when ads were delivered, one with _type "info"; neither is charged. A bad date ends the run before anything is fetched, with the reason in the summary row under input_error and nothing charged; a link that is not an Ad Library search is skipped and listed in the summary row under invalid_urls. Full spec: GET https://api.apify.com/v2/acts/themineworks~meta-ad-library-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral ``` ### Key features - **Pasted link, keyword or advertiser search.** Paste Ad Library links with `adLibraryUrls`, search ad text across all advertisers with `searchTerms` (any words, or the exact phrase with `searchType`), or pull one advertiser's ads with `pageIds`. Filter by `country`, by active or inactive status, by ad type (all ads, or political and issue ads), by media type (image, video or meme), by platform (`publisherPlatforms`) and by ad language (`contentLanguages`). - **Start date window.** `startDateMin` and `startDateMax` keep only ads that started running between those two dates, both included. Ads outside the window are left out and not charged. - **21 fields per ad.** Archive ID, advertiser Page ID, name and link, active flag, start and end dates, platforms, format, ad text, headline, caption, call to action text and type, landing page, variant count, image URLs, video URLs, Ad Library link, the search the ad came from and capture time. - **About 30 ads per search.** The actor reads the first page of results the Ad Library serves for each link, keyword or Page ID, which held 22 to 30 ads per search in our runs. `maxAdsPerSearch` trims that number; to get more ads, add more links, keywords or Page IDs. - **Links only, never media downloads.** Image and video creative come as Meta CDN URLs. The actor never downloads media, so runs stay small and fast. - **Built in stop switches.** If two searches in a row return no ads, the run stops early instead of working through the rest of your list against a block. A cost guard also ends a run that makes many requests without delivering ads. ### How to use it #### Basic: ads for one keyword ```json { "searchTerms": ["meal kit delivery"], "country": "US", "adActiveStatus": "active", "maxAdsPerSearch": 30 } ``` 30 is about as many as one search returns. Setting `maxAdsPerSearch` higher does not get more ads from the same search. #### Several brands in one run ```json { "searchTerms": ["RYZE Superfoods", "Arrae", "Ironmaid"], "country": "US", "adActiveStatus": "active", "maxAdsPerSearch": 45 } ``` This is the input of our recorded run: 60 ads in 26 seconds. Each keyword is a separate search with its own fresh IP. Keyword search matches ad text, so the "Arrae" search also returned ads from creators who mention the brand. Use `pageIds` when you want one advertiser's own ads only. #### Paste links from the Ad Library ```json { "adLibraryUrls": [ "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=162640217636958", "https://www.facebook.com/ads/library/?id=913692170489722" ], "maxAdsPerSearch": 30 } ``` Run your search on facebook.com/ads/library, set the filters you want, then copy the address bar. In our test on 10 Oct 2026 this input returned 31 ads: 30 from the advertiser link and the one ad from the single ad link. The link's own filters are used as they are. Filters the link leaves out, such as `country`, come from the input fields. Parts of the link that are not search filters, such as `fbclid` or `utm_source`, are dropped and named in the log. A link with no keyword, advertiser or ad id in it is skipped with a message in the log and listed in the summary row under `invalid_urls`. #### Ads that started in a date window ```json { "searchTerms": ["lab grown diamonds"], "country": "US", "adActiveStatus": "all", "startDateMin": "2026-07-01", "startDateMax": "2026-09-30", "maxAdsPerSearch": 30 } ``` In our test on 10 Oct 2026 this kept 9 of the 30 ads on the page, with start dates from 2 Jul to 11 Sep 2026, and charged for those 9 only. Either date can be left out for an open window. Both dates are included. A date that is not written as YYYY-MM-DD stops the run at the start with a message saying which field is wrong, before any search is made, so no ads are charged. #### Exact phrase, one platform, one language ```json { "searchTerms": ["free shipping"], "searchType": "keyword_exact_phrase", "publisherPlatforms": ["threads"], "contentLanguages": ["en"], "maxAdsPerSearch": 5 } ``` These three filters are the Ad Library's own. In our test on 10 Oct 2026 all 5 ads returned ran on Threads. #### Competitor creative teardown, by Page ID ```json { "pageIds": ["107940537227344", "108401623899597"], "country": "US", "adActiveStatus": "all", "maxAdsPerSearch": 30 } ``` To find an advertiser's Page ID, run a keyword search for the brand first: every ad row carries `page_id` and `page_name`. Then track that advertiser by ID. `adActiveStatus: "all"` includes ads that have stopped running, which shows how long the brand kept each creative live. #### Weekly watch on a category ```json { "searchTerms": ["lab grown diamond", "moissanite ring", "engagement ring sale"], "country": "US", "adActiveStatus": "active", "maxAdsPerSearch": 30 } ``` Save this as a task and schedule it weekly (Apify Console, Schedules, Create new). Compare `ad_archive_id` values with last week's export to see which ads are new and which were switched off. Each run delivers and charges every ad it finds again; add `"monitorMode": true` to get only the ads you have not received before (see Run it on a schedule). #### Several markets for the same brand The Ad Library is country scoped, so run the same input once per country (`US`, `GB`, `IN`, `AE` and so on), for example as one saved task per market. An ad running only in Germany will not appear in a US search. #### Political and issue ads ```json { "searchTerms": ["climate"], "country": "US", "adType": "political_and_issue_ads", "adActiveStatus": "all", "maxAdsPerSearch": 30 } ``` This filter limits results to the Ad Library's political and issue category. The rows carry the same fields as any other ad; spend and impression ranges are not extracted. ### Input parameters | Parameter | Type | Default | What it does | |---|---|---|---| | `adLibraryUrls` | array of strings | none | Links copied from facebook.com/ads/library: a keyword search, an advertiser's page of ads (`view_all_page_id=`) or a single ad (`id=`). The link's filters are used as they are; filters it leaves out come from the fields below. Searched first. | | `searchTerms` | array of strings | none (prefilled with `lab grown diamonds`) | Keywords. Each one is a separate Ad Library search that matches ad text across all advertisers. | | `pageIds` | array of strings | none (prefilled with one Page ID) | Numeric Facebook Page IDs. Each one returns that advertiser's ads. Searched before `searchTerms`. | | `searchType` | string | `keyword_unordered` | How `searchTerms` match: `keyword_unordered` (any words, any order) or `keyword_exact_phrase` (the words together, in order). | | `country` | string | `US` | Two letter country code of the Ad Library region, such as `US`, `GB`, `IN`, `AE`, or `ALL` for every country. | | `adActiveStatus` | string | `active` | `active`, `inactive` or `all`. | | `adType` | string | `all` | `all` for every ad, or `political_and_issue_ads`. | | `mediaType` | string | `all` | `all`, `image`, `video` or `meme` (image and meme ads). | | `startDateMin` | string | none | Keep only ads that started on or after this date, `YYYY-MM-DD`. | | `startDateMax` | string | none | Keep only ads that started on or before this date, `YYYY-MM-DD`. | | `publisherPlatforms` | array of strings | none (all) | Only ads shown on these platforms: `facebook`, `instagram`, `messenger`, `audience_network`, `threads`, `whatsapp`. Other values are ignored with a log line. | | `contentLanguages` | array of strings | none (all) | Only ads in these languages, as two letter codes such as `en`, `es`, `de`. | | `maxAdsPerSearch` | integer | `10` | Most ads kept from each link, keyword or Page ID, 1 to 2,000. A search returns about 30, so values above 30 change nothing. Also your cost cap. | | `downloadImages` | boolean | `false` | Kept for older inputs. Has no effect: image URLs are always returned in `image_urls` and no media is downloaded. | | `downloadVideos` | boolean | `false` | Kept for older inputs. Has no effect: video URLs are always returned in `video_urls`. | | `proxyConfiguration` | object | Apify residential | Proxy for the run. Leave it as it is: Meta challenges datacenter IPs, and the actor only fetches small HTML pages. | | `monitorMode` | boolean | `false` | Deliver only ads not delivered by an earlier run with the same input. Skipped ads are not charged. Made for daily or weekly schedules. | If `adLibraryUrls`, `searchTerms` and `pageIds` are all empty, the run writes only a summary row and charges no ads. If `startDateMin` or `startDateMax` is not a real date in `YYYY-MM-DD` form, or `startDateMin` is later than `startDateMax`, the run stops at the start with a message naming the field, before any search is made, so no ads are charged. The same happens when every entry in `adLibraryUrls` is unusable and there are no keywords or Page IDs. ### What data do you get? One row per ad, plus a summary row per run. Ad rows have no `_type` field. **The advertiser:** `page_id`, `page_name`, `page_url` (the Facebook Page link). **The ad:** `ad_archive_id` (Meta's Ad Library ID), `snapshot_url` (the ad's page in the Ad Library), `is_active`, `start_date`, `end_date`, `publisher_platforms` (for example `FACEBOOK`, `INSTAGRAM`, `MESSENGER`, `THREADS`, `WHATSAPP`, `AUDIENCE_NETWORK`), `display_format` (seen in our runs: `VIDEO`, `DCO`, `IMAGE`, `DPA`, `CAROUSEL`), `collation_count` (how many versions Meta groups under this ad). **The creative:** `ad_body` (primary text), `ad_title` (headline), `ad_caption` (usually the display domain), `cta_text` and `cta_type` (for example "Shop now" and `SHOP_NOW`), `link_url` (landing page), `image_urls` and `video_urls` (Meta CDN links; video ads also carry their preview image in `image_urls`). **Where and when:** `search_url`, the Ad Library search page the ad was found on (your pasted link, or the search the actor built from a keyword or Page ID), so rows from several searches in one run can be told apart; `scraped_at`, the ISO time the row was written. A note on dates: Meta gives active ads an end date too, the day you ran the search, so `end_date` on an active ad means "still running as of this date". Dates are midnight US Pacific time, written in UTC (for example `2026-09-24T07:00:00.000Z`). **Summary row** (`_type: "summary"`, never charged): `ads` (delivered), `charged_for`, `charge_failures`, `yield_guard` (with `empty_streak`, `total_empty` and `yield_guard_tripped`, which says whether the run stopped after two empty searches in a row) and `scraped_at`. With a date window set it also has `start_date_filter` (`start_date_min`, `start_date_max` and `left_out_outside_window`, the number of ads left out). When a pasted link could not be used it has `invalid_urls`, one message per link. **Info row** (`_type: "info"`, never charged): written when at least one ad was delivered, with the count and a scheduling tip. #### Stable fields for automations These fields were present in all 313 ad rows of our recent runs, except `search_url`, which was added on 10 Oct 2026 and was in all 80 ad rows of our tests that day. Their names will not change, so a Google Sheet, Zapier zap or n8n flow can map them once. | Field | What it is | |---|---| | `ad_archive_id` | Meta's Ad Library ID, the key to store and compare on | | `page_id` | Advertiser's Facebook Page ID | | `page_name` | Advertiser's Page name | | `page_url` | Advertiser's Facebook Page link | | `is_active` | True while the ad is running | | `start_date` | Date the ad started, ISO 8601 | | `end_date` | Date it stopped, or the search date for a running ad | | `publisher_platforms` | Platforms the ad runs on | | `display_format` | Creative format, such as `VIDEO` or `CAROUSEL` | | `cta_type` | Call to action code, such as `SHOP_NOW` | | `link_url` | Landing page | | `image_urls` | Image links; can be an empty list | | `video_urls` | Video links; can be an empty list | | `snapshot_url` | The ad's page in the Ad Library | | `scraped_at` | When this row was written, ISO 8601 | | `search_url` | The Ad Library search the ad came from | `ad_caption` and `cta_text` were also in every row. `ad_body` was missing from 2 of 313 rows, `ad_title` from 28 and `collation_count` from 120, because Meta had no value for them, so treat those three as optional. Catalog ads (`DCO` and `DPA`) sometimes show Meta's template field names, such as product.name, in `ad_body` and `ad_title` instead of real copy, because that is what the Ad Library itself displays. #### Output examples **A video ad** (recorded run `cghR3RKXCUuOiBJW0`, US, 24 Sep 2026; CDN links trimmed): ```json { "ad_archive_id": "1453706910129969", "page_id": "107940537227344", "page_name": "RYZE Superfoods", "page_url": "https://www.facebook.com/ryzesuperfoods/", "is_active": true, "start_date": "2026-07-13T07:00:00.000Z", "end_date": "2026-09-24T07:00:00.000Z", "publisher_platforms": ["FACEBOOK", "INSTAGRAM"], "display_format": "VIDEO", "ad_body": "RYZE is powered by functional mushrooms and adaptogens. Our creamy and delicious blend features six functional mushrooms, prebiotics, zero added sugar and 100% organic or non-GMO ingredients. ...", "ad_title": "Pour Yourself a Better Cup of Coffee β˜•οΈ", "ad_caption": "shop.ryzesuperfoods.com", "cta_text": "Shop now", "cta_type": "SHOP_NOW", "link_url": "https://shop.ryzesuperfoods.com/fb", "collation_count": 1, "image_urls": ["https://scontent.fcia6-1.fna.fbcdn.net/v/t39.35426-6/742895735_1585698500035948_4695356029445265094_n.jpg?..."], "video_urls": ["https://video.fcia6-1.fna.fbcdn.net/o1/v/t2/f2/m366/AQPzV2NbuIF0KN3MnF577OC5DRBPhvHho4mbDIeVLpVx1gK6MSkAw..."], "snapshot_url": "https://www.facebook.com/ads/library/?id=1453706910129969", "scraped_at": "2026-09-24T08:00:30.480Z" } ``` **A carousel ad found by a keyword search** (recorded run `WLT3r1crfueypC8IS`, India, 24 Sep 2026; text and links trimmed): ```json { "ad_archive_id": "913692170489722", "page_id": "167389649992739", "page_name": "Australian Diamond Brokers", "page_url": "https://www.facebook.com/australiandiamondbrokers/", "is_active": true, "start_date": "2024-03-18T07:00:00.000Z", "end_date": "2026-09-24T07:00:00.000Z", "publisher_platforms": ["FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER"], "display_format": "CAROUSEL", "ad_body": "Huge range Of 300,000+ Natural and Lab Grown Diamonds. ...", "ad_title": "Australian Diamond Brokers", "ad_caption": "australiandiamondbrokers.com", "cta_text": "Book now", "cta_type": "BOOK_TRAVEL", "link_url": "http://www.australiandiamondbrokers.com/", "collation_count": 1, "image_urls": [ "https://scontent.fkov1-1.fna.fbcdn.net/v/t39.35426-6/431505730_1092793451764261_5935955348634153424_n.jpg?...", "https://scontent.fkov1-1.fna.fbcdn.net/v/t39.35426-6/431446828_1445981082948368_627989504511235869_n.jpg?..." ], "video_urls": [ "https://video.fkov1-1.fna.fbcdn.net/o1/v/t2/f2/m412/AQNTFLF9xz00BsErxwSa7CUVbg5xgSRHJ6mQAx0BQuiGwX3LDTgMIbimO14i84s0uLn3Lh0T75jrbURPXxptwAM.mp4?..." ], "snapshot_url": "https://www.facebook.com/ads/library/?id=913692170489722", "scraped_at": "2026-09-24T13:26:16.475Z" } ``` The full row had 4 image links and 5 video links, one per carousel card. **An ad with no headline** (same run): `ad_title` is missing because the ad has none. ```json { "ad_archive_id": "1189548263302663", "page_id": "507817735747837", "page_name": "Starbyjainjewellers", "page_url": "https://www.facebook.com/61570050003630/", "is_active": true, "start_date": "2025-12-23T08:00:00.000Z", "end_date": "2026-09-24T07:00:00.000Z", "publisher_platforms": ["FACEBOOK", "INSTAGRAM"], "display_format": "VIDEO", "ad_body": "People often ask, β€œAre lab-grown diamonds fake?” πŸ’Ž ...", "ad_caption": "instagram.com", "cta_text": "Visit Instagram profile", "cta_type": "VIEW_INSTAGRAM_PROFILE", "link_url": "http://instagram.com/starbyjainjewellers", "collation_count": 1, "image_urls": ["https://scontent.fkov1-1.fna.fbcdn.net/v/t39.35426-6/593712614_2054003398729145_6428826672116963368_n.jpg?..."], "video_urls": ["https://video.fkov1-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQNLNoar94LOKfbW0LfsL5PhtvZLbpDd3VTfAoUvYmIQnX4yiIKbACcm8ggSNo1QBT9M1fzHzgZRBb-lj7AdJJ3Vk9WndV_IlVoaXqY.mp4?..."], "snapshot_url": "https://www.facebook.com/ads/library/?id=1189548263302663", "scraped_at": "2026-09-24T13:26:14.431Z" } ``` **The summary row of the recorded run** (60 ads, all charged; the Ironmaid search returned nothing, which counts as one empty search): ```json { "_type": "summary", "ads": 60, "charged_for": 60, "charge_failures": 0, "yield_guard": { "empty_streak": 1, "total_empty": 1, "yield_guard_tripped": false }, "scraped_at": "2026-09-24T08:00:50.740Z" } ``` **A run where Meta returned nothing** (our health check run `Mi91iOMftzcH2OfYJ`, 23 Sep 2026): no ads, no ad charges, only the start fee. A rerun of the same input a minute later returned 10 ads. ```json { "_type": "summary", "ads": 0, "charged_for": 0, "charge_failures": 0, "yield_guard": { "empty_streak": 1, "total_empty": 1, "yield_guard_tripped": false }, "scraped_at": "2026-09-23T09:03:48.063Z" } ``` ### Pricing Pay per event. You are charged for each ad delivered to your dataset, plus a small start fee per run. The rate falls as your Apify plan rises. | Event | Free | Bronze | Silver | Gold and above | |---|---|---|---|---| | Ad delivered (`ad-scraped`), per ad | $0.0058 | $0.005 | $0.0042 | $0.0034 | | Per 1,000 ads | $5.80 | $5.00 | $4.20 | $3.40 | | Run start (`apify-actor-start`) | $0.005 per GB of run memory, minimum one event | same | same | same | **The start fee, exactly.** Apify's `apify-actor-start` event is charged once when a run starts, one event per GB of memory with a minimum of one. At the default 512 MB, and at 1 GB, that is one event, $0.005 per run. A 4 GB run would pay $0.02. This actor does not need more than 512 MB. **Never charged:** searches that return no ads (blocked, empty or no matches), ads left out by your start date window, links that are not Ad Library searches, the summary row and the info row. An ad is charged only after it is saved to your dataset. **Charged once per search that finds it:** the actor removes repeats within one search, not across searches. An ad that matches two of your keywords is delivered and charged once for each. In a 10 keyword run with overlapping terms ("lab grown diamond" and "lab grown diamonds"), 24 of 219 ads were repeats. Use distinct keywords, or Page IDs, to avoid paying twice. **What real jobs cost on Gold:** the recorded run (60 ads) cost $0.204 plus $0.005. A weekly watch of 3 keywords at about 30 ads each costs about $0.31 a week. Ten competitors by Page ID at up to 30 ads each costs up to $1.02 plus $0.005. There is no price change scheduled for this actor. The Pricing tab on this page always shows the rate for your own plan. ### Run it on a schedule Switch on `monitorMode` and the actor remembers which ads it has delivered for this input. Each later run delivers only ads you have not received before, which are the ads that went live since the last run, and you pay only for those. 1. Fill in the input, tick **Monitor mode**, and save it as a task. 2. In Apify Console open **Schedules**, click **Add schedule**, and pick **Daily** or **Weekly** (or a cron such as `0 8 * * 1`). 3. Add the saved task to the schedule and click **Save**. ```json { "searchTerms": ["lab grown diamond", "moissanite ring"], "country": "US", "adActiveStatus": "active", "maxAdsPerSearch": 30, "monitorMode": true } ``` The first run delivers every ad it finds. Each later run with the same input delivers only ads whose `ad_archive_id` it has not delivered before. Skipped ads are never charged; the start fee applies to every run as usual. The Ad Library page shows about 30 ads per search, so a new ad is caught when it is among them; schedule often enough that new ads do not scroll past. The last row of each run (`_type: "info"`) gives `new_this_run`, `skipped_already_seen` and a scheduling tip. The history belongs to the input: change the links, search terms, Page IDs, country, dates or other filters and a new history starts; change `maxAdsPerSearch` and it carries on. Saving an older task again with the new fields left empty keeps its history. Monitor mode shows new ads, not ads that were switched off; for that, compare two full runs. ### FAQ **What is the Meta Ad Library?** It is Meta's public archive of ads running on Facebook, Instagram, Messenger, Threads, WhatsApp and the Audience Network, which anyone can search at facebook.com/ads/library without logging in. This actor runs the same searches and returns the results as rows. **How many ads can I get?** About 30 per link, keyword or Page ID: the actor reads the first page of results the Ad Library serves for each search (22 to 30 per search in our runs) and does not page further. For more ads, add more links, keywords or Page IDs. A start date window can leave fewer, because ads on that page that started outside the window are left out. Each run also stops early if two searches in a row return nothing. **How fresh is the data?** Live. Each run searches the Ad Library at the moment it runs. `is_active` and `end_date` reflect that day. **Do I need a Facebook account, a Meta developer app or an access token?** No. The actor reads the public Ad Library page. There is no login, no app and no token. **Do I need a proxy?** No setup is needed. The actor uses Apify's residential proxy by default because Meta challenges datacenter IPs. It fetches only small HTML pages, never images or videos. **Why did a search return no ads?** Either nothing matched in that country and status, or Meta refused the request that time. The actor tries each search up to 3 times before moving on, and an empty search is never charged. If a whole run comes back empty, wait a few minutes and run it again: one of our daily health checks returned nothing, and the same input a minute later returned 10 ads. **Does it include spend, impressions or audience data?** No. Meta publishes spend and impression ranges only for political and issue ads, and this actor does not extract them even there. You get creative and metadata for every ad type. **Can I download the images and videos?** The rows contain direct links in `image_urls` and `video_urls`, and you can download from those links yourself. Meta's CDN links expire after a while, so save the files you need soon after the run. The `downloadImages` and `downloadVideos` options no longer do anything. **How do I find an advertiser's Page ID?** Run a keyword search for the brand: every ad row carries `page_id` next to `page_name`. You can also open any of the brand's ads in the Ad Library and read the Page ID there. Or skip the ID: open the advertiser's ads in the Ad Library and paste that link into `adLibraryUrls`. **Can I paste a link from the Ad Library?** Yes. Put it in `adLibraryUrls`. Three kinds of link work: a keyword search (`q=`), an advertiser's page of ads (`view_all_page_id=`) and a single ad (`id=`). The actor keeps these filters from the link: `country`, `active_status`, `ad_type`, `media_type`, `search_type`, `start_date[min]`, `start_date[max]`, `publisher_platforms`, `content_languages`, `is_targeted_country` and `sort_data`. Anything else in the link is dropped and named in the log. A link to a normal Facebook page, such as facebook.com/brandname, is not an Ad Library link and is skipped. **How do the date filters work?** `startDateMin` and `startDateMax` keep ads whose `start_date` falls between the two dates, both included, compared as the calendar day the Ad Library shows. The actor also passes the window to the Ad Library so the page holds more ads from that period. The date range inside a pasted link works differently: the Ad Library treats it as "was this ad running at some point in the window". In our test on 10 Oct 2026, a pasted keyword link with a January 2024 range returned ads that started in November and December 2023. If you want ads that started in the window, use `startDateMin` and `startDateMax`; they also apply to pasted links. **How do I get the data out?** From the run's Storage tab as JSON, CSV, Excel, XML or HTML, or through the Apify API. CSV and Excel flatten the URL lists into numbered columns. **Can I run it on a schedule or get only new ads?** Yes. Save your input as a task and add a schedule in Apify Console (Schedules, then Create new). Set `monitorMode` to `true` and each run delivers, and charges, only ads not delivered by an earlier run with the same input. **Can I use it from Claude, ChatGPT or another AI assistant?** - Connector URL: `https://mcp.apify.com/?tools=themineworks/meta-ad-library-scraper`. - Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify. - ChatGPT: developer mode, add an MCP connector with the URL, sign in with Apify. - Cursor or VS Code: add it as an HTTP MCP server with that URL. - Claude Code: `claude mcp add -t http meta-ad-library-scraper "https://mcp.apify.com/?tools=themineworks/meta-ad-library-scraper"`. It is also one of the tools inside our [E-commerce Intel MCP](https://apify.com/themineworks/ecommerce-intel-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) server, which bundles 8 e-commerce research tools. **Is it legal to scrape the Meta Ad Library?** The actor reads only the public Ad Library, a transparency archive Meta makes available to anyone without logging in. Ad creative can still contain personal data, such as a face or a name in a testimonial, and you are responsible for how you use it, including Meta's terms and data protection law such as GDPR and CCPA. This is general information, not legal advice. This actor is independent and not affiliated with or endorsed by Meta. ### Integrations Results land in a standard Apify dataset, so they connect without extra code: - **Google Sheets:** send each run's ads to a sheet with Apify's Google Sheets integration. - **Make, Zapier and n8n:** start a run and read its dataset with the official Apify apps and nodes. - **Webhooks:** get a call to your own URL when a run succeeds, then fetch the dataset. - **API and SDKs:** start runs and read results with the Apify API, or the Python and JavaScript clients. - **MCP clients:** Claude, ChatGPT, Cursor and other MCP clients can call the actor through `https://mcp.apify.com/?tools=themineworks/meta-ad-library-scraper`. ### More from The Mine Works **Marketing, SEO and reviews** - [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Trustpilot Reviews Scraper](https://apify.com/themineworks/trustpilot-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Google Trends Scraper](https://apify.com/themineworks/google-trends-pro?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Semrush Scraper](https://apify.com/themineworks/semrush-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [App Review Monitor](https://apify.com/themineworks/app-reviews-monitor?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Trustpilot Business Search](https://apify.com/themineworks/trustpilot-business-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [TripAdvisor Reviews Scraper](https://apify.com/themineworks/tripadvisor-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Username Checker](https://apify.com/themineworks/username-checker?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Backlink Building Agent](https://apify.com/themineworks/backlink-building-agent?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [E-commerce Intel MCP](https://apify.com/themineworks/ecommerce-intel-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Social media and video** - [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Leads and business directories** - [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [JustDial Scraper](https://apify.com/themineworks/justdial-business?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **LinkedIn** - [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Real estate** - [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Science, health and government data** - [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [data.gov.in Scraper](https://apify.com/themineworks/india-data-gov-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Jobs and hiring** - [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **E-commerce and marketplaces** - [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Company and business data** - [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [World Bank Trade Scraper](https://apify.com/themineworks/global-trade-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Food and local services** - [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **Developer and AI tools** - [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) **More tools** - [Tennis Match & Player Data Scraper](https://apify.com/themineworks/tennis-match-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [Google Hotels Prices Scraper](https://apify.com/themineworks/google-hotels-prices-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) - [LandWatch Scraper](https://apify.com/themineworks/landwatch-land-for-sale-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) ### Support Found a bug or need a field? Open an issue on the Issues tab of this actor. To ask for a new source, email dmineworks@gmail.com. *Facebook Ads Library Scraper pulls ads from Meta's public Ad Library by pasted link, keyword or Page ID, with copy, CTAs, landing pages and creative links, an optional start date window, no login, from $3.40 per 1,000 ads.* # Actor input Schema ## `adLibraryUrls` (type: `array`): Paste any Meta Ad Library address straight from your browser: a keyword search, an advertiser's page of ads (view_all_page_id=...) or a single ad (?id=...). The filters in the link (country, active status, ad type, media type, search type, dates, platforms, languages) are used as they are, so you get the same ads the page showed you. Filters the link leaves out come from the fields below. Example: https://www.facebook.com/ads/library/?active_status=active\&ad_type=all\&country=US\&media_type=all\&search_type=page\&view_all_page_id=162640217636958 ## `searchTerms` (type: `array`): Keywords to search the Ad Library for, e.g. a brand or product name. Each term is searched independently. Leave empty if you are searching by Ad Library link or advertiser Page ID instead. ## `pageIds` (type: `array`): Facebook Page IDs to pull ALL ads from a specific advertiser. Find a Page ID inside any ad's Ad Library detail. Use this for precise competitor tracking. Takes priority over search terms, e.g. "162640217636958". ## `searchType` (type: `string`): How searchTerms are matched, the same choice the Ad Library search box offers. Any words matches the words anywhere in the ad, in any order. Exact phrase matches the words together and in order. Has no effect on Page ID searches. ## `country` (type: `string`): Two-letter country code for the Ad Library region, e.g. US, IN, GB, AE, or ALL for every country. The Ad Library is country-scoped. ## `adActiveStatus` (type: `string`): Which ads to return: active ads still running, inactive ads that have stopped, or all ads regardless of status. ## `adType` (type: `string`): All commercial ads, or only political and issue ads (which carry extra spend and impression data). ## `mediaType` (type: `string`): Filter ads by creative type, such as image, video, or image-based memes. Choose all to skip this filter. ## `startDateMin` (type: `string`): Only ads that started running on or after this date, YYYY-MM-DD. Leave empty for no lower limit. Ads outside the window are left out and never charged. ## `startDateMax` (type: `string`): Only ads that started running on or before this date, YYYY-MM-DD. Leave empty for no upper limit. ## `publisherPlatforms` (type: `array`): Only ads shown on these platforms, using the Ad Library's own platform filter. Any of: facebook, instagram, messenger, audience_network, threads, whatsapp. Leave empty for all platforms. ## `contentLanguages` (type: `array`): Only ads in these languages, as two letter codes such as en, es or de, using the Ad Library's own language filter. Leave empty for all languages. ## `maxAdsPerSearch` (type: `integer`): Maximum number of ads to collect for each search term or advertiser. The public Ad Library returns about 30 ads per search; add more searchTerms or pageIds to gather more. ## `downloadImages` (type: `boolean`): Image creative URLs are always returned in image_urls. This build never downloads media bytes, so this toggle is accepted for compatibility but has no effect. ## `downloadVideos` (type: `boolean`): Video creative URLs are always returned in video_urls. This build never downloads media bytes, so this toggle is accepted for compatibility but has no effect. ## `monitorMode` (type: `boolean`): Run on a schedule and deliver ONLY ads not seen in a previous run, so each run shows the ads that went live since the last one. You are charged per new ad, not for every ad each time. Ideal for daily or weekly competitor watching. Requires the same input across runs. ## `proxyConfiguration` (type: `object`): Apify Residential proxy is required: Meta serves datacenter IPs an anti-bot challenge, so only residential exits reach the Ad Library. Only lightweight JSON/HTML is fetched (no media), so cost per run stays low. Leave as default. ## Actor input object example ```json { "searchTerms": [ "lab grown diamonds" ], "pageIds": [ "162640217636958" ], "searchType": "keyword_unordered", "country": "US", "adActiveStatus": "active", "adType": "all", "mediaType": "all", "maxAdsPerSearch": 10, "downloadImages": false, "downloadVideos": false, "monitorMode": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "lab grown diamonds" ], "pageIds": [ "162640217636958" ], "country": "US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("themineworks/meta-ad-library-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["lab grown diamonds"], "pageIds": ["162640217636958"], "country": "US", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("themineworks/meta-ad-library-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "lab grown diamonds" ], "pageIds": [ "162640217636958" ], "country": "US", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call themineworks/meta-ad-library-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/meta-ad-library-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/57SKI9Cz02tOmI7Hi/builds/7300KoyGDRvA6aR4I/openapi.json