# Facebook Ad Library Scraper - Meta Ads Spy Tool (`logiover/meta-ad-library-scraper`) Actor Facebook Ad Library scraper & API alternative. Scrape Facebook + Instagram ads with no login, get creative, media, spend; export to CSV/JSON. - **URL**: https://apify.com/logiover/meta-ad-library-scraper.md - **Developed by:** [Logiover](https://apify.com/logiover) (community) - **Categories:** Marketing, Business, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.50 / 1,000 results 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 ## Facebook Ad Library Scraper Scrape Facebook and Instagram ads from the Meta Ad Library by keyword or advertiser Page. This Facebook Ad Library scraper — also a Meta ads scraper and competitor ad spy tool — pulls every running and past ad with full creative, media and lifecycle data, with no login, no cookies and no API key. Give it keywords (a brand, product or topic) or exact advertiser Page IDs, and it returns the ad creative text, image and video URLs, dates, platforms, status and — for political and issue ads — spend and impressions. Export to CSV, JSON or Excel for ad creative research and competitor intelligence at scale. > No login · No cookies · No API key · Thousands of ads per search · Facebook + Instagram **Facebook Ad Library API alternative · Scrape Facebook ads without login · Meta Ad Library export CSV · Facebook ad creative scraper · Instagram ads scraper** --- ### What you get Each ad is saved as one structured record with these fields: - **pageName** / **pageId** / **pageUrl** — the advertiser behind the ad - **pageCategories** / **pageLikeCount** — advertiser context - **bodyText** / **title** / **caption** / **cardTexts** — all ad creative text - **ctaText** / **ctaType** / **linkUrl** — call-to-action and landing page - **media** — every image & video URL in the ad (including each carousel card) - **publisherPlatform** — Facebook / Instagram / Messenger / Audience Network - **startDate** / **endDate** / **totalActiveTime** — ad lifecycle - **isActive** / **status** — whether the ad is currently running - **spend** / **currency** / **impressions** / **reachEstimate** — transparency data for political & issue ads - **adArchiveId** / **adLibraryUrl** — stable ad ID and a direct link to the ad Export every field to **CSV, JSON, Excel** or HTML, or pull it via the Apify API and webhooks. --- ### Use cases - **Competitor ad spy** — swipe winning ad creatives and angles from any competitor's Page. - **Ad creative research** — build an analysis-ready dataset of body text, headlines, CTAs and media. - **Market & competitive intelligence** — track who's advertising what, where, and for how long. - **Agency creative decks** — monitor client competitors automatically and assemble swipe files. - **Political ad transparency** — analyse political & issue advertising with spend, impressions and reach. --- ### How to use No code required: 1. **Open the actor** on Apify and click **Try for free**. 2. Enter **keywords** in `searchTerms` (a brand, product or topic) and/or exact advertiser **Page IDs** in `pageIds`. 3. *(Optional)* Set `country`, `adType`, `activeStatus`, `mediaType` and `maxResults`. Keep the residential proxy on (required by Meta). 4. Click **Start**. 5. **Export** to CSV, Excel or JSON, or pull via the Apify API. **Tip:** add many keywords or Page IDs and raise `maxResults` to assemble a large ad-creative dataset in a single run. Find a Page ID in any ad's Ad Library URL (`view_all_page_id=...`). #### Input fields | Field | Type | Description | |-------|------|-------------| | `searchTerms` | array | Keywords or advertiser names (`nike`, `crypto`, `real estate`). | | `pageIds` | array | Optional. Exact Facebook Page IDs to pull all ads from one advertiser. | | `country` | string | Two-letter country code (`US`, `GB`, `DE`…) or `ALL`. Default `US`. | | `adType` | string | `all`, `political_and_issue_ads`, `housing_ads`, `employment_ads`, `credit_ads`. | | `activeStatus` | string | `all`, `active`, or `inactive`. | | `mediaType` | string | `all`, `image`, `video`, `meme`, `image_and_meme`, `none`. | | `maxResults` | integer | Total ads to collect across all searches. `0` = unlimited. Default `200`. | | `proxyConfiguration` | object | Residential proxy (required by Meta). Pre-configured for you. | Provide at least one value in `searchTerms` **or** `pageIds`. #### Example input ```json { "searchTerms": ["nike", "running shoes"], "country": "US", "adType": "all", "activeStatus": "active", "maxResults": 500 } ```` Target a single advertiser by Page ID: ```json { "pageIds": ["15087023444"], "country": "US", "maxResults": 1000 } ``` #### Example output ```json { "adArchiveId": "1289230176685703", "adLibraryUrl": "https://www.facebook.com/ads/library/?id=1289230176685703", "pageId": "15087023444", "pageName": "Nike", "status": "active", "startDate": "2026-05-14T00:00:00.000Z", "endDate": "2026-06-04T00:00:00.000Z", "publisherPlatform": ["FACEBOOK", "INSTAGRAM"], "bodyText": "Run through summer with gear that can take the heat.", "ctaText": "Shop now", "linkUrl": "https://www.nike.com/", "media": [ { "type": "image", "url": "https://scontent.../ad-image.jpg" }, { "type": "video", "url": "https://video.../ad-video.mp4" } ], "spend": null, "impressions": null, "searchedFor": "nike", "scrapedAt": "2026-06-04T10:00:00.000Z" } ``` *** ### How it works You provide keywords and/or advertiser Page IDs plus a target country. The actor opens the public Meta Ad Library for each search to establish a valid session, then paginates the results, parsing every ad into a clean record. Filters (ad type, active status, media type) are applied and results stream to your dataset, de-duplicated by ad ID. It reads only the public Ad Library over residential proxies — no login, no cookies, no developer API key, and no account is ever used or risked. *** ### FAQ #### Do I need a login, cookies or API key? No — the Meta Ad Library is public. The actor reads it over residential proxies with no account, so there's zero risk to any account. #### Can I get an advertiser's complete ad history? Yes — search by their exact Page ID and raise `maxResults` to pull every active and inactive ad the Ad Library exposes for that Page. #### Do I get spend and impressions? For **political & issue ads** Meta publishes spend ranges, impressions and reach, and the actor captures them. For ordinary commercial ads Meta does not disclose these (they come back `null`). #### Are image and video URLs included? Yes — every creative's image and video URLs are captured, including each card of carousel ads. #### Is this a Facebook Ad Library API alternative? Yes — it's a no-API-key alternative to the Meta Ad Library API. It reads the public Ad Library directly, so you don't need a developer app, access token or review process to pull ad data. #### How do I scrape Facebook ads without a login? Just enter keywords or advertiser Page IDs and run it. The actor reads the public Ad Library over residential proxies with no login, no cookies and no account, then returns every matching ad. #### How do I export Meta Ad Library data to CSV or JSON? Every ad is saved as a structured record you can export to CSV, JSON, Excel or HTML from the dataset, or pull via the Apify API and webhooks for ad creative research at scale. *** ### Works great with - **Website Contact & Email Scraper** — enrich advertiser landing pages with contact details. - **Instagram Profile Scraper** — pair ad creatives with the advertiser's organic presence. *** ### Pricing & support Pay-per-result. Collects publicly available Ad Library data only — you are responsible for compliance with Meta's Terms and applicable laws, including bulk-access limits. Need a specific field or country coverage? Open an issue on the actor's page. ### 📝 Changelog #### 2026-06-07 - Docs: added coverage for using this as a Facebook Ad Library API alternative, scraping Facebook ads without login, and exporting Meta Ad Library data to CSV/JSON. #### 2026-06-05 - 🛡️ Reliability fix: results are no longer dropped by strict output validation — runs now complete cleanly even at high volume (thousands of results). - ⚡ Stability & performance hardening; fresh rebuild. #### 2026-06-04 - Initial release — keyword & Page ID search, full creative + media, lifecycle, platform breakdown and political-ad spend/impressions. # Actor input Schema ## `searchTerms` (type: `array`): Keywords or advertiser/brand names to search the Meta Ad Library for. Examples: 'nike', 'crypto', 'real estate agent'. Leave empty if you only use Page IDs. ## `pageIds` (type: `array`): Optional. Exact Facebook Page IDs to pull every ad from a specific advertiser (more precise than a keyword). Find the ID in any ad's Ad Library page URL (view\_all\_page\_id=...). ## `country` (type: `string`): Two-letter country code for the ad audience. Use 'ALL' for worldwide. ## `adType` (type: `string`): Which ad category to search. ## `activeStatus` (type: `string`): Filter by whether ads are currently running. ## `mediaType` (type: `string`): Filter by creative format. ## `maxResults` (type: `integer`): Total number of ads to collect across all searches. 0 = unlimited (until the Ad Library runs out). ## `proxyConfiguration` (type: `object`): The Meta Ad Library requires residential proxies. Keep the default (Apify Proxy · RESIDENTIAL). ## Actor input object example ```json { "searchTerms": [ "nike", "crypto" ], "pageIds": [ "15087023444" ], "country": "US", "adType": "all", "activeStatus": "all", "mediaType": "all", "maxResults": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `pageName` (type: `string`): Advertiser / page name ## `bodyText` (type: `string`): Primary ad creative text ## `publisherPlatform` (type: `string`): FB / IG / etc. ## `status` (type: `string`): Active / inactive ## `startDate` (type: `string`): Ad start date ## `adLibraryUrl` (type: `string`): Link to the ad in the Meta Ad Library # 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": [ "nike" ], "country": "US", "maxResults": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("logiover/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": ["nike"], "country": "US", "maxResults": 30, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("logiover/meta-ad-library-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 '{ "searchTerms": [ "nike" ], "country": "US", "maxResults": 30, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call logiover/meta-ad-library-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=logiover/meta-ad-library-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Ad Library Scraper - Meta Ads Spy Tool", "description": "Facebook Ad Library scraper & API alternative. Scrape Facebook + Instagram ads with no login, get creative, media, spend; export to CSV/JSON.", "version": "1.0", "x-build-id": "DKatYVh6DOYAmktOE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~meta-ad-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-meta-ad-library-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/logiover~meta-ad-library-scraper/runs": { "post": { "operationId": "runs-sync-logiover-meta-ad-library-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/logiover~meta-ad-library-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-meta-ad-library-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", "properties": { "searchTerms": { "title": "Search terms (keywords / advertiser names)", "type": "array", "description": "Keywords or advertiser/brand names to search the Meta Ad Library for. Examples: 'nike', 'crypto', 'real estate agent'. Leave empty if you only use Page IDs.", "items": { "type": "string" } }, "pageIds": { "title": "Advertiser Page IDs", "type": "array", "description": "Optional. Exact Facebook Page IDs to pull every ad from a specific advertiser (more precise than a keyword). Find the ID in any ad's Ad Library page URL (view_all_page_id=...).", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code for the ad audience. Use 'ALL' for worldwide.", "default": "US" }, "adType": { "title": "Ad type", "enum": [ "all", "political_and_issue_ads", "housing_ads", "employment_ads", "credit_ads" ], "type": "string", "description": "Which ad category to search.", "default": "all" }, "activeStatus": { "title": "Active status", "enum": [ "all", "active", "inactive" ], "type": "string", "description": "Filter by whether ads are currently running.", "default": "all" }, "mediaType": { "title": "Media type", "enum": [ "all", "image", "video", "meme", "image_and_meme", "none" ], "type": "string", "description": "Filter by creative format.", "default": "all" }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Total number of ads to collect across all searches. 0 = unlimited (until the Ad Library runs out).", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The Meta Ad Library requires residential proxies. Keep the default (Apify Proxy · RESIDENTIAL).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```