{ "openapi": "3.0.1", "info": { "title": "Facebook Search Scraper - Public Posts by Keyword", "description": "Search public Facebook posts by keyword, without signing in. One row per post: text, author, group, link, exact time, photos and videos, and reaction, comment, share and view counts. One search ends after 65 to 100 posts; add dates to get hundreds more, or ask for recent posts or videos only.", "version": "0.1", "x-build-id": "mmfK6HKo7wY436ahR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~facebook-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-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/dami_studio~facebook-search-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-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/dami_studio~facebook-search-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-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": { "searchTerms": { "title": "Search terms", "maxItems": 100, "type": "array", "description": "Words or phrases to search Facebook's public posts for, one per line, in any language. Each term is a separate search. Up to 100 terms a run.", "items": { "type": "string" } }, "maxPostsPerSearch": { "title": "Posts per search term", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop a search term after this many posts. A plain search ends after about 65 to 100 posts, because that is as far as Facebook's results go for one search. Set a date window to go further: the window is searched a week or so at a time, and each slice brings its own posts.", "default": 50 }, "recentPosts": { "title": "Recent posts", "type": "boolean", "description": "Facebook's own Recent posts filter, checked: only posts from the last 7 days are kept. Facebook's recent results are mostly from the last day or two, but on some searches it mixes in older posts; those are left out and not charged. It can't be combined with a date window.", "default": false }, "startDate": { "title": "Posted from", "type": "string", "description": "Only posts from this day on, written as YYYY-MM-DD. Leave both dates empty for no date limit. Facebook applies dates loosely, so every post is checked and the ones outside your dates are left out and not charged. Dates are read in UTC." }, "endDate": { "title": "Posted until", "type": "string", "description": "Only posts up to and including this day, written as YYYY-MM-DD. With only \"Posted from\" set, the window runs up to today." }, "videosOnly": { "title": "Videos only", "type": "boolean", "description": "Only video posts, reels included. Without other filters it searches Facebook's video results; with dates or recent posts it keeps the video posts among the normal results, so fewer come back. Photos-only isn't offered: Facebook doesn't show photo results to people who aren't signed in.", "default": false }, "onlyPostsWithEveryWord": { "title": "Only posts that contain every word", "type": "boolean", "description": "On: a post is kept only when every word you searched appears in its text, its author's name or the name of the group it was posted in. Off: every post Facebook's search returns, marked with containsSearchWords. Either way, a search whose first results contain none of the words stops there with a free note instead of returning unrelated posts. Posts left out are never charged.", "default": 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 } } } } } } } } } }