{ "openapi": "3.0.1", "info": { "title": "Facebook Reels Scraper - Exact Play Counts", "description": "Scrape Facebook Reels without login: exact play count (not rounded), reaction breakdown by type, comment count, share count, duration, caption, thumbnail and page identity. Filter by plays and date, with monitor mode for new Reels.", "version": "0.1", "x-build-id": "igRfhRUj1EQMGcMZ3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~facebook-reels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-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/scrapesage~facebook-reels-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-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/scrapesage~facebook-reels-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-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": { "pages": { "title": "Facebook pages", "type": "array", "description": "Page slugs or page URLs whose Reels you want, e.g. natgeo or https://www.facebook.com/natgeo/", "items": { "type": "string" } }, "reelUrls": { "title": "Reel URLs or IDs", "type": "array", "description": "Specific Reels, e.g. https://www.facebook.com/reel/2891748427826015/ or the bare numeric id.", "items": { "type": "string" } }, "onlyReels": { "title": "Reels only", "type": "boolean", "description": "Return only Reels. Turn off to include the page's regular videos too (they carry the same exact play counts and reaction breakdown).", "default": true }, "requirePlayCount": { "title": "Only Reels with an exact play count", "type": "boolean", "description": "Play counts come from the page Videos tab, which paginates separately from the Reels tab, so a page’s older Reels can appear without one. On by default so the play-count column is never empty. Turn off to receive every Reel found, including ones with no play count.", "default": true }, "minPlays": { "title": "Minimum plays", "minimum": 0, "type": "integer", "description": "Skip Reels below this exact play count.", "default": 0 }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only Reels published on or after this date (YYYY-MM-DD)." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only Reels published on or before this date (YYYY-MM-DD)." }, "maxResults": { "title": "Maximum Reels", "minimum": 0, "type": "integer", "description": "Total Reels to return across all inputs. 0 means no limit (the run's time budget stops it safely).", "default": 100 }, "onlyNewReels": { "title": "Monitor mode - only new Reels", "type": "boolean", "description": "Remembers Reels already returned for this input set and emits only unseen ones. Ideal on a schedule.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "RESIDENTIAL is the tested default and strongly recommended - Facebook rate-limits datacenter ranges hard.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }