{ "openapi": "3.0.1", "info": { "title": "Facebook Reels & Comments Scraper", "description": "Scrape Facebook Reels with the Facebook Reels Scraper. Extract video URLs, captions, likes, comments, shares, and uploader info. Perfect for trend tracking, content analysis, and social media research. Fast, accurate, and scalable for single or bulk Reels scraping.", "version": "1.0", "x-build-id": "COOM4jN2kIbVCdDRu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~facebook-reels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-facebook-reels-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/scrapier~facebook-reels-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-facebook-reels-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/scrapier~facebook-reels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-facebook-reels-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": { "reelProfileUrls": { "title": "📍 Reel profile URLs", "type": "array", "description": "One profile per line — e.g. facebook.com/YourPage or a /people/… link. Bare usernames (no https://) resolve too. Comments are pulled from the Reels found on each profile.", "items": { "type": "string" } }, "reelsPerProfileLimit": { "title": "🔢 Reels to scan per profile", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many Reels per profile to open and read comments from (newest-first where available). This caps the parent Reel rows only — comments are collected on top and bounded separately below." }, "reelsNewerThan": { "title": "🕐 Only mine Reels newer than", "type": "string", "description": "📆 Absolute: pick a date. ⏱️ Relative: e.g. 7 days, 2 weeks. Leave blank for no cutoff." }, "maxCommentsPerReel": { "title": "💬 Max comments per Reel", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Number of top-level comments to collect per Reel. Replies (if enabled below) are additional and bounded separately.", "default": 50 }, "includeReplies": { "title": "↪️ Include replies", "type": "boolean", "description": "Also collect replies attached to each top-level comment (marked isReply = true, linked by parentCommentId).", "default": true }, "maxRepliesPerComment": { "title": "🔁 Max replies per comment", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Cap on replies collected under each top-level comment when replies are enabled.", "default": 10 }, "enableAiSentiment": { "title": "🤖 Enable AI sentiment", "type": "boolean", "description": "Tag each comment with a sentiment label using your own Anthropic API key. Costs are billed by Anthropic to your key.", "default": false }, "aiApiKey": { "title": "🔑 Anthropic API key", "type": "string", "description": "Your Anthropic API key. Only used when AI sentiment is enabled. Stored as a secret." }, "aiModel": { "title": "🧠 AI model", "type": "string", "description": "Anthropic model id used for sentiment tagging. Default is claude-opus-4-8; claude-haiku-4-5 is a cheaper option for high comment volumes.", "default": "claude-opus-4-8" }, "proxyConfiguration": { "title": "🔒 Proxy", "type": "object", "description": "Route Facebook traffic through Apify Proxy (recommended for fewer blocks)." } } }, "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 } } } } } } } } } }