# Facebook Ads Library Scraper (`apify/facebook-ads-scraper`) Actor Extract advertising data from Facebook, Instagram, WhatsApp, Threads, Messenger. Get ad details, publishers, prices, reach estimates, impressions, links, images, ad IDs, timestamps, and more from Meta Ad Library. Export ad data, schedule runs via API, and integrate with other tools or AI workflows. - **URL**: https://apify.com/apify/facebook-ads-scraper.md - **Developed by:** [Apify](https://apify.com/apify) (Apify) - **Categories:** Social media, E-commerce - **Stats:** 24,177 total users, 3,326 monthly users, 100.0% runs succeeded, 401 bookmarks - **User rating**: 2.47 out of 5 stars ## 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README > ๐Ÿš€ **New feature: _About page_ insights from Meta Ad Library**. You can now scrape info about: > > - Organizations that manage this page: advertiser's business address and registered phone number > - Primary country location of a page: countries where page admins are located > - Page history: when a page was created, if it ever changed its name or merged with another page > > All valuable signals when researching competitors, brands or campaigns. Try it out and let us know what you think in a [review](https://apify.com/apify/facebook-ads-scraper/reviews)! ### What can Facebook Ads Scraper do? Facebook Ads Scraper **extracts data from the Meta Ad Library across multiple Meta platforms** beyond what official APIs provide. Add one or multiple Facebook page URLs or Meta Ad Library URLs, and you can: ๐Ÿงฉ Scrape ads published across **Meta platforms**, including Facebook, Instagram, WhatsApp, Threads, Messenger, and Audience Network ๐Ÿ”Ž Prefilter ads by **brand, keyword, country, language, media type, status (active or inactive), ad type** (product, political, housing), and creative format ๐Ÿข Get advertiser transparency signals from the Meta Ad Library about page, including **business address, admin countries and counts, and page creation/merging or name change history** ๐ŸŒ Track **ad performance across countries, languages, and brands** to compare regional strategies and localization efforts ๐ŸŽจ Analyze and reuse **complete ad creatives**, including images, videos, carousels, memes, ad copy, and CTA links โฌ‡๏ธ Export ad data in **JSON, CSV, Excel, or XML** ๐Ÿฆพ Access the data programmatically via SDKs (Python & Node.js), API endpoints, and webhooks Add Facebook Ads Scraper to your **ad research and transparency toolkit** to support competitor monitoring, content strategy optimization, benchmarking, performance analysis, and regulatory reporting. ### What Facebook and Instagram ad data can I extract? With this Meta Ads API, you will be able to extract the following data from Meta platforms:
๐Ÿ“ Page name, ID, alias, category, verification status ๐Ÿ”— Page URL & profile links
๐Ÿ“Š Page metrics (likes, Instagram followers) ๐Ÿ“ธ Page profile & cover images
๐Ÿง‘โ€๐Ÿ’ผ Page owner & transparency info ๐Ÿข Advertiser's business address and phone
๐ŸŒ Page admin locations by country ๐Ÿงฎ page admin count per country
๐Ÿ“… Page creation date & name change history ๐Ÿ› Ad text & messaging
๐Ÿท Ad category & type (e.g. product, political, social issue) ๐ŸŽจ Ad creatives (images, videos, carousels)
๐Ÿ–ผ Creative variants & display format ๐Ÿ–ฑ CTA text & CTA type
๐Ÿ”— Destination links (when available) ๐Ÿ“ข Publisher platforms (Facebook, Instagram, WhatsApp, Threads, Audience Network)
๐ŸŒ Language & country signals (when available) โฑ Ad start & end dates
๐Ÿ“… Visibility timeframe & activity history ๐Ÿ’ธ Ad spend data & currency (when available)
๐Ÿ‘€ Reach & impression estimates (when available) ๐Ÿงฎ Report count & user reports
๐Ÿšฆ Ad status (active/inactive) ๐Ÿ“ฆ Branded content & partner page details
๐Ÿ”Ž Compliance, eligibility & safety flags
### How much will scraping ads data from Facebook or Instagram cost you? Facebook Ads Scraper uses a **pay-per-result (PPR)** pricing model, where one result equals one ad campaign. On the Free plan, it costs **$5.80 per 1,000 ads**, with no discount applied. Paid plans offer discounted rates and higher monthly credit. For example, the Starter plan charges $5.00 per 1,000 ads, which allows you to **scrape 7,800 ads per month**. The Scale and Business plans reduce the price to **$4.20 with 47,000 ads per month**, and **$3.40 with 300,000 ads per month**, respectively. Check the [pricing tab](https://apify.com/apify/facebook-ads-scraper/pricing) for full details. Check the [pricing tab](https://apify.com/apify/facebook-ads-scraper/pricing) for full details. ### How do I use Facebook Ad Library Scraper? Facebook Ads Scraper was designed to be easy to start with, even if you've never extracted data from the web before. Here's how you can scrape Meta ads data with this tool: 1. [Create](https://console.apify.com/sign-up) a free Apify account using your email. 2. Open [Facebook Ad Library Scraper](https://apify.com/apify/facebook-ads-scraper). 3. Add a Facebook Page URL to scrape ads from. 4. Alternatively, head over to the Meta Ad Library. Choose the country, advertisement category, and brand name or keyword. Then filter the results by platform, language, activity, media type, timeframe, or even audience size before scraping them. Copy the URL to the scraper. 5. Click "Start" and wait for the data to be extracted. 6. Download your data in JSON, XML, CSV, Excel, or HTML. For a step-by-step guide on how to scrape Facebook Page Ads, follow our [Facebook Page Ads Scraper tutorial](https://blog.apify.com/scrape-facebook-ads-data/) ๐Ÿ“ or this [video guide](https://www.youtube.com/watch?v=eMkayN0wljA) [https://www.youtube.com/watch?v=eMkayN0wljA](https://www.youtube.com/watch?v=eMkayN0wljA) > Please note that this scraper displays the extracted results only at the very end of the run. The rest of the time it will display 0 results. Please be patient to see all the extracted data. ### โฌ‡๏ธย Input Enter either a Facebook page **URL or a Meta Ad Library URL of a brand or an ad.** To scrape Facebook Ads, the input should be either: - **URLs of brands or ads taken directly from [Meta Ad Library](https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=CZ&is_targeted_country=false&media_type=all),** such as `https://www.facebook.com/ads/library/?active_status=active&ad_type=all&content_languages[0]=en&country=ALL&is_targeted_country=false&media_type=image&publisher_platforms[0]=instagram&publisher_platforms[1]=facebook&search_type=page&view_all_page_id=15087023444`. - Before you copy&paste this type of URL, **don't forget to include various settings, platforms, keywords, or filters** available in Meta Ad Library. - Alternatively, you can **add one or more Facebook page URLs** to scrape the ads from, such as `SHEINOFFICIAL` - Additionally, choose active or inactive ads, whether to scrape the ad details. You can input URLs individually or in bulk using the **Bulk edit** function. You can also input data manually via the UI, JSON, or programmatically via an API. Click on the [input tab](https://apify.com/apify/facebook-page-ads/input-schema) for a full explanation of input in JSON. Scrape ads from Meta Facebook Instagram ### โฌ†๏ธย Output The results will appear in a dataset in the **Storage** tab. You can view them as a table, download in **JSON, CSV, Excel, or XML**, or use API endpoints. Instagram ads Meta ads Facebook ads output Besides the table view, you can also view your data as JSON, as well as download it as CSV, XML, Excel file, or through an API. #### ๐Ÿ›๏ธย Meta ad data sample ```json [ { "inputUrl": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&sort_data[direction]=desc&sort_data[mode]=total_impressions&view_all_page_id=14226545351", "pageInfo": { "adLibrarySystemStatus": { "systemStatus": { "status": "NO_KNOWN_ISSUES", "activeIssues": [] } }, "adLibraryPageInfo": { "pageInfo": { "relatedPages": [], "hasBlankAds": false, "hiddenAds": 0, "pageIsDeleted": false } }, "page": { "name": "Red Bull", "id": "14226545351", "url": "https://facebook.com/RedBull", "about": { "text": "#givesyouwings" }, "isDelegatePageWithLinkedPrimaryProfile": false, "confirmedPageOwner": { "name": "Red Bull GmbH", "information": { "address": { "city": "Fuschl am See", "country": "Austria", "postalCode": "5330", "state": "Salzburg" }, "phoneNumber": "+4366265820" }, "id": "1343491232398327" }, "pagesTransparencyInfo": { "historyItems": [ { "eventTime": 1195157435, "eventTimeFormatted": "2007-11-15T20:10:35.000Z", "itemType": "CREATION" } ], "stateMediaCountryLabel": null, "id": "dHJhbnNwYXJlbmN5OjE0MjI2NTQ1MzUx", "adminLocations": { "adminCountryCounts": [ { "count": 22, "country": { "isoName": "Colombia", "id": "92735937793" } }, { "count": 20, "country": { "isoName": "Japan", "id": "92195839502" } }, { "count": 17, "country": { "isoName": "United States", "id": "109078688522" } }, { "count": 15, "country": { "isoName": "Germany", "id": "91890339762" } }, { "count": 15, "country": { "isoName": "Ireland", "id": "110269268763" } }, { "count": 13, "country": { "isoName": "Slovenia", "id": "119154870644" } }, { "count": 13, "country": { "isoName": "Taiwan", "id": "92311338177" } }, { "count": 12, "country": { "isoName": "Austria", "id": "91893411866" } }, { "count": 12, "country": { "isoName": "Hong Kong", "id": "91293064138" } }, { "count": 12, "country": { "isoName": "Serbia", "id": "91658138166" } }, { "count": 9, "country": { "isoName": "Denmark", "id": "87875133995" } }, { "count": 9, "country": { "isoName": "Iceland", "id": "110168016413" } }, { "count": 9, "country": { "isoName": "Peru", "id": "91645114050" } }, { "count": 9, "country": { "isoName": "Slovakia", "id": "91645119050" } }, { "count": 8, "country": { "isoName": "France", "id": "95406052401" } }, { "count": 8, "country": { "isoName": "Romania", "id": "95260222184" } }, { "count": 7, "country": { "isoName": "Bulgaria", "id": "219509210704" } }, { "count": 7, "country": { "isoName": "Croatia", "id": "91608386397" } }, { "count": 7, "country": { "isoName": "Nigeria", "id": "192858350042" } }, { "count": 6, "country": { "isoName": "Azerbaijan", "id": "92433113417" } }, { "count": 6, "country": { "isoName": "Greece", "id": "99486756859" } }, { "count": 5, "country": { "isoName": "Albania", "id": "88535262876" } }, { "count": 5, "country": { "isoName": "Bosnia and Herzegovina", "id": "116883609605" } }, { "count": 5, "country": { "isoName": "Costa Rica", "id": "93019184188" } }, { "count": 5, "country": { "isoName": "Georgia", "id": "93876668738" } }, { "count": 5, "country": { "isoName": "Israel", "id": "116589101421" } }, { "count": 5, "country": { "isoName": "Lithuania", "id": "105453192089" } }, { "count": 4, "country": { "isoName": "Brazil", "id": "90994063252" } }, { "count": 4, "country": { "isoName": "Czech Republic", "id": "105109207058" } }, { "count": 4, "country": { "isoName": "Netherlands", "id": "92510804409" } }, { "count": 4, "country": { "isoName": "Russia", "id": "106796118976" } }, { "count": 4, "country": { "isoName": "South Africa", "id": "115317272677" } }, { "count": 4, "country": { "isoName": "United Kingdom", "id": "112449756806" } }, { "count": 3, "country": { "isoName": "Belarus", "id": "229782425120" } }, { "count": 3, "country": { "isoName": "Belgium", "id": "91040649644" } }, { "count": 3, "country": { "isoName": "Estonia", "id": "129110644376" } }, { "count": 3, "country": { "isoName": "Hungary", "id": "111134858495" } }, { "count": 3, "country": { "isoName": "Kosovo", "id": "169353466461152" } }, { "count": 3, "country": { "isoName": "New Zealand", "id": "89788072708" } }, { "count": 3, "country": { "isoName": "South Korea", "id": "102898199121" } }, { "count": 3, "country": { "isoName": "Spain", "id": "119422531140" } }, { "count": 3, "country": { "isoName": "United Arab Emirates", "id": "89207763882" } }, { "count": 3, "country": { "isoName": "Uzbekistan", "id": "112071235700" } }, { "count": 2, "country": { "isoName": "Australia", "id": "109353030906" } }, { "count": 2, "country": { "isoName": "Canada", "id": "111030136976" } }, { "count": 2, "country": { "isoName": "Cyprus", "id": "92991592249" } }, { "count": 2, "country": { "isoName": "Egypt", "id": "105539829144" } }, { "count": 2, "country": { "isoName": "Italy", "id": "92597621657" } }, { "count": 2, "country": { "isoName": "Kazakhstan", "id": "205547500176" } }, { "count": 2, "country": { "isoName": "Kenya", "id": "95253352365" } }, { "count": 2, "country": { "isoName": "Latvia", "id": "89000671298" } }, { "count": 2, "country": { "isoName": "Mexico", "id": "115224736100" } }, { "count": 2, "country": { "isoName": "North Macedonia", "id": "91210568207" } }, { "count": 2, "country": { "isoName": "Philippines", "id": "91736443564" } }, { "count": 2, "country": { "isoName": "Poland", "id": "117584095588" } }, { "count": 2, "country": { "isoName": "Sri Lanka", "id": "91370559091" } }, { "count": 2, "country": { "isoName": "Sweden", "id": "88217238801" } }, { "count": 2, "country": { "isoName": "Switzerland", "id": "98259891898" } }, { "count": 2, "country": { "isoName": "Ukraine", "id": "98924891206" } }, { "count": 1, "country": { "isoName": "India", "id": "92061054329" } }, { "count": 1, "country": { "isoName": "Mauritius", "id": "128071240168" } }, { "count": 1, "country": { "isoName": "Pakistan", "id": "118696946419" } }, { "count": 1, "country": { "isoName": "Panama", "id": "124961712192" } }, { "count": 1, "country": { "isoName": "Portugal", "id": "100188412135" } }, { "count": 1, "country": { "isoName": "Turkey", "id": "91221319827" } } ] } }, "adLibraryPageTargetingInsight": null }, "adLibraryUser": null }, "pageID": "14226545351", "adArchiveID": "1204694134935316", "startDateFormatted": "2026-01-05T08:00:00.000Z", "endDateFormatted": "2026-01-26T08:00:00.000Z", "adArchiveId": "1204694134935316", "collationCount": 1, "collationId": "1896743701050069", "pageId": "14226545351", "snapshot": { "brandedContent": null, "pageId": "14226545351", "pageIsDeleted": false, "pageProfileUri": "https://www.facebook.com/RedBull/", "rootResharedPost": null, "byline": null, "disclaimerLabel": null, "pageName": "Red Bull", "pageProfilePictureUrl": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/599950599_1343522087086992_7511037966261502620_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Pgsr93VvL5QQ7kNvwG2I0JT&_nc_oc=Adli03fT1nIeTgQZTSHvw0Ii9sErgp_xloJF0r2H2QSZAn25mkZiC7cW9vxH6zlIskE&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfqNW7I0Ln85cLE6eHYMfed1IPI5Vg1hQiGsvvKLkzwKLQ&oe=697FCFE5", "event": null, "caption": "Redbull.com", "ctaText": "Learn more", "cards": [ { "body": "", "ctaType": "LEARN_MORE", "caption": "Redbull.com", "linkDescription": null, "linkUrl": "https://www.amazon.com/stores/RedBull/page/981A280B-9A52-4F10-9078-409328413402?maas=maas_adg_790F225A3861AC06E8B11738F822A206_afap_abs&ref_=aa_maas&tag=maas", "title": null, "ctaText": "Learn More", "videoHdUrl": null, "videoPreviewImageUrl": null, "videoSdUrl": null, "watermarkedVideoHdUrl": null, "watermarkedVideoSdUrl": null, "imageCrops": [], "originalImageUrl": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.35426-6/600350043_719867334526215_7427027614294650196_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=dPmjcjXmw6sQ7kNvwG2fiUT&_nc_oc=AdmACEQNpX6mMochHsGqYjWPtGI8PNm8xaV5CZ8-NxoQVSsDnmqnVk9qNMIs06QMy9k&_nc_zt=14&_nc_ht=scontent-dfw5-2.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfpCAtg9TwpVg6BGCM9padjVnL-LxBIRrXAYk0gzYxsydQ&oe=697FDD4D", "resizedImageUrl": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.35426-6/600283478_1489116579888224_8781835938301589479_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=sBwcmJsX5KMQ7kNvwH_RKwj&_nc_oc=AdnSSkhDFUGvPgf99wCU5YeW1l2AQKBgTgmf7b_fBqHQw-wvEl0uhawigaef_00vmNs&_nc_zt=14&_nc_ht=scontent-dfw5-2.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfpX3VU0H_-tcXdseIShKqFPjVEIf0xopPgYTEBLk7Wikw&oe=697FC7C2", "watermarkedResizedImageUrl": "" }, { "body": "All Cans On Deck.", "ctaType": "LEARN_MORE", "caption": "Redbull.com", "linkDescription": null, "linkUrl": "https://www.amazon.com/stores/RedBull/page/981A280B-9A52-4F10-9078-409328413402?maas=maas_adg_790F225A3861AC06E8B11738F822A206_afap_abs&ref_=aa_maas&tag=maas", "title": "#GivesYouWiiings", "ctaText": "Learn More", "videoHdUrl": null, "videoPreviewImageUrl": null, "videoSdUrl": null, "watermarkedVideoHdUrl": null, "watermarkedVideoSdUrl": null, "imageCrops": [], "originalImageUrl": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.35426-6/600369762_33116106151370832_5087459572385427176_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=TbwW-S2P0CIQ7kNvwGmbzYP&_nc_oc=AdmxPdmWKXuMWWKLe2M6vRCsX7qJINAUnCfn-gotg3Hq_BBk6MQ9IvIUM6KNnhjquwc&_nc_zt=14&_nc_ht=scontent-dfw5-2.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfoJr12MDYHQAWNfE346iGtpR9EruXZUkJAZlv6Qj8IPHQ&oe=697FE1DC", "resizedImageUrl": "https://scontent-dfw5-2.xx.fbcdn.net/v/t39.35426-6/600274005_1376329330853982_5033820845189929623_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=PMbtYJGb_TkQ7kNvwGlerPk&_nc_oc=AdnSYYIX7iZBAqex7PUw_pFFsZe8UD5ZFDR7UjkJhiihB-vdKArq41l9YFOEawK5DaA&_nc_zt=14&_nc_ht=scontent-dfw5-2.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfrcnYFsAroxKUKM0RbPzEMUjs8sdGQEHYxXzO_QheFBZQ&oe=697FD17A", "watermarkedResizedImageUrl": "" }, { "body": "All Cans On Deck.", "ctaType": "LEARN_MORE", "caption": "Redbull.com", "linkDescription": null, "linkUrl": "https://www.amazon.com/stores/RedBull/page/981A280B-9A52-4F10-9078-409328413402?maas=maas_adg_790F225A3861AC06E8B11738F822A206_afap_abs&ref_=aa_maas&tag=maas", "title": "#GivesYouWiiings", "ctaText": "Learn More", "videoHdUrl": null, "videoPreviewImageUrl": null, "videoSdUrl": null, "watermarkedVideoHdUrl": null, "watermarkedVideoSdUrl": null, "imageCrops": [], "originalImageUrl": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/599941675_1206773504745669_5683872196380222771_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UsCiyENQIeAQ7kNvwEqdOvP&_nc_oc=AdknX-eKRisE2SxyIlfH5eGUIRxX7dXKPopGOPJMM4xtyMhcGlvGx1MUN21LkCxC3Kw&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_Afrtt707C2tpIXaDAMd4ZgIgDwu2teJU1VLoNIsriawuTQ&oe=697FED28", "resizedImageUrl": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.35426-6/600574390_906407708581037_6849091730486168701_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=vSK4ykq6qn0Q7kNvwHzdw-o&_nc_oc=AdkIfoovWlBRp2-rOkFg9ZILyy_94Mo8k4HY3qM5vpg3iqGkW6URldPUGlmkqa_RQq0&_nc_zt=14&_nc_ht=scontent-dfw6-1.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfrX0MYmDnhxWsVyGgy6Ahhhoc80vHWU0PFVDsY2Ldlk-Q&oe=697FCAAD", "watermarkedResizedImageUrl": "" }, { "body": "All Cans On Deck.", "ctaType": "LEARN_MORE", "caption": "Redbull.com", "linkDescription": null, "linkUrl": "https://www.amazon.com/stores/RedBull/page/981A280B-9A52-4F10-9078-409328413402?maas=maas_adg_790F225A3861AC06E8B11738F822A206_afap_abs&ref_=aa_maas&tag=maas", "title": "#GivesYouWiiings", "ctaText": "Learn More", "videoHdUrl": null, "videoPreviewImageUrl": null, "videoSdUrl": null, "watermarkedVideoHdUrl": null, "watermarkedVideoSdUrl": null, "imageCrops": [], "originalImageUrl": "https://scontent-dfw5-1.xx.fbcdn.net/v/t39.35426-6/599941675_1206773504745669_5683872196380222771_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UsCiyENQIeAQ7kNvwEqdOvP&_nc_oc=AdknX-eKRisE2SxyIlfH5eGUIRxX7dXKPopGOPJMM4xtyMhcGlvGx1MUN21LkCxC3Kw&_nc_zt=14&_nc_ht=scontent-dfw5-1.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_Afrtt707C2tpIXaDAMd4ZgIgDwu2teJU1VLoNIsriawuTQ&oe=697FED28", "resizedImageUrl": "https://scontent-dfw6-1.xx.fbcdn.net/v/t39.35426-6/600574390_906407708581037_6849091730486168701_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=vSK4ykq6qn0Q7kNvwHzdw-o&_nc_oc=AdkIfoovWlBRp2-rOkFg9ZILyy_94Mo8k4HY3qM5vpg3iqGkW6URldPUGlmkqa_RQq0&_nc_zt=14&_nc_ht=scontent-dfw6-1.xx&_nc_gid=kWgEetU86WMmQaI1rHhefw&oh=00_AfrX0MYmDnhxWsVyGgy6Ahhhoc80vHWU0PFVDsY2Ldlk-Q&oe=697FCAAD", "watermarkedResizedImageUrl": "" } ], "body": { "text": "{{product.brand}}" }, "ctaType": "LEARN_MORE", "displayFormat": "DCO", "linkDescription": "{{product.description}}", "linkUrl": "https://www.amazon.com/stores/RedBull/page/981A280B-9A52-4F10-9078-409328413402?maas=maas_adg_790F225A3861AC06E8B11738F822A206_afap_abs&ref_=aa_maas&tag=maas", "images": [], "pageCategories": ["Website"], "pageLikeCount": 60636895, "title": "{{product.name}}", "videos": [], "isReshared": false, "extraLinks": [], "extraTexts": [], "extraImages": [], "extraVideos": [], "countryIsoCode": null, "brazilTaxId": null, "additionalInfo": null, "ecCertificates": [] }, "isActive": true, "hasUserReported": false, "reportCount": null, "menuItems": [], "stateMediaRunLabel": null, "pageIsDeleted": false, "pageName": "Red Bull", "impressionsWithIndex": { "impressionsText": null, "impressionsIndex": -1 }, "gatedType": "ELIGIBLE", "categories": ["UNKNOWN"], "isAaaEligible": false, "containsDigitalCreatedMedia": false, "reachEstimate": null, "currency": "", "spend": null, "endDate": 1769414400, "publisherPlatform": ["FACEBOOK", "INSTAGRAM", "THREADS"], "startDate": 1767600000, "containsSensitiveContent": false, "totalActiveTime": null, "regionalRegulationData": { "finserv": { "isDeemedFinserv": false, "isLimitedDelivery": false }, "twAntiScam": { "isLimitedDelivery": false } }, "hideDataStatus": "NONE", "fevInfo": null, "adId": null, "targetedOrReachedCountries": [] } ] ```` > Please note that `startDate` and `endDate` (if available) will be added as formatted ISO values as `startDateFormatted`: "2026-02-12T07:00:00.000Z" and `endDateFormatted` : "2026-02-12T07:00:00.000Z" ### Want to scrape Facebook comments or groups? You can use the dedicated scrapers below if you want to scrape specific Facebook data. Each of them is built particularly for the relevant Facebook or Instagram scraping case, be it posts, comments, reels, or search results. Feel free to browse them:
๐Ÿ“ท Instagram Scraper ๐Ÿ•ต๏ธโ€โ™€๏ธ Facebook Search Scraper ๐Ÿ‘ฅ Facebook Groups Scraper
๐Ÿ˜Ž Facebook Followers & Following Scraper ๐Ÿ‘€ Facebook Marketplace Scraper ๐ŸŽž Facebook Reels Scraper
๐ŸŒŸ Facebook Reviews Scraper ๐Ÿ“ Facebook Posts Scraper ๐Ÿ“น Facebook Video Search Scraper
๐Ÿ’ฌ Facebook Comments Scraper ๐Ÿ‘ Facebook Likes and Reactions Scraper โ„น๏ธ Facebook Page Contact Information
๐Ÿ‘ฅ Facebook Groups Scraper ๐Ÿž Facebook Photos Scraper ๐Ÿ‘€ Facebook Marketplace Scraper
๐Ÿ“˜ Facebook Pages Scraper ๐ŸŽž๏ธ Facebook Reels Scraper ๐Ÿ—“ Facebook Events Scraper
๐Ÿ”ฎ Brand Collaboration Scraper
### โ“FAQ #### Is it legal to scrape Facebook Ads data? Our Facebook Ads Scraper only collects data that is publicly available in the Meta Ad Library. It does not access private content or extract sensitive user information such as email addresses or precise location. You should be aware that some public data may still be considered personal data under regulations like the [GDPR](https://en.wikipedia.org/wiki/General_Data_Protection_Regulation). Only scrape data if you have a legitimate reason. For more context, see our blog posts on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and [ethical web scraping](https://blog.apify.com/what-is-ethical-web-scraping-and-how-do-you-do-it/). #### Can I integrate Facebook Ads data with other services? Yes. Scraped Facebook Ads data can be integrated with almost any cloud service or web app. Apify supports **Make, Zapier, n8n, Slack, Airbyte, Asana, GitHub, Google Sheets, Google Drive**, [and more](https://apify.com/integrations). You can also use [webhooks](https://docs.apify.com/integrations/webhooks) to trigger actions when a run finishes, such as sending notifications or syncing results to another system. #### Can I access Meta Ads data through an MCP server? Yes. You can connect your scraped Instagram or Facebook ads to an [MCP server](https://apify.com/apify/facebook-ads-scraper/api/mcp) using clients like ClaudeDesktop or LibreChat, or build your own integration. For Facebook Ads Scraper: 1. Start a Server-Sent Events (SSE) session to receive a `sessionId`. 2. Send API messages using that `sessionId` to trigger the scraper. 3. The message starts the Facebook Ads Scraper with the provided input. 4. The response should be: Accepted. Learn more in the [MCP setup guide](https://blog.apify.com/how-to-use-mcp/). #### Can I use the Facebook Ads Library Scraper with API? Yes. The Apify API provides programmatic access to run Actors, fetch datasets, monitor performance, and manage versions and schedules. For Node.js, use the apify-client NPM package. For Python, use the apify-client PyPI package. Full details are available in the [Apify API reference](https://docs.apify.com/api/v2), or check the [API tab](https://apify.com/apify/facebook-page-ads/api) for ready-to-use code examples. #### Meta Ads Scraper not working The Apify team continuously improves Actor performance. If you run into technical issues or find a bug, please create an issue on the Actorโ€™s [Issues tab](https://apify.com/apify/facebook-ads-scraper/issues/open) in Apify Console. # Actor input Schema ## `startUrls` (type: `array`): Add a URL of a Facebook Page or brand URL from Meta Ad Library. You can add multiple URLs using the Bulk edit option. ## `resultsLimit` (type: `integer`): โš ๏ธ If you leave this field empty, you will get as many results as possible. ## `onlyTotal` (type: `boolean`): If checked, you will scrape only the total count of ads.
The output will be saved as a single dataset item per page. ## `includeAboutPage` (type: `boolean`): If checked, the scraper will extract the about page information for all unique pages or urls. ## `isDetailsPerAd` (type: `boolean`): If checked, you will scrape extra audience details scraped for each ad. ## `activeStatus` (type: `string`): Select active status for ads ## Actor input object example ```json { "startUrls": [ { "url": "https://www.facebook.com/SHEINOFFICIAL" }, { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&content_languages[0]=en&country=ALL&is_targeted_country=false&media_type=image&publisher_platforms[0]=instagram&publisher_platforms[1]=facebook&search_type=page&view_all_page_id=15087023444" } ], "resultsLimit": 10, "activeStatus": "" } ``` # Actor output Schema ## `dataset` (type: `string`): Dataset containing all scraped data # 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 = { "startUrls": [ { "url": "https://www.facebook.com/SHEINOFFICIAL" }, { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&content_languages[0]=en&country=ALL&is_targeted_country=false&media_type=image&publisher_platforms[0]=instagram&publisher_platforms[1]=facebook&search_type=page&view_all_page_id=15087023444" } ], "resultsLimit": 10, "activeStatus": "" }; // Run the Actor and wait for it to finish const run = await client.actor("apify/facebook-ads-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 = { "startUrls": [ { "url": "https://www.facebook.com/SHEINOFFICIAL" }, { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&content_languages[0]=en&country=ALL&is_targeted_country=false&media_type=image&publisher_platforms[0]=instagram&publisher_platforms[1]=facebook&search_type=page&view_all_page_id=15087023444" }, ], "resultsLimit": 10, "activeStatus": "", } # Run the Actor and wait for it to finish run = client.actor("apify/facebook-ads-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.facebook.com/SHEINOFFICIAL" }, { "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&content_languages[0]=en&country=ALL&is_targeted_country=false&media_type=image&publisher_platforms[0]=instagram&publisher_platforms[1]=facebook&search_type=page&view_all_page_id=15087023444" } ], "resultsLimit": 10, "activeStatus": "" }' | apify call apify/facebook-ads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=apify/facebook-ads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Ads Library Scraper", "description": "Extract advertising data from Facebook, Instagram, WhatsApp, Threads, Messenger. Get ad details, publishers, prices, reach estimates, impressions, links, images, ad IDs, timestamps, and more from Meta Ad Library. Export ad data, schedule runs via API, and integrate with other tools or AI workflows.", "version": "0.0", "x-build-id": "aTARR5GIRLOI1zDYF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apify~facebook-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apify-facebook-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/apify~facebook-ads-scraper/runs": { "post": { "operationId": "runs-sync-apify-facebook-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/apify~facebook-ads-scraper/run-sync": { "post": { "operationId": "run-sync-apify-facebook-ads-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "๐Ÿ”— Meta Ad Library URL or Facebook Page URL", "type": "array", "description": "Add a URL of a Facebook Page or brand URL from Meta Ad Library. You can add multiple URLs using the Bulk edit option.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "resultsLimit": { "title": "๐Ÿ’ฏ Maximum ads", "minimum": 1, "type": "integer", "description": "โš ๏ธ If you leave this field empty, you will get as many results as possible." }, "onlyTotal": { "title": "I want only the total count of ads per page", "type": "boolean", "description": "If checked, you will scrape only the total count of ads.
The output will be saved as a single dataset item per page." }, "includeAboutPage": { "title": "Include about page information", "type": "boolean", "description": "If checked, the scraper will extract the about page information for all unique pages or urls." }, "isDetailsPerAd": { "title": "I want ad details as well", "type": "boolean", "description": "If checked, you will scrape extra audience details scraped for each ad." }, "activeStatus": { "title": "๐Ÿ–ฑ๏ธ Active status (if not specified within the Meta Ad Library URL)", "enum": [ "", "active", "inactive" ], "type": "string", "description": "Select active status for ads", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```