{ "openapi": "3.0.1", "info": { "title": "Meta Ad Library Scraper - Facebook & Instagram [NO COOKIES] ✅", "description": "See every creative variant your competitors are testing, not just one ad per campaign. Scrape the Meta Ad Library for Facebook and Instagram ads by keyword, brand or ad ID - copy, CTA, media, landing URL and video transcripts. No login, no cookies, no proxy to configure, nothing to get blocked.", "version": "0.0", "x-build-id": "eb6q3j7hBebYfdcxy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unseenuser~meta-ads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unseenuser-meta-ads", "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/unseenuser~meta-ads/runs": { "post": { "operationId": "runs-sync-unseenuser-meta-ads", "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/unseenuser~meta-ads/run-sync": { "post": { "operationId": "run-sync-unseenuser-meta-ads", "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": [ "searchMode", "searchTerms" ], "properties": { "searchMode": { "title": "What do you want to do?", "enum": [ "search_ads", "company_ads", "search_companies", "ad_details" ], "type": "string", "description": "Pick one. The box below changes meaning based on your choice.", "default": "search_ads" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "One per line. What to put here depends on the mode above:\n\n• **Find ads by keyword** - keywords, e.g. `running shoes`, `skincare`\n• **Get all ads from a brand / page** - brand names (e.g. `Nike`) or numeric Facebook page IDs (e.g. `15087023444`). Names are auto-resolved to IDs.\n• **Look up a brand's Facebook page ID** - brand names, e.g. `nike`, `lululemon`\n• **Get full details for a specific ad** - ad IDs (e.g. `702369045530963`) or full Meta Ad Library URLs", "items": { "type": "string" } }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nPick one or more countries. Leave on **All countries** for worldwide. If you select multiple, the actor runs the search once per country and merges results (ScrapeCreators accepts one country at a time).", "items": { "type": "string", "enum": [ "ALL", "US", "GB", "CA", "AU", "NZ", "IE", "DE", "FR", "ES", "IT", "NL", "BE", "CH", "AT", "PT", "DK", "SE", "NO", "FI", "IS", "PL", "CZ", "SK", "HU", "RO", "BG", "GR", "HR", "SI", "EE", "LV", "LT", "LU", "MT", "CY", "BR", "MX", "AR", "CL", "CO", "PE", "VE", "UY", "PY", "BO", "EC", "CR", "PA", "DO", "GT", "HN", "SV", "NI", "CU", "PR", "IN", "JP", "KR", "SG", "MY", "TH", "ID", "PH", "VN", "HK", "TW", "BD", "PK", "LK", "NP", "KH", "LA", "MM", "AE", "SA", "QA", "KW", "BH", "OM", "JO", "LB", "IL", "TR", "EG", "MA", "TN", "DZ", "LY", "SD", "ZA", "NG", "KE", "GH", "ET", "UG", "TZ", "CI", "CM", "SN", "MU", "RW", "ZM", "ZW", "AO", "MZ", "BW", "NA", "RU", "UA", "BY", "MD", "GE", "AM", "AZ", "KZ", "UZ", "KG", "TJ", "TM", "MN", "RS", "BA", "MK", "AL", "ME", "XK", "FJ", "PG", "NC", "SB", "VU", "WS", "TO" ], "enumTitles": [ "All countries", "United States", "United Kingdom", "Canada", "Australia", "New Zealand", "Ireland", "Germany", "France", "Spain", "Italy", "Netherlands", "Belgium", "Switzerland", "Austria", "Portugal", "Denmark", "Sweden", "Norway", "Finland", "Iceland", "Poland", "Czechia", "Slovakia", "Hungary", "Romania", "Bulgaria", "Greece", "Croatia", "Slovenia", "Estonia", "Latvia", "Lithuania", "Luxembourg", "Malta", "Cyprus", "Brazil", "Mexico", "Argentina", "Chile", "Colombia", "Peru", "Venezuela", "Uruguay", "Paraguay", "Bolivia", "Ecuador", "Costa Rica", "Panama", "Dominican Republic", "Guatemala", "Honduras", "El Salvador", "Nicaragua", "Cuba", "Puerto Rico", "India", "Japan", "South Korea", "Singapore", "Malaysia", "Thailand", "Indonesia", "Philippines", "Vietnam", "Hong Kong", "Taiwan", "Bangladesh", "Pakistan", "Sri Lanka", "Nepal", "Cambodia", "Laos", "Myanmar", "United Arab Emirates", "Saudi Arabia", "Qatar", "Kuwait", "Bahrain", "Oman", "Jordan", "Lebanon", "Israel", "Turkey", "Egypt", "Morocco", "Tunisia", "Algeria", "Libya", "Sudan", "South Africa", "Nigeria", "Kenya", "Ghana", "Ethiopia", "Uganda", "Tanzania", "Ivory Coast", "Cameroon", "Senegal", "Mauritius", "Rwanda", "Zambia", "Zimbabwe", "Angola", "Mozambique", "Botswana", "Namibia", "Russia", "Ukraine", "Belarus", "Moldova", "Georgia", "Armenia", "Azerbaijan", "Kazakhstan", "Uzbekistan", "Kyrgyzstan", "Tajikistan", "Turkmenistan", "Mongolia", "Serbia", "Bosnia & Herzegovina", "North Macedonia", "Albania", "Montenegro", "Kosovo", "Fiji", "Papua New Guinea", "New Caledonia", "Solomon Islands", "Vanuatu", "Samoa", "Tonga" ] }, "default": [ "ALL" ] }, "status": { "title": "Ad status", "enum": [ "ACTIVE", "INACTIVE", "ALL" ], "type": "string", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nOnly show ads that are currently running, or include paused/ended ads too.", "default": "ACTIVE" }, "startDate": { "title": "Start date", "type": "string", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nOnly include ads running on or after this date. Click to pick from a calendar." }, "endDate": { "title": "End date", "type": "string", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nOnly include ads running on or before this date. Click to pick from a calendar." }, "mediaType": { "title": "Media type", "enum": [ "ALL", "IMAGE", "VIDEO", "MEME", "IMAGE_AND_MEME", "NONE" ], "type": "string", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nFilter by creative format.", "default": "ALL" }, "searchType": { "title": "Keyword match", "enum": [ "keyword_unordered", "keyword_exact_phrase" ], "type": "string", "description": "_Applies to: Find ads by keyword._\n\nOnly used when finding ads by keyword.", "default": "keyword_unordered" }, "sortBy": { "title": "Sort by", "enum": [ "total_impressions", "relevancy_monthly_grouped" ], "type": "string", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nApplies to ad-returning modes.", "default": "total_impressions" }, "languages": { "title": "Languages", "uniqueItems": true, "type": "array", "description": "_Applies to: Get all ads from a brand / page._\n\nClick to pick one or more languages to filter ads by. Leave empty for no language filter. Multiple languages will fan out (one API call per language).", "items": { "type": "string", "enum": [ "EN", "ES", "FR", "DE", "IT", "PT", "NL", "PL", "RU", "UK", "TR", "AR", "HE", "FA", "ZH", "JA", "KO", "VI", "TH", "ID", "MS", "HI", "BN", "UR", "TA", "TE", "SV", "NO", "DA", "FI", "IS", "CS", "SK", "HU", "RO", "BG", "EL", "HR", "SR", "SL", "ET", "LV", "LT", "SW", "AM", "YO", "ZU", "AF", "CA", "EU", "GL", "GA", "CY" ], "enumTitles": [ "English", "Spanish", "French", "German", "Italian", "Portuguese", "Dutch", "Polish", "Russian", "Ukrainian", "Turkish", "Arabic", "Hebrew", "Persian", "Chinese", "Japanese", "Korean", "Vietnamese", "Thai", "Indonesian", "Malay", "Hindi", "Bengali", "Urdu", "Tamil", "Telugu", "Swedish", "Norwegian", "Danish", "Finnish", "Icelandic", "Czech", "Slovak", "Hungarian", "Romanian", "Bulgarian", "Greek", "Croatian", "Serbian", "Slovenian", "Estonian", "Latvian", "Lithuanian", "Swahili", "Amharic", "Yoruba", "Zulu", "Afrikaans", "Catalan", "Basque", "Galician", "Irish", "Welsh" ] }, "default": [] }, "adType": { "title": "Ad category", "enum": [ "all", "political_and_issue_ads" ], "type": "string", "description": "_Applies to: Find ads by keyword._\n\nRestrict to political / issue ads (they come with extra fields like spend and audience).", "default": "all" }, "maxItems": { "title": "Maximum ads to return (0 = all)", "minimum": 0, "type": "integer", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page, Look up a brand's page ID._\n\nTotal number of ads to collect across all search terms. `0` = return all ads found. When set, the budget is split evenly across your terms (e.g. 100 / 8 terms = 13 per term).", "default": 0 }, "maxItemsPerTerm": { "title": "Maximum ads per search term (0 = no limit)", "minimum": 0, "type": "integer", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nCap per individual search term. `0` = no per-term limit (auto-distributes the total budget evenly when a total limit is set).", "default": 0 }, "maxPagesPerQuery": { "title": "Max pages per term (0 = all pages)", "minimum": 0, "type": "integer", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nMaximum number of pagination pages to fetch per search term. `0` = fetch all available pages.", "default": 0 }, "enrichment": { "title": "Add creative analysis fields", "type": "boolean", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page, Get full details for a specific ad._\n\nAdds extra columns to every ad, built from data already in the response (no extra API calls, no slowdown worth noticing):\n\n• **creative.variants** - each alternative creative in a Dynamic Creative ad split out separately, with its own copy, button and destination\n• **creative.media** - all image and video URLs tidied into one list\n• **creative.partner** - the paid-partnership page, when there is one\n• **landing.domain** - where the ad sends people\n• **signals.days_running** - how long the ad has been live\n• **enrichment.language** - detected language of the ad copy\n\nLeave this off and the output is exactly what it has always been.", "default": false }, "longRunningDays": { "title": "Flag ads running longer than (days)", "minimum": 0, "type": "integer", "description": "Ads live for at least this many days get `signals.long_running: true`. Advertisers do not keep paying for creative that is not working, so a long-running ad is usually a proven winner.\n\n`30` is the usual rule of thumb. Raise it to surface only the strongest performers, lower it to catch newer winners. Only used when the checkbox above is on.", "default": 30 }, "advertiserProfiles": { "title": "Add one summary row per advertiser", "type": "boolean", "description": "Adds a single row for each advertiser found, summarising all of their ads together: how many they run, how many are still active, how long the longest-running one has been live, their page and Instagram follower counts, which platforms they use, and how many separate destinations they send traffic to. None of this is visible in an individual ad row.\n\nNeeds \"Add creative analysis fields\" switched on, because it is built from those fields. Charged as one advertiser summary each.", "default": false }, "landingPageReport": { "title": "Add one summary row per landing page", "type": "boolean", "description": "Adds a row for each distinct destination URL, showing how many separate ads point at it, which advertisers use it, its tracking parameters, and where it finally resolves to. Duplicate URLs are grouped, so a carousel whose cards all share one link counts as one destination rather than eight.\n\nNeeds \"Add creative analysis fields\" switched on. Not charged - it is the data your ad rows already contain, grouped by destination.", "default": false }, "separateTables": { "title": "Also write separate creative, landing page and advertiser tables", "type": "boolean", "description": "Writes three extra tables next to your main results, so each can be opened or downloaded on its own: one row per creative card, one row per distinct landing page, and one row per advertiser.\n\nUseful when you want the card-level creatives as a flat table - a carousel with eight cards becomes eight rows there, while your main results keep one row per ad.\n\nNot charged. It is the same data your ad rows already contain, arranged differently.\n\nThese tables are kept on your account until you delete them, under Storage > Datasets. A scheduled run leaves one set behind each time it runs. Needs \"Add creative analysis fields\" switched on.", "default": false }, "getTranscript": { "title": "Include video transcript", "type": "boolean", "description": "_Applies to: Get full details for a specific ad._\n\nWorks on videos under 2 minutes.", "default": false }, "trim": { "title": "Smaller response", "type": "boolean", "description": "Strip rarely-used fields from each ad for a lighter dataset.", "default": false }, "anthropicApiKey": { "title": "Your Anthropic API key", "type": "string", "description": "Required only if you turn on either AI option below. Get a key at https://console.anthropic.com, then paste it here.\n\nUsage is billed to **your** Anthropic account, not to this Actor. The field is stored encrypted and never appears in the run log or the output." }, "llmAnalysis": { "title": "Tag each ad with its persuasion angle (AI)", "type": "boolean", "description": "_Applies to: Find ads by keyword, Get all ads from a brand / page._\n\nReads each ad's copy and tags what it is doing to persuade you: `offer`, `social_proof`, `authority`, `fear`, `curiosity`, `urgency`, `problem_solution`, `testimonial`, `comparison`, `aspirational` or `educational`, plus an overall tone. Lands in `llm.primary_angle`, `llm.angles` and `llm.tone`.\n\nLets you ask things like \"show me every competitor ad leading with social proof\".\n\n**Needs your own Anthropic API key** in an `ANTHROPIC_API_KEY` environment variable, and you pay Anthropic directly for it. Costs scale with the number of ads. If a request fails the ad is still returned, just without tags.", "default": false }, "strategySummary": { "title": "Write a strategy summary per advertiser (AI)", "type": "boolean", "description": "_Applies to: Get all ads from a brand / page._\n\nAdds one extra row per advertiser summarising their overall approach: positioning, who they seem to target, and patterns in how they build and test creative.\n\nOnly runs when at least 10 ads were collected for that advertiser, since there is nothing useful to say about two ads. One API call per advertiser, so the cost scales with advertisers rather than with results.", "default": false }, "llmModel": { "title": "AI model", "enum": [ "claude-opus-5", "claude-sonnet-5", "claude-haiku-4-5" ], "type": "string", "description": "Which Claude model does the analysis.\n\nEstimated cost per 1,000 ads tagged, measured against a real 1,032-ad run:\n• **Opus 5** - highest quality, about **$0.27**\n• **Sonnet 5** - about **$0.11**\n• **Haiku 4.5** - fastest, about **$0.05**\n\nThese are low because the Actor only sends each distinct piece of ad copy to the model once. Advertisers reuse copy heavily across ad IDs, so in that sample 1,028 ads contained just 174 distinct blocks, cutting the cost by around 80%.\n\nBecause even the best model lands well under a cent per hundred ads, Opus 5 is the default. Drop to Haiku for very large runs where speed matters more than nuance.", "default": "claude-opus-5" } } }, "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 } } } } } } } } } }