{ "openapi": "3.0.1", "info": { "title": "Facebook Post and Reel Scraper", "description": "Scrape Facebook posts, reels and videos from links, pages, profiles and groups. Get views, reactions, comments, shares, caption, date, video links, transcript and author as clean JSON. Date filters, live results, no account or cookies needed.", "version": "1.0", "x-build-id": "XoTdj9ON7T4SHDqUl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insights_data~facebook-post-and-reel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insights_data-facebook-post-and-reel-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/insights_data~facebook-post-and-reel-scraper/runs": { "post": { "operationId": "runs-sync-insights_data-facebook-post-and-reel-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/insights_data~facebook-post-and-reel-scraper/run-sync": { "post": { "operationId": "run-sync-insights_data-facebook-post-and-reel-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", "required": [ "urls" ], "properties": { "urls": { "title": "🔗 Facebook links", "minItems": 1, "type": "array", "description": "One or many links. Post, reel, video, share and fb.watch links return that post. Page, profile and public group links return their latest posts. Bulk input is supported.", "items": { "type": "string" } }, "max_items": { "title": "📊 Max posts per run", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum posts collected from page, profile and group links in total. 0 = all. Direct post and reel links are always returned.", "default": 10 }, "newer_than": { "title": "📅 Only posts newer than", "type": "string", "description": "Date like 2025-01-01, or a relative age like 7d, 2w, 3mo, 1y. Leave empty for no limit." }, "comments_per_post": { "title": "💬 Comments per post", "minimum": -1, "maximum": 100000, "type": "integer", "description": "Top-level comments collected per post. 0 = none, -1 = every comment Facebook serves.", "default": 0 }, "replies_per_comment": { "title": "🗨 Replies per comment", "minimum": -1, "maximum": 100000, "type": "integer", "description": "Replies collected per comment. 0 = none, -1 = every reply. Needs comments per post above 0.", "default": 0 }, "comments_sort": { "title": "🔃 Comment order", "enum": [ "all", "most_relevant", "newest" ], "type": "string", "description": "Order in which comments are collected.", "default": "all" }, "include_video_details": { "title": "🎙 Video details and transcript", "type": "boolean", "description": "Adds refreshed view and play counts, duration, HD and SD links and the transcript for every video and reel.", "default": true }, "include_author_info": { "title": "👥 Author followers and category", "type": "boolean", "description": "Adds follower count, category and verification of each author.", "default": true }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "No proxy is used by default. If Facebook rejects requests, the run switches to a stronger proxy on its own.", "default": { "useApifyProxy": 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 } } } } } } } } } }