{ "openapi": "3.0.1", "info": { "title": "Facebook Pages & Posts Scraper", "description": "Extract public Facebook pages and posts with profiles, followers, business contacts, media, reactions and comment/share counts. Batch up to 25 pages, export JSON/CSV/Excel, or collect page details only. No login required.", "version": "0.1", "x-build-id": "SzFm9PbALBUv0TE4d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/newbs~Facebook-Channel/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-newbs-Facebook-Channel", "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/newbs~Facebook-Channel/runs": { "post": { "operationId": "runs-sync-newbs-Facebook-Channel", "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/newbs~Facebook-Channel/run-sync": { "post": { "operationId": "run-sync-newbs-Facebook-Channel", "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": { "socialName": { "title": "Facebook page handle or URL", "type": "string", "description": "One public Facebook page: handle, @handle, or facebook.com page URL. Use pages below for a batch." }, "pages": { "title": "Multiple Facebook pages", "minItems": 1, "maxItems": 25, "type": "array", "description": "Optional batch of 1–25 page handles or URLs. Overrides socialName. Equivalent URLs are deduplicated.", "items": { "type": "string" } }, "numberOfPosts": { "title": "Maximum posts per page", "minimum": 0, "maximum": 50, "type": "integer", "description": "Maximum public feed posts per page. Each saved post is one billable result. Set 0 for page details only, billed once per extracted profile.", "default": 5 }, "outputMode": { "title": "Dataset format", "enum": [ "pages", "posts" ], "type": "string", "description": "Pages preserves nested posts. Posts creates one row per post for CSV/Excel. Both formats charge per extracted post. Profile-only requests always export page rows.", "default": "pages" }, "proxyMode": { "title": "Proxy strategy", "enum": [ "auto", "never", "always" ], "type": "string", "description": "Auto tries direct HTTP first, then proxy recovery if needed. A transient failure permits one fresh-session retry (at most two proxy sessions). Never prevents proxy costs. Always routes Facebook requests through the configured proxy.", "default": "auto" }, "proxyConfiguration": { "title": "Proxy settings (optional)", "type": "object", "description": "Auto recovery uses Apify residential proxy when settings are omitted or the automatic group list is empty. Explicit proxy groups and custom URLs are preserved. Disabling Apify proxy disables recovery unless custom URLs are supplied. Proxy usage is charged separately." }, "maxConcurrency": { "title": "Concurrent pages", "minimum": 1, "maximum": 3, "type": "integer", "description": "Number of pages fetched concurrently. Lower this if Facebook limits requests.", "default": 2 }, "globalTimeOut": { "title": "Timeout per page (seconds)", "minimum": 15, "maximum": 600, "type": "integer", "description": "Budget for one page, including bounded recovery. Each HTTP request is limited to 15 seconds. For large batches, allow a sufficient Actor run timeout as well.", "default": 120 }, "debugArtifacts": { "title": "Save debug HTML", "type": "boolean", "description": "Save initial page HTML in the key-value store. Disabled by default to reduce storage and avoid retaining anonymous session data unnecessarily.", "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 } } } } } } } } } }