{ "openapi": "3.0.1", "info": { "title": "Facebook & Instagram Ads: Active Advertiser Leads", "description": "Find businesses actively running Facebook & Instagram ads, with emails, phones, websites, ad and video activity, lead scores, and the option to get only what's new each run.", "version": "1.0", "x-build-id": "tAG62CLsfGvTfdo7p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leafy-dev-jr~active-advertiser-leads-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leafy-dev-jr-active-advertiser-leads-finder", "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/leafy-dev-jr~active-advertiser-leads-finder/runs": { "post": { "operationId": "runs-sync-leafy-dev-jr-active-advertiser-leads-finder", "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/leafy-dev-jr~active-advertiser-leads-finder/run-sync": { "post": { "operationId": "run-sync-leafy-dev-jr-active-advertiser-leads-finder", "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", "country" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords/phrases to search for in the Meta Ad Library. Use several close variations (e.g. \"skincare\", \"skin care\", \"serum\") to widen coverage of a niche. Results are deduplicated by advertiser across all queries.", "default": [ "skincare" ], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "AF", "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", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "LC", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "VI", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Country to search the Meta Ad Library in. Matches the country selector on the public Ad Library site.", "default": "US" }, "maxAds": { "title": "Max ads to scan (budget)", "minimum": 1, "type": "integer", "description": "How many ads the run may scan in total, across all your search queries. This is the cost and runtime ceiling, and it is what actually limits how many leads you get: most advertisers surface only one or two ads in a shallow scan and so fall below \"Minimum active ads\". Budget about 12x your lead target - 25 leads needs ~300 ads, 100 leads needs ~1200. Roughly one minute of scanning per 300 ads.", "default": 300 }, "maxAdvertisers": { "title": "How many leads you want", "minimum": 1, "type": "integer", "description": "Your target number of qualified advertisers. The run stops once it reaches this, so pair it with maxAds below: budget roughly 12 ads scanned per lead you want. The run log reports the exact rate for your niche at the end.", "default": 25 }, "minActiveAds": { "title": "Minimum active ads per advertiser", "minimum": 1, "type": "integer", "description": "Only advertisers with at least this many active ads found during the scan are kept as leads. Raise it to focus on heavier advertisers. Note this counts ads surfaced by your search queries, not the advertiser’s full Ad Library total.", "default": 3 }, "minAdsStartedLast30Days": { "title": "Minimum new ads in the last 30 days", "minimum": 0, "type": "integer", "description": "Only keep advertisers that launched at least this many new ads in the last 30 days. The strongest timeliness filter: it targets accounts someone is actively working right now. Applied before any website is visited, so it also cuts run cost.", "default": 0 }, "minVideoAds": { "title": "Minimum active video ads", "minimum": 0, "type": "integer", "description": "Only keep advertisers running at least this many active video ads (including video inside carousel and catalog formats). The qualifier for UGC, video-editing and creative pitches: it targets businesses already buying video. Applied before any website is visited.", "default": 0 }, "requireEmail": { "title": "Only return leads with an email", "type": "boolean", "description": "Drop advertisers where no public email was found. This can only be checked after a website has been crawled, so it trims the results rather than making the run cheaper. Requires contact enrichment to be enabled.", "default": false }, "excludeDomains": { "title": "Exclude domains", "type": "array", "description": "Domains to skip, e.g. existing customers or advertisers you have already contacted. Enter bare domains (example.com); subdomains and www are matched automatically. Excluded advertisers are dropped before their website is crawled.", "default": [], "items": { "type": "string" } }, "historyMode": { "title": "Recurring runs / history", "enum": [ "TRACK", "ONLY_NEW", "OFF" ], "type": "string", "description": "Remembers which advertisers previous runs already delivered, so a scheduled run can surface what is new instead of the same list every time. History is stored in your own account and is never shared. TRACK labels each advertiser NEW or RETURNING and returns everything. ONLY NEW returns just the advertisers no previous run delivered — ideal for a weekly schedule. OFF disables it entirely.", "default": "TRACK" }, "includeContactEnrichment": { "title": "Enrich with website contact info", "type": "boolean", "description": "If enabled, the Actor crawls each qualified advertiser's own website (homepage, /contact, /about, /team, etc.) to find public emails, phone numbers and social links. Disable to run faster and cheaper (Meta data only).", "default": true }, "maxWebsitePagesPerLead": { "title": "Max website pages per lead", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of pages crawled on an advertiser's website during contact enrichment (homepage + contact/about/team pages).", "default": 4 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }