# Facebook Ad Library Scraper - Competitor Ad Intelligence (`makework36/facebook-adlib-scraper`) Actor Scrape the Meta Ad Library for any keyword or advertiser across all countries. Returns ad creative text, call-to-action, landing page URL, platforms, spend ranges, impression estimates, and media URLs. Works for all active and inactive ads. No Facebook account required. - **URL**: https://apify.com/makework36/facebook-adlib-scraper.md - **Developed by:** [oscar lira](https://apify.com/makework36) (community) - **Categories:** Social media, Lead generation, AI - **Stats:** 7 total users, 5 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 the Meta Ad Library for any keyword, brand, or advertiser name. Returns structured data for every ad: creative text, call-to-action, landing page, platforms, spend and impression ranges (when available), and media URLs. Works across all countries supported by the Ad Library. No Facebook login required. ### What you get For each ad, you get a JSON object like this (from a "nike" search): ```json { "adArchiveID": "582019374031826", "status": "ACTIVE", "startDate": "2026-03-15", "endDate": null, "pageName": "Nike", "pageID": "15087023444", "adText": "Just satisfying enough. The Pegasus Premium with ReactX foam returns energy like nothing else. Available now.", "callToAction": "Shop Now", "link": "https://www.nike.com/running/pegasus-premium", "platforms": ["facebook", "instagram"], "spend": null, "impressions": null, "versions": 3, "mediaUrl": "https://scontent.xx.fbcdn.net/v/t45.1600-4/example_image.jpg" } ```` ### Output fields | Field | Type | Description | |-------|------|-------------| | adArchiveID | string | Unique ad identifier in Meta's Ad Library | | status | string | ACTIVE or INACTIVE | | startDate | string | Date the ad started running (YYYY-MM-DD) | | endDate | string | Date the ad stopped, or null if still running | | pageName | string | Name of the page running the ad | | pageID | string | Facebook page ID | | adText | string | Primary text of the ad creative | | callToAction | string | CTA button text (Shop Now, Learn More, Sign Up, etc.) | | link | string | Landing page URL | | platforms | array | Where the ad runs: facebook, instagram, messenger, audience\_network | | spend | object | Spend range with lower\_bound/upper\_bound. See note below. | | impressions | object | Impression range with lower\_bound/upper\_bound. See note below. | | versions | integer | Number of creative variations | | mediaUrl | string | URL to the ad image or video thumbnail | ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | query | string | Yes | - | Keyword or advertiser name to search | | country | string | No | US | 2-letter country code, or ALL for global | | maxAds | integer | No | 50 | Max ads to return (up to 10,000) | ### Pricing Runs cost approximately **$0.70 per 1,000 ads** scraped based on typical Apify platform compute usage. Actual cost depends on your subscription plan. ### Frequently asked questions **Why are spend and impressions null?** Meta only discloses spend and impression data for ads about social issues, elections, or politics. For regular commercial ads (which is the vast majority), these fields will be null. This is a Meta policy, not a scraper limitation. **What countries are supported?** Every country available in the Meta Ad Library. Use standard ISO 3166-1 alpha-2 codes: US, GB, DE, FR, BR, MX, IN, JP, AU, etc. Set country to "ALL" to search globally across all regions. **Can I search for a specific advertiser?** Yes. Enter the exact page name as the query (e.g., "Nike" or "Coca-Cola"). The Ad Library matches against page names and ad content. **Does this need a Facebook account?** No. The Meta Ad Library is a public transparency tool. No login or authentication is needed on your end. **What about ads that have been taken down?** The Ad Library keeps records of inactive ads for up to 7 years (political/social issue ads) or 1 year (commercial ads). You will see both active and inactive ads in results. **How current is the data?** Ads appear in the library within 24 hours of going live. The scraper pulls directly from Meta's current database. # Actor input Schema ## `query` (type: `string`): Search keyword or advertiser name to look up in the Meta Ad Library. ## `country` (type: `string`): 2-letter ISO country code. Use 'ALL' to search globally. ## `maxAds` (type: `integer`): Maximum number of ads to scrape. Higher values take longer. ## Actor input object example ```json { "query": "nike", "country": "US", "maxAds": 50 } ``` # 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 = { "query": "nike" }; // Run the Actor and wait for it to finish const run = await client.actor("makework36/facebook-adlib-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 = { "query": "nike" } # Run the Actor and wait for it to finish run = client.actor("makework36/facebook-adlib-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 '{ "query": "nike" }' | apify call makework36/facebook-adlib-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=makework36/facebook-adlib-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Ad Library Scraper - Competitor Ad Intelligence", "description": "Scrape the Meta Ad Library for any keyword or advertiser across all countries. Returns ad creative text, call-to-action, landing page URL, platforms, spend ranges, impression estimates, and media URLs. Works for all active and inactive ads. No Facebook account required.", "version": "0.1", "x-build-id": "haneq4aa6ArUSSaVV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/makework36~facebook-adlib-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-makework36-facebook-adlib-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/makework36~facebook-adlib-scraper/runs": { "post": { "operationId": "runs-sync-makework36-facebook-adlib-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/makework36~facebook-adlib-scraper/run-sync": { "post": { "operationId": "run-sync-makework36-facebook-adlib-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": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "Search keyword or advertiser name to look up in the Meta Ad Library." }, "country": { "title": "Country code", "type": "string", "description": "2-letter ISO country code. Use 'ALL' to search globally.", "default": "US" }, "maxAds": { "title": "Max ads to return", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of ads to scrape. Higher values take longer.", "default": 50 } } }, "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 } } } } } } } } } } ```