{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Search Scraper - Bulk Keywords", "description": "Search public Facebook posts by keyword or hashtag, with many queries per run, latest or top results, date filters and optional comments. No login or cookies.", "version": "1.0", "x-build-id": "6crh3AG3EHBDvWkuu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/icoe-man~facebook-posts-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-icoe-man-facebook-posts-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/icoe-man~facebook-posts-search-scraper/runs": { "post": { "operationId": "runs-sync-icoe-man-facebook-posts-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/icoe-man~facebook-posts-search-scraper/run-sync": { "post": { "operationId": "run-sync-icoe-man-facebook-posts-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": [ "queries" ], "properties": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords or phrases to search, one per line, up to 200 per run. Each query is searched separately and has a small fee. Facebook search does not support operators such as AND or OR.", "default": [ "NASA Artemis" ], "items": { "type": "string" } }, "searchType": { "title": "Search type", "enum": [ "latest", "top", "hashtag" ], "type": "string", "description": "Latest returns the newest matching posts, Top the most relevant ones, and Hashtag the posts with that hashtag (one word, with or without #).", "default": "latest" }, "maxPostsPerQuery": { "title": "Max posts per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many posts to collect for each query. Each post is billed, plus a small fee per query.", "default": 25 }, "onlyNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Skip posts published before this date. Use a date like 2026-01-31 or a relative value like \"7 days\". Relative values are rounded down to the start of that UTC day (hours to the start of the hour, minutes to the minute), so runs on the same day use the same window. Not available for hashtag searches." }, "onlyOlderThan": { "title": "Only posts older than", "type": "string", "description": "Skip posts published after this date, e.g. 2026-06-30 or \"1 month\". Relative values are rounded down to the start of that UTC day (hours to the start of the hour, minutes to the minute), so runs on the same day use the same window. Not available for hashtag searches." }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also collect the comments of every post found. Each comment is billed, plus a small fee per post whose comments we collect.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many comments (and replies, if enabled) to collect per post when Include comments is on. Up to 24 is fastest. Above 40, a query with many posts collects fewer posts, and the run summary says how many.", "default": 24 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also collect replies to comments when Include comments is on. Replies count toward the comment limit.", "default": false }, "maxDataAgeHours": { "title": "Reuse data collected within (hours)", "minimum": 0, "maximum": 720, "type": "integer", "description": "If we ran this search within this many hours, you get the posts instantly at the same price. Use 0 to always collect fresh data.", "default": 24 }, "cacheOnly": { "title": "Previously collected data only (instant)", "type": "boolean", "description": "Return only posts we already collected, without waiting for live collection. Useful for AI agents with short timeouts.", "default": false } } }, "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 } } } } } } } } } }