{ "openapi": "3.0.1", "info": { "title": "Facebook Search Scraper - Posts, Pages & People", "description": "Search Facebook without logging in: posts, Pages, people, places and videos by keyword, hashtag or search link. Posts with text, author, date, reactions by type, comments, shares, photos and group. Date ranges search month by month for far more posts. Pay per result.", "version": "0.1", "x-build-id": "P5pxZTiHgY5GzQHdf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~facebook-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-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/eiv~facebook-search-scraper/runs": { "post": { "operationId": "runs-sync-eiv-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/eiv~facebook-search-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-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", "properties": { "searchQueries": { "title": "Search terms", "type": "array", "description": "What to search Facebook for, one per line: words (coffee shop), hashtags (#icedcoffee), brand or person names, or Facebook search links (facebook.com/search/posts/?q=coffee, with their filters) and hashtag links (facebook.com/hashtag/coffee). Each line is one search.", "items": { "type": "string" } }, "searchType": { "title": "Search for", "enum": [ "posts", "pages", "people", "places", "videos" ], "type": "string", "description": "Which Facebook search tab to read. Posts: public posts with text, author, date, reactions, comments, shares and media. Pages: business and public Pages. People: public profiles. Places: Pages of local places. Videos: videos and reels with views and duration. A Facebook search link uses its own tab.", "default": "posts" }, "sortBy": { "title": "Posts: order", "enum": [ "top", "recent" ], "type": "string", "description": "Top: Facebook's most relevant posts (the default search, mostly from the last few months). Recent: the newest posts first, from the last few days. Posts searches only.", "default": "top" }, "postsNewerThan": { "title": "Posts: posted after", "type": "string", "description": "Only posts published on or after this date (2025-01-31) or within a period (7 days, 3 months). With a date range the search goes month by month through Facebook's own date filter, which finds far more posts than one search. Posts and videos only; leave empty for no limit." }, "postsOlderThan": { "title": "Posts: posted before", "type": "string", "description": "Only posts published on or before this date (2025-12-31) or before a period (1 month). Posts and videos only; leave empty for no limit." }, "location": { "title": "Location", "type": "string", "description": "A city, region or country added to every search term (coffee + London searches \"coffee London\"), the way you would type it into Facebook. Best for Pages, Places and People searches. Leave empty to search everywhere." }, "startUrls": { "title": "Search links (for chaining Actors)", "type": "array", "description": "Facebook search or hashtag links in the URL-list shape other Actors output, so a previous Actor's results can be fed straight in. Use this or the field above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResultsPerQuery": { "title": "Max results per search", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop each search after this many results. Facebook shows logged-out visitors about 60-90 top posts per search (more with a date range or Recent), and hundreds of Pages, people, places and videos.", "default": 50 }, "maxItems": { "title": "Max results in total", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop the run after this many results across all searches. You pay per result, so this is also your cost cap for the run.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Searches always go through Apify's datacenter proxy, which is included in every plan: Facebook refuses searches from Apify's own servers. Facebook allows about 15-20 searches per IP address before pausing it, so a run's reach grows with your plan's datacenter IPs. A residential proxy chosen here is used only while all datacenter IPs are paused.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at the same time.", "default": 3 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 10, "maximum": 120, "type": "integer", "description": "How long to wait for one Facebook answer before trying another address.", "default": 45 }, "maxRetries": { "title": "Retries per request", "minimum": 0, "maximum": 3, "type": "integer", "description": "Retries for failed connections on runs without a proxy (local runs). Refused searches always move to another address.", "default": 1 } } }, "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 } } } } } } } } } }