{ "openapi": "3.0.1", "info": { "title": "Facebook Search Scraper", "description": "Search Facebook by keyword across Events, Marketplace, and the Ad Library (ads + advertisers) in one actor. Cookieless, no login. Provider-backed, MCP-ready.", "version": "1.0", "x-build-id": "pkdPXTTBLEIFfhyIe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~facebook-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-facebook-search-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/khadinakbar~facebook-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-facebook-search-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/khadinakbar~facebook-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-facebook-search-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", "required": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "The keyword to search Facebook for. Free text, e.g. 'coffee festival', 'Nike', or 'electric bike'. Applies to whichever surface you pick in searchType. This is NOT a Facebook URL — pass a plain keyword, not a page or profile link." }, "searchType": { "title": "Search type", "enum": [ "ads", "advertisers", "events", "marketplace" ], "type": "string", "description": "Which Facebook surface to search. 'ads' and 'advertisers' query the public Ad Library; 'events' finds public events; 'marketplace' finds for-sale listings (needs a location). Defaults to 'ads'. These are the only surfaces Facebook lets you keyword-search without logging in — public post/page/profile keyword search is login-gated and served by sibling actors.", "default": "ads" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of results to return and charge for. Ranges 1–500, defaults to 50. The actor paginates until it hits this cap or runs out of results. Keep it modest for quick, low-cost runs.", "default": 50 }, "location": { "title": "Marketplace location", "type": "string", "description": "City or place used to anchor Marketplace listings, e.g. 'Austin, TX' or 'London, UK'. Required only when searchType is 'marketplace'; ignored for every other search type. The actor resolves it to coordinates automatically. Leave empty unless searching Marketplace." }, "country": { "title": "Ad Library country", "type": "string", "description": "Two-letter ISO country code to scope Ad Library results, e.g. 'US', 'GB', or 'IN'. Used only when searchType is 'ads'; leave empty to search all countries. Does not affect events, advertisers, or marketplace. Example: 'US'." }, "adStatus": { "title": "Ad status", "enum": [ "ACTIVE", "INACTIVE", "ALL" ], "type": "string", "description": "Filter Ad Library ads by run status. 'ACTIVE' returns currently-running ads, 'INACTIVE' returns stopped ads, 'ALL' returns both. Defaults to 'ACTIVE'. Applies only to searchType 'ads'.", "default": "ACTIVE" }, "adType": { "title": "Ad type", "enum": [ "ALL", "POLITICAL_AND_ISSUE_ADS" ], "type": "string", "description": "Restrict Ad Library ads to all ads or only political/issue ads. 'ALL' returns every ad type; 'POLITICAL_AND_ISSUE_ADS' returns only regulated political ads. Defaults to 'ALL'. Applies only to searchType 'ads'.", "default": "ALL" }, "fallbackProvider": { "title": "Data provider", "enum": [ "auto", "scrapeCreators", "sociaVault" ], "type": "string", "description": "Which backend data provider to use. 'auto' tries ScrapeCreators first then SociaVault; the other options force one provider. Defaults to 'auto'. Events search only works via ScrapeCreators regardless of this setting.", "default": "auto" } } }, "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 } } } } } } } } } }