{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Search Scraper: Engagement & Metadata Extraction", "description": "Facebook Posts Search Scraper: Find posts by keyword and extract captions, authors, timestamps, URLs, reactions, comments, shares, media, and metadata. Analyze engagement, content trends, audience interests, and competitor activity for social media research, marketing, and lead generation.", "version": "0.1", "x-build-id": "iXKBoySzOKjHp5mEx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~facebook-posts-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~facebook-posts-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-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/scrapier~facebook-posts-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-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": { "searchTerms": { "title": "šŸ”Ž Search Terms", "type": "array", "description": "ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”\nšŸ’” Topics/keywords to search for on Facebook.\n\nExamples: football ā€¢ cricket ā€¢ tech news ā€¢ recipes ā€¢ travel\n\nšŸŽÆ Each term = a separate search ā†’ more posts discovered.\n(Accepts legacy `searchQueries` input too.)", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "šŸ“Š Max Results per Term", "minimum": 1, "maximum": 5000, "type": "integer", "description": "ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”\nšŸ“ˆ How many posts to collect per search term?\n\nšŸŽšļø Range: 1 ā†’ 5,000\n(Accepts legacy `maxPosts` input too.)" }, "postAgeFilter": { "title": "ā±ļø Post Age Filter", "enum": [ "", "24h", "7d", "30d", "90d" ], "type": "string", "description": "ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”ā”\nšŸ“… Only keep posts published within this window (applied to the actual saved rows, not just a summary count).\n\nā³ All time (default) ā€¢ 24h ā€¢ 7d ā€¢ 30d ā€¢ 90d\n(Accepts legacy `postTimeRange` input too.)" }, "targetCountry": { "title": "šŸŒ Target Country", "enum": [ "", "us", "gb", "ca", "au", "in", "de", "fr", "es", "it", "br", "mx", "ng", "za", "ae", "sg", "ph", "id", "nl", "se" ], "type": "string", "description": "Bias the Google search toward a country's results (SERP `gl` param). Leave blank for the base default (no country bias).", "default": "" }, "targetLanguage": { "title": "šŸ—£ļø Target Language", "enum": [ "", "en", "es", "fr", "de", "pt", "ar", "hi", "id", "tl", "zh-CN", "ja", "ko", "ru", "it", "nl", "sv" ], "type": "string", "description": "Language for the Google search UI/results (SERP `hl` param). Leave blank to use the base default (English).", "default": "" }, "enableContactLookup": { "title": "šŸ“‡ Enable Page Contact Lookup", "type": "boolean", "description": "When ON, fetches each post's Facebook Page and extracts public email / phone / website / address from the page's own intro/contact card, attached as `contact` on the row. Off by default (base behavior ā€” no extra page fetches). Null fields mean genuinely not found, never fabricated.", "default": false }, "maxCommentsPerPost": { "title": "šŸ’¬ Max Comments per Post", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of top-level comments to fetch per post, saved to a separate `comments-` dataset (not charged). Set to 0 (default) to disable comment fetching entirely.", "default": 0 }, "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 } } } } } } } } } }