{ "openapi": "3.0.1", "info": { "title": "Facebook Meta Ads Library Scraper", "description": "Scrape Meta & Facebook Ad Library for competitor ad intelligence. Search by keyword, Page URL, or library link with country, status, and media filters. Extract full ad copy, creatives, links, platforms, and spend. 100% automated with no login or Meta API token needed.", "version": "0.1", "x-build-id": "dVoqEEbdLKjcd4Y35" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/karamelo~facebook-ads-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-karamelo-facebook-ads-library-scraper", "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/karamelo~facebook-ads-library-scraper/runs": { "post": { "operationId": "runs-sync-karamelo-facebook-ads-library-scraper", "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/karamelo~facebook-ads-library-scraper/run-sync": { "post": { "operationId": "run-sync-karamelo-facebook-ads-library-scraper", "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 keywords", "maxItems": 20, "type": "array", "description": "Enter keywords to search for in the Ad Library (e.g. \"shopify\", \"running shoes\"). Each keyword runs a separate search. Safety cap: up to 20 total search/page/Ads Library URL tasks per run.", "items": { "type": "string" } }, "pageUrls": { "title": "Advertiser page URLs", "maxItems": 20, "type": "array", "description": "Enter Facebook Page URLs to scrape ads from specific advertisers (e.g. \"https://www.facebook.com/shopify\"). Safety cap: up to 20 total search/page/Ads Library URL tasks per run.", "items": { "type": "string" } }, "adsLibraryUrls": { "title": "Ads Library result URLs", "maxItems": 20, "type": "array", "description": "Paste Facebook Ads Library results URLs copied from facebook.com/ads/library/. Embedded URL filters are used for this input. Safety cap: up to 20 total search/page/Ads Library URL tasks per run.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "string", "description": "ISO country code to search in (e.g. \"US\", \"GB\", \"DE\"). Use \"ALL\" for all countries.", "default": "US" }, "activeStatus": { "title": "Status filter", "enum": [ "all", "active", "inactive" ], "type": "string", "description": "Filter by ad status.", "default": "all" }, "mediaType": { "title": "Media type", "enum": [ "all", "image_and_meme", "video" ], "type": "string", "description": "Filter by ad media type.", "default": "all" }, "onlyAdsNewerThan": { "title": "Active on or after", "type": "string", "description": "Optional inclusive lower bound for the ad activity interval. Use YYYY-MM-DD or a positive relative duration such as \"30 days\". An ad matches when its start/end activity interval overlaps the requested date window.", "default": "" }, "onlyAdsOlderThan": { "title": "Active on or before", "type": "string", "description": "Optional inclusive upper bound for the ad activity interval. Use YYYY-MM-DD or a positive relative duration such as \"90 days\". Active ads with no end date are handled as still active.", "default": "" }, "maxAds": { "title": "Max ads", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of ads to extract per search query, page URL, or Ads Library URL. Safety cap: 500 per search/page task.", "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 } } } } } } } } } }