{ "openapi": "3.0.1", "info": { "title": "Facebook Ad Library Scraper - Meta Ads Monitor", "description": "Scrape active ads from the Meta (Facebook) Ad Library by advertiser or keyword. Export ad copy, creative URLs and destinations, and track creative changes across runs to monitor competitor ads. No Facebook login required.", "version": "0.0", "x-build-id": "6tLHs3UiwGtW9jhLj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leadproof~facebook-ads-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leadproof-facebook-ads-monitor", "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/leadproof~facebook-ads-monitor/runs": { "post": { "operationId": "runs-sync-leadproof-facebook-ads-monitor", "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/leadproof~facebook-ads-monitor/run-sync": { "post": { "operationId": "run-sync-leadproof-facebook-ads-monitor", "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": { "pageIds": { "title": "Advertiser Page IDs", "type": "array", "description": "Numeric view_all_page_id values from Meta Ad Library URLs. Exact advertiser filtering.", "items": { "type": "string" } }, "keywords": { "title": "Search keywords", "type": "array", "description": "Optional keyword searches. Results follow Meta's matching; keyword text is not guaranteed to occur in every ad.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Uppercase two-letter country code, or ALL.", "default": "US" }, "maxAdsPerTarget": { "title": "Maximum ads per target", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum unique ads returned for each Page ID or keyword. Reaching this cap means coverage is partial.", "default": 25 }, "maxRunSeconds": { "title": "Collection time budget", "minimum": 30, "maximum": 1800, "type": "integer", "description": "Collection time budget. Allow additional time for storage and shutdown. Set Maximum charge per run separately to bound spending.", "default": 240 }, "maxTargetSeconds": { "title": "Seconds per target", "minimum": 10, "maximum": 900, "type": "integer", "description": "Maximum collection time allocated to each advertiser or keyword. Default 60 seconds; large targets can explicitly request up to 900 seconds within the run budget.", "default": 60 }, "maxScrolls": { "title": "Maximum scrolls per target", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximum pagination scroll attempts for each target.", "default": 30 }, "monitorKey": { "title": "Monitor name (optional)", "type": "string", "description": "Reuse the same name for scheduled runs. Different clients should use different names. Omit for one-off collection. 1-64 letters, digits, - or _. Concurrent runs with this name are rejected." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Defaults to Apify residential proxy in the selected country (US for ALL), included in the pay-per-event price. External proxy services you supply can bill you separately." } } }, "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 } } } } } } } } } }