{ "openapi": "3.0.1", "info": { "title": "Facebook Profile Posts Scraper", "description": "Paste a Facebook page or profile URL and get that account's posts for any period. Date filtering, multi-profile input, auto-pagination, self-renewing login session. Returns text, author, timestamp, reactions, comments, shares and media.", "version": "0.0", "x-build-id": "8bOCNxbzi86ggexbI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/outspoken_strategy~facebook-profile-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-outspoken_strategy-facebook-profile-posts-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-profile-posts-scraper/runs": { "post": { "operationId": "runs-sync-outspoken_strategy-facebook-profile-posts-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-profile-posts-scraper/run-sync": { "post": { "operationId": "run-sync-outspoken_strategy-facebook-profile-posts-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": { "profileUrl": { "title": "Profile/Page URL (single)", "type": "string", "description": "The Facebook page or profile to scrape, e.g. https://www.facebook.com/nasa. Also accepted: profile.php?id=... URLs, /people/ URLs, a bare vanity name or a bare numeric id. Any post URL on the page resolves to its owner. You can paste several profiles, one per line. For a clean list use \"profileUrls\" below instead." }, "profileUrls": { "title": "Profile URLs (multiple)", "type": "array", "description": "Several profiles/pages to scrape — each is scraped separately and the results are combined. \"Number of posts\" applies PER profile.", "items": { "type": "string" } }, "numberOfPosts": { "title": "Number of posts", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of posts to return per profile (after date filtering).", "default": 25 }, "scrapeAll": { "title": "Scrape all (auto-paginate)", "type": "boolean", "description": "Keep scrolling until the target count is reached, the date range is passed, or the feed runs dry. When unchecked only the posts on the initial page load are returned.", "default": true }, "timeSince": { "title": "From date (since)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only return posts published on or after this date (format: yyyy-mm-dd). Inclusive." }, "timeUntil": { "title": "To date (until)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only return posts published on or before this date (format: yyyy-mm-dd). Inclusive." }, "cookies": { "title": "Facebook session cookies", "type": "array", "description": "Cookies of a logged-in Facebook session, exported with a browser extension such as Cookie-Editor (JSON array of {name, value, domain, ...}). The \"c_user\" and \"xs\" cookies carry the session. Alternatively set the FB_COOKIES secret environment variable on the actor. Use a throwaway account, never your personal one." }, "fbEmail": { "title": "Facebook email (automated login)", "type": "string", "description": "Email 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 keeps the session alive across runs. The account must have 2FA disabled." }, "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", "type": "string", "description": "A stable Apify proxy session id that keeps the account on ONE exit IP across runs — Facebook invalidates sessions that appear to hop IPs. Set it per account (or via the FB_PROXY_SESSION env var) and use the same value as your other Facebook actors running this account." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy to route traffic through. Residential proxies with a country set are strongly recommended — Facebook blocks datacenter IPs.", "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 } } } } } } } } } }