{ "openapi": "3.0.1", "info": { "title": "facebook-posts-search", "description": "Search Facebook posts by keyword with recent-posts, location and date-range filters. Drop-in replacement for powerai/facebook-post-search-scraper (identical input and output schema).", "version": "0.0", "x-build-id": "GUPaxoCPskDKQmwwo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/outspoken_strategy~facebook-post-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-outspoken_strategy-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/outspoken_strategy~facebook-post-search-scraper/runs": { "post": { "operationId": "runs-sync-outspoken_strategy-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/outspoken_strategy~facebook-post-search-scraper/run-sync": { "post": { "operationId": "run-sync-outspoken_strategy-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": { "query": { "title": "Search Query (single keyword)", "type": "string", "description": "One keyword/phrase to search for. Wrap in double quotes for an exact phrase match, e.g. \"econet revenue\". You can also paste several keywords, one per line, to search them all. For a clean list use the \"queries\" field below instead. Leave empty if you use \"queries\"." }, "queries": { "title": "Search Queries (multiple keywords)", "type": "array", "description": "Multiple keywords/phrases to search — each is searched separately and results are combined and de-duplicated by post. Takes precedence over/adds to \"query\". Each item can be wrapped in double quotes for exact-phrase matching. maxResults applies PER keyword.", "items": { "type": "string" } }, "recent_posts": { "title": "Recent Posts Only", "type": "boolean", "description": "Whether to only search for recent posts." }, "location_uid": { "title": "Location UID", "type": "string", "description": "Location unique identifier for filtering posts." }, "start_date": { "title": "Start Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Start date for filtering posts (format: yyyy-mm-dd)." }, "end_date": { "title": "End Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "End date for filtering posts (format: yyyy-mm-dd)." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of posts to fetch.", "default": 10 }, "cookies": { "title": "Facebook session cookies", "type": "array", "description": "Cookies of a logged-in Facebook session, exported with a browser extension such as Cookie-Editor or EditThisCookie (JSON array of {name, value, domain, ...}). REQUIRED in practice: Facebook returns HTTP 400 for anonymous post search. Alternatively set the FB_COOKIES secret environment variable on the actor (same JSON, or a 'name=value; name2=value2' string) to avoid passing cookies in every run. Use a throwaway account, never your personal one." }, "fbEmail": { "title": "Facebook email (automated login)", "type": "string", "description": "Email/phone of a throwaway Facebook account. If set together with fbPassword (or via the FB_EMAIL/FB_PASSWORD secret env vars), the actor logs in itself and caches the session, so you don't need to paste cookies. The account must have 2FA disabled. Prefer setting these as secret environment variables on the actor rather than per run." }, "fbPassword": { "title": "Facebook password (automated login)", "type": "string", "description": "Password for the account in fbEmail. Stored encrypted. Prefer the FB_PASSWORD secret environment variable instead of putting it in run input." }, "proxySessionId": { "title": "Pinned proxy session id (keeps the session alive)", "type": "string", "description": "Set a stable id here (or via the FB_PROXY_SESSION env var) to keep the account on ONE exit IP across runs. Facebook invalidates sessions that appear to hop IPs/regions, so pinning the IP — together with this actor writing the refreshed cookies back after every run — is what stops the session expiring. Use one distinct id per Facebook account, e.g. \"acct1\". Leave empty to use a fresh random IP each run (not recommended when reusing a session)." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy to route traffic through. Residential proxies are strongly recommended for Facebook, with a country set — the random global residential pool often hands out dead exit IPs, so the actor defaults RESIDENTIAL to US exits when no country is chosen. For a non-expiring session, keep apifyProxyCountry fixed to the account's usual region.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "headless": { "title": "Run browser headless", "type": "boolean", "description": "Uncheck to run a headed browser (useful only for local debugging).", "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 } } }, "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 } } } } } } } } } }