{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Search Scraper with Comments & Date Range", "description": "Search and extract Facebook posts based on keywords, hashtags, or topics. Collect post content, timestamps, reactions, comments, and author details. Perfect for trend monitoring, audience insights, and social research with clean, structured data output.", "version": "0.1", "x-build-id": "vcA9jVK4Au3az4gPh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperforge~facebook-posts-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperforge-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/scraperforge~facebook-posts-search-scraper/runs": { "post": { "operationId": "runs-sync-scraperforge-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/scraperforge~facebook-posts-search-scraper/run-sync": { "post": { "operationId": "run-sync-scraperforge-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", "properties": { "searchQueries": { "title": "🔑 Search Keywords", "type": "array", "description": "Topics to search for on Facebook. Examples: football, cricket, tech news, recipes, travel. Each keyword runs as a separate search.", "default": [ "" ], "items": { "type": "string" } }, "maxPosts": { "title": "📊 Max Posts per Query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many posts to collect per keyword. Range: 1-5,000. Default: 10.", "default": 10 }, "postTimeRange": { "title": "⏱️ Quick Time Filter", "enum": [ "", "24h", "7d", "30d", "90d" ], "type": "string", "description": "Optional quick recency bucket. For a precise range use the Start/End Date fields below instead — when both are set, the narrower of the two applies.", "default": "" }, "fetchComments": { "title": "💬 Fetch Comments & Replies", "type": "boolean", "description": "When ON, each post's own permalink page is fetched to collect its real top-level comments plus the first page of replies per comment, pushed as separate child rows (type: \"comment\"/\"reply\", isChild: true).", "default": true }, "maxCommentsPerPost": { "title": "🔢 Max Comments per Post", "minimum": 0, "maximum": 200, "type": "integer", "description": "Caps how many top-level comments are collected per post (replies are the first page Facebook renders inline, per comment). 0 = unlimited. Only applies when Fetch Comments & Replies is ON.", "default": 20 }, "startDate": { "title": "📅 Start Date", "type": "string", "description": "Only include posts published on or after this date. Accepts an absolute date (e.g. 2026-07-01) or a relative value (e.g. \"7 days\"). Leave empty for no lower bound. Enforced on the real Output table, not just an in-memory count." }, "endDate": { "title": "📅 End Date", "type": "string", "description": "Only include posts published on or before this date (the whole day is included). Accepts an absolute date or a relative value (e.g. \"1 day\" = up to yesterday). Leave empty for no upper bound." }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Optional proxy settings for Facebook requests." } } }, "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 } } } } } } } } } }