{ "openapi": "3.0.1", "info": { "title": "Facebook Ads Library Scraper", "description": "Scrape Facebook / Meta Ad Library for competitor ads. Search by keyword, Page URL, or pasted Ads Library URL. Extract creatives, copy, links, media, platforms & spend when available. No login or Meta API token. From $0.40 per 1,000 ads.", "version": "1.0", "x-build-id": "4v1BBfJYaZ8lyjkyp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/valev-lab~facebook-ads-library/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-valev-lab-facebook-ads-library", "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/valev-lab~facebook-ads-library/runs": { "post": { "operationId": "runs-sync-valev-lab-facebook-ads-library", "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/valev-lab~facebook-ads-library/run-sync": { "post": { "operationId": "run-sync-valev-lab-facebook-ads-library", "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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keyword searches to run against the Ad Library, e.g. \"shopify\". Matching is case-insensitive for deduplication; the first spelling is kept.", "items": { "type": "string" } }, "pageUrls": { "title": "Page URLs", "type": "array", "description": "Public Facebook page URLs, e.g. https://www.facebook.com/nike. Resolved to the page's numeric Ad Library ID by searching the Ad Library for the page's own handle text — this only finds a page that has Ad Library history discoverable under that handle within a bounded search. Pages that cannot be resolved fail with a clear error.", "items": { "type": "string" } }, "adsLibraryUrls": { "title": "Ad Library URLs", "type": "array", "description": "Full Ad Library results URLs pasted from a browser, e.g. https://www.facebook.com/ads/library/?active_status=active&country=US&q=nike. Only the country, active_status, media_type, ad_type, q, and view_all_page_id parameters are read; other parameters (language, platform, region, sort, and similar) are rejected rather than silently ignored. Single-ad URLs (?id=...) are not supported.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "Two-letter country code (e.g. US, GB, DE) or ALL.", "default": "US" }, "activeStatus": { "title": "Active status", "enum": [ "all", "active", "inactive" ], "type": "string", "description": "Whether to include active, inactive, or all ads.", "default": "all" }, "mediaType": { "title": "Media type", "enum": [ "all", "image_and_meme", "video" ], "type": "string", "description": "Restrict results to ads containing this media type.", "default": "all" }, "onlyAdsNewerThan": { "title": "Only ads newer than", "type": "string", "description": "Lower bound on ad activity: an ISO date (YYYY-MM-DD) or a relative duration such as \"30 days\", \"2 weeks\", or \"3 months\", resolved against the run's start time in UTC.", "default": "" }, "onlyAdsOlderThan": { "title": "Only ads older than", "type": "string", "description": "Upper bound on ad activity, in the same YYYY-MM-DD or relative-duration format as \"Only ads newer than\".", "default": "" }, "maxAds": { "title": "Maximum ads", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of unique, matching ads to deliver per target (keyword, page, or URL), after deduplication and date filtering. Ads beyond this limit, filtered out, or duplicated across targets are never charged.", "default": 100 } } }, "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 } } } } } } } } } }