
Facebook Ads Scraper Pro - Free to Use
Pricing
Pay per usage

Facebook Ads Scraper Pro - Free to Use
Extract comprehensive Facebook Ad Library data including creative content, targeting info, performance metrics, and media downloads. FREE to use! Perfect for competitive analysis, market research, and advertising intelligence across all Meta platforms (Facebook, Instagram, WhatsApp, Messenger).
5.0 (8)
Pricing
Pay per usage
8
17
17
Issues response
3 hours
Last modified
4 days ago
You can access the Facebook Ads Scraper Pro - Free to Use programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, youโll need an Apify account and your API token, found in Integrations settings in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "bTaWrWyXvY54clHWy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dz_omar~facebook-ads-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dz_omar-facebook-ads-scraper-pro", "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/dz_omar~facebook-ads-scraper-pro/runs": { "post": { "operationId": "runs-sync-dz_omar-facebook-ads-scraper-pro", "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/dz_omar~facebook-ads-scraper-pro/run-sync": { "post": { "operationId": "run-sync-dz_omar-facebook-ads-scraper-pro", "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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "๐ Search Keywords", "type": "array", "description": "**Search terms to find Facebook ads** ๐ฏ\n\nEnter keywords, phrases, or brand names to search for in Facebook's Ad Library:\n\n**Examples:**\n- Brand names: \"Nike\", \"Apple\", \"Coca-Cola\"\n- Product categories: \"fitness app\", \"crypto wallet\", \"online course\"\n- Industry terms: \"digital marketing\", \"e-commerce\", \"SaaS\"\n- Campaign themes: \"Black Friday\", \"back to school\", \"summer sale\"\n\n**๐ก Tips:**\n- Use specific terms for better results\n- Mix broad and specific keywords\n- Each query runs separately and results are combined\n- Empty queries will be skipped", "default": [ "digital marketing" ], "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "๐ Max Results Per Search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "**Maximum ads to collect per search term** ๐\n\n- **Default: 100** - Good balance of data and speed\n- **Range: 1-1000** - Higher numbers take longer\n- **Performance:** 50-200 recommended for most use cases\n\n**๐ก Note:** Actual results may be lower if Facebook has fewer matching ads.", "default": 10 }, "countries": { "title": "๐ Target Countries", "enum": [ "ALL", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VI", "WF", "EH", "YE", "ZM", "ZW", "AF" ], "type": "string", "description": "**Filter ads by country targeting** ๐บ๏ธ\n\n**Popular Options:**\n- **US** - United States (largest ad market)\n- **CA** - Canada\n- **GB** - United Kingdom\n- **AU** - Australia\n- **DE** - Germany\n- **FR** - France\n- **ES** - Spain\n- **IT** - Italy\n- **BR** - Brazil\n- **IN** - India\n- **JP** - Japan\n\n**๐ก Use ISO 2-letter country codes** (e.g., US, CA, GB)" }, "contentLanguages": { "title": "๐ฃ๏ธ Content Languages", "type": "array", "description": "**Filter ads by content language** ๐ค\n\n**Common Languages:**\n- **en** - English\n- **es** - Spanish\n- **fr** - French\n- **de** - German\n- **it** - Italian\n- **pt** - Portuguese\n- **ja** - Japanese\n- **ko** - Korean\n- **zh** - Chinese\n- **ar** - Arabic\n\n**๐ก Use ISO 2-letter language codes**", "items": { "type": "string", "enum": [ "", "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh", "ar", "ru", "hi", "tr", "pl", "nl", "sv", "da", "no", "fi", "el", "he", "th", "vi", "id", "ms", "tl", "uk", "cs", "sk", "hu", "ro", "bg", "hr", "sr", "sl", "et", "lv", "lt", "mt", "ga", "cy", "is", "fo", "lb", "rm", "eu", "ca", "gl", "oc", "br", "kw", "gd", "gv", "nn", "se", "be", "mk", "sq", "bs", "me", "xk", "sm", "ad", "li", "mc", "va" ], "enumTitles": [ "All languages ๐", "English ๐บ๐ธ", "Spanish ๐ช๐ธ", "French ๐ซ๐ท", "German ๐ฉ๐ช", "Italian ๐ฎ๐น", "Portuguese ๐ต๐น", "Japanese ๐ฏ๐ต", "Korean ๐ฐ๐ท", "Chinese ๐จ๐ณ", "Arabic ๐ธ๐ฆ", "Russian ๐ท๐บ", "Hindi ๐ฎ๐ณ", "Turkish ๐น๐ท", "Polish ๐ต๐ฑ", "Dutch ๐ณ๐ฑ", "Swedish ๐ธ๐ช", "Danish ๐ฉ๐ฐ", "Norwegian ๐ณ๐ด", "Finnish ๐ซ๐ฎ", "Greek ๐ฌ๐ท", "Hebrew ๐ฎ๐ฑ", "Thai ๐น๐ญ", "Vietnamese ๐ป๐ณ", "Indonesian ๐ฎ๐ฉ", "Malay ๐ฒ๐พ", "Filipino ๐ต๐ญ", "Ukrainian ๐บ๐ฆ", "Czech ๐จ๐ฟ", "Slovak ๐ธ๐ฐ", "Hungarian ๐ญ๐บ", "Romanian ๐ท๐ด", "Bulgarian ๐ง๐ฌ", "Croatian ๐ญ๐ท", "Serbian ๐ท๐ธ", "Slovenian ๐ธ๐ฎ", "Estonian ๐ช๐ช", "Latvian ๐ฑ๐ป", "Lithuanian ๐ฑ๐น", "Maltese ๐ฒ๐น", "Irish ๐ฎ๐ช", "Welsh ๐ด", "Icelandic ๐ฎ๐ธ", "Faroese ๐ซ๐ด", "Luxembourgish ๐ฑ๐บ", "Romansh ๐จ๐ญ", "Basque ๐ด", "Catalan ๐ด", "Galician ๐ด", "Occitan ๐ซ๐ท", "Breton ๐ซ๐ท", "Cornish ๐ด", "Scottish Gaelic ๐ด", "Manx ๐ฎ๐ฒ", "Norwegian Nynorsk ๐ณ๐ด", "Northern Sami ๐ณ๐ด", "Belarusian ๐ง๐พ", "Macedonian ๐ฒ๐ฐ", "Albanian ๐ฆ๐ฑ", "Bosnian ๐ง๐ฆ", "Montenegrin ๐ฒ๐ช", "Kosovo ๐ฝ๐ฐ", "San Marino ๐ธ๐ฒ", "Andorran ๐ฆ๐ฉ", "Liechtenstein ๐ฑ๐ฎ", "Monaco ๐ฒ๐จ", "Vatican ๐ป๐ฆ" ] } }, "publisherPlatforms": { "title": "๐ฑ Publisher Platforms", "type": "array", "description": "**Select which platforms to search for ads** ๐ฏ\n\n**Available Platforms:**\n- **Facebook** - Main Facebook feed ads\n- **Instagram** - Instagram feed and story ads\n- **Audience Network** - Third-party apps and websites\n- **Messenger** - Facebook Messenger ads\n- **WhatsApp** - WhatsApp Business ads\n- **Threads** - Threads social platform ads\n\n**๐ก Tips:**\n- Leave empty to search all platforms\n- Select multiple platforms for broader coverage\n- Instagram and Facebook are the most common", "items": { "type": "string", "enum": [ "FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK", "MESSENGER", "WHATSAPP", "THREADS" ], "enumTitles": [ "๐ Facebook", "๐ท Instagram", "๐ Audience Network", "๐ฌ Messenger", "๐ WhatsApp", "๐งต Threads" ] } }, "activeStatus": { "title": "๐ Ad Status Filter", "enum": [ "ALL", "ACTIVE", "INACTIVE" ], "type": "string", "description": "**Filter by ad activity status** ๐\n\n- **All**: Both active and inactive ads (recommended)\n- **Active**: Only currently running ads\n- **Inactive**: Only stopped/ended ads\n\n**๐ก 'All' gives the most comprehensive data**", "default": "ALL" }, "adType": { "title": "๐ Ad Category Filter", "enum": [ "ALL", "POLITICAL_AND_ISSUE_ADS", "HOUSING_ADS", "EMPLOYMENT_ADS", "CREDIT_ADS" ], "type": "string", "description": "**Filter by Facebook ad category** ๐ฏ\n\n- **All ads**: Every type of advertisement (recommended)\n- **Politics**: Political and issue-based ads\n- **Housing**: Real estate and housing ads\n- **Employment**: Job and employment ads\n- **Financial**: Credit and financial service ads\n\n**๐ก Different categories may have different data availability**", "default": "ALL" }, "mediaType": { "title": "๐จ Media Type Filter", "enum": [ "ALL", "IMAGE", "MEME", "IMAGE_AND_MEME", "VIDEO", "NONE" ], "type": "string", "description": "**Filter by ad media content** ๐ฑ\n\n- **All**: Every ad type (recommended)\n- **Video**: Only video ads\n- **Image**: Only image ads\n- **Meme**: Images with text, e.g., 'marketing'\n- **Image & Meme**: Both image types\n- **None**: Text-only ads (no image or video)\n\n**๐ก Video ads often have higher engagement data**", "default": "IMAGE" }, "startDate": { "title": "๐
From Date", "type": "string", "description": "**Earliest date to search for ads** ๐\n\nSelect the earliest publication date for ads in your search results.", "default": "2018-07-27" }, "endDate": { "title": "๐
To Date", "type": "string", "description": "**Latest date to search for ads** ๐\n\nSelect the latest publication date. Leave empty to include all ads up to today.", "default": "2025-07-27" } } }, "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 } } } } } } } } }}
Facebook Ads Scraper Pro - Ad Library Data & Media Extractor OpenAPI definition
OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Facebook Ads Scraper Pro - Free to Use from the options below:
If youโd like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: