{ "openapi": "3.0.1", "info": { "title": "Facebook Post Search Scraper: Keyword and Hashtag Posts", "description": "Search public Facebook posts by keyword or hashtag: post text, author page, date, reactions by type, comment count, share count, media and URL. Top or latest posts, date range and location filters. No login, no cookies. One row per post.", "version": "0.1", "x-build-id": "ogJma0kNoDSX2OfVp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~facebook-post-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-facebook-post-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/themineworks~facebook-post-search-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-facebook-post-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/themineworks~facebook-post-search-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-facebook-post-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": { "keywords": { "title": "Keywords or hashtags", "type": "array", "description": "What to search for, one per line, for example electric cars or #electricvehicles. A pasted Facebook search or hashtag link works too. Up to 200 per run; a post found by two keywords is delivered and charged once.", "items": { "type": "string" } }, "query": { "title": "One keyword (for pipelines)", "type": "string", "description": "Same as a single entry in Keywords. Handy when you call the actor once per record from Clay, n8n or an AI agent." }, "maxPostsPerKeyword": { "title": "Max posts per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many posts for each keyword. Facebook ends a logged out search list on its own, usually at 50 to 200 posts for a keyword. Use related keywords to go further.", "default": 50 }, "sortBy": { "title": "Order", "enum": [ "top", "latest" ], "type": "string", "description": "top is Facebook's default order. latest asks Facebook for recent posts first, which is the one to use for monitoring on a schedule. It returns a shorter list.", "default": "top" }, "startDate": { "title": "Posted on or after", "type": "string", "description": "Only posts from this date on, as YYYY-MM-DD. Sent to Facebook, and any post outside the range that it returns anyway is dropped for free." }, "endDate": { "title": "Posted on or before", "type": "string", "description": "Only posts up to and including this date, as YYYY-MM-DD." }, "location": { "title": "Location", "type": "string", "description": "A city name such as London or Hyderabad, or a numeric Facebook place id. Facebook uses this to favour posts tagged there; it is a preference, not a strict filter, so check place_name on each row if you need it strict. The city used is named in the run summary." }, "onlyPostsContainingKeyword": { "title": "Only posts that contain the keyword", "type": "boolean", "description": "Facebook's search also returns related posts that do not contain your words. Turn this on to drop those for free and keep only posts whose text has the exact phrase. Good for brand monitoring. Costs no extra per post, but the run reads more pages to reach your limit.", "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 } } } } } } } } } }