{ "openapi": "3.0.1", "info": { "title": "Facebook Search Scraper — People, Pages, Posts & More", "description": "The most complete Facebook search: people, pages, places, events, posts, videos and top — in one actor, no login and no cookies. Get names, URLs, profile pictures, verified badges, event dates, and post text with authors. Auto-paginates across results. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "24dRfsBDD1WDE31Qq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~facebook-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~facebook-search-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~facebook-search-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": [ "searchQueries" ], "properties": { "searchType": { "title": "Search type", "enum": [ "top", "people", "pages", "places", "events", "posts", "videos" ], "type": "string", "description": "Which Facebook search tab to scrape.", "default": "people" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search for on Facebook.", "items": { "type": "string" } }, "location": { "title": "Location (city)", "type": "string", "description": "Optional. Scope the search to one city by name — e.g. \"Manchester, New Hampshire\", \"Manchester, NH\", \"London, UK\", \"Berlin, Germany\". The actor resolves it to Facebook's place UID at run start using Facebook's own place lookup, then applies the City filter; the log shows what it resolved to and the runner-up candidates. Include the state/country for common names (a bare \"London\" or \"Springfield\" is ambiguous and the first match wins). US state and Canadian province codes are understood. Supported on People, Pages, Places and Events; Facebook offers no city filter for Posts, Videos or Top, so those run unfiltered with a warning. If you already know the UID, use Location UID below instead — it takes precedence." }, "locationUid": { "title": "Location UID (advanced)", "type": "string", "description": "Optional override for Location: the Facebook place UID itself — e.g. 106078429431815 for London, 110774245616525 for Paris. You can also paste the full facebook.com/places// URL, or a Facebook search URL that already has a city filter applied. When set, the Location field is ignored. The UID must be a real place: any other page id returns zero results instead of an error." }, "onlyPostsNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Start of the date window, e.g. 2026-01-01. Posts tab only. Facebook's own date filter is month-granular at the edges, so results are trimmed to your exact dates before anything is pushed or charged." }, "recentPosts": { "title": "Recent posts", "type": "boolean", "description": "Posts tab only. Ask Facebook to sort by recent posts instead of its default ranking. On people, pages, places, events, videos or top it is ignored.", "default": false }, "onlyPostsOlderThan": { "title": "Only posts older than", "type": "string", "description": "End of the date window, e.g. 2026-03-31 (that whole day is included). Posts tab only." }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum total results across all queries.", "default": 100 }, "pageDelayMs": { "title": "Delay between pages (ms)", "minimum": 0, "type": "integer", "description": "Polite delay between paginated calls to avoid rate limits.", "default": 800 }, "proxy": { "title": "Proxy", "type": "object", "description": "Datacenter (default) works well and is fast. If you hit rate limits at high volume, switch to RESIDENTIAL.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }