{ "openapi": "3.0.1", "info": { "title": "Facebook Reels Scraper | Page Reels & Metrics", "description": "Scrape public Facebook Page Reels and direct Reel URLs. Export engagement metrics, captions, creators, dates and optional media URLs to JSON, CSV or Excel. Filter by date and deduplicate results without a Facebook login.", "version": "3.0", "x-build-id": "uVfLTqhcntq76U72E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arabiainsights~facebook-reels-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arabiainsights-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/arabiainsights~facebook-reels-scraper/runs": { "post": { "operationId": "runs-sync-arabiainsights-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/arabiainsights~facebook-reels-scraper/run-sync": { "post": { "operationId": "run-sync-arabiainsights-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": { "pageUrls": { "title": "Facebook Page URLs", "type": "array", "description": "Public Facebook Page or Reels-tab URLs. Personal profile listings are not supported. Combine with direct Reel URLs; available history varies by Page and public access.", "default": [], "items": { "type": "string" } }, "reelUrls": { "title": "Direct Reel URLs", "type": "array", "description": "Public Facebook Reel or video URLs to resolve directly. The owner can resolve as Page, profile, or unknown.", "default": [], "items": { "type": "string" } }, "maxReels": { "title": "Maximum unique Reels", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Run-wide maximum unique Reel records to emit after URL canonicalization and deduplication. Defaults to 1,000.", "default": 1000 }, "maxCandidateReels": { "title": "Maximum candidate Reels", "minimum": 1, "maximum": 30000, "type": "integer", "description": "Maximum Reels to inspect before filtering. Defaults to min(maxReels * 5, 30000). Higher values can find more matches for narrow date ranges but increase work and platform costs. Must be at least maxReels." }, "dateFrom": { "title": "Published on or after (UTC)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:?\\d{2})?$|^\\d+\\s*[dD]ay[sS]?$|^\\d+\\s*[wW]eek[sS]?$|^\\d+\\s*[mM]onth[sS]?$|^\\d+\\s*[yY]ear[sS]?$", "type": "string", "description": "Optional inclusive lower boundary (UTC). Accepts a YYYY-MM-DD date, a full ISO timestamp, or a relative expression like \"7 days\", \"2 months\", or \"1 year\" (resolved against run start). Reels without an exact public timestamp are excluded when a date range is set and reported as unresolved." }, "dateTo": { "title": "Published on or before (UTC)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$|^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,3})?)?(Z|[+-]\\d{2}:?\\d{2})?$|^\\d+\\s*[dD]ay[sS]?$|^\\d+\\s*[wW]eek[sS]?$|^\\d+\\s*[mM]onth[sS]?$|^\\d+\\s*[yY]ear[sS]?$", "type": "string", "description": "Optional inclusive upper boundary (UTC). Accepts a YYYY-MM-DD date, a full ISO timestamp, or a relative expression like \"7 days\" or \"1 year\" (resolved against run start). Upper boundary for publication date filtering." }, "metricsMode": { "title": "Metric detail", "enum": [ "rounded", "exact" ], "type": "string", "description": "Choose rounded (default) for standard public counts, or exact to request more detailed counts for direct Reels when available. Exact values are not guaranteed. Each metric retains its observed precision; rounded and unavailable values remain rounded and null.", "default": "rounded" }, "relatedReelsPerSeed": { "title": "Related Reels per Direct Reel (opt-in)", "minimum": 0, "maximum": 5, "type": "integer", "description": "Include up to this many related Reels per direct input Reel (0–5). Related results may belong to other creators. They count toward maxReels and the same result pricing, and are deduplicated across the run.", "default": 0 }, "includeMediaUrls": { "title": "Include public media URLs", "type": "boolean", "description": "Include publicly exposed video and thumbnail URLs when available. Such URLs can be signed or transient; the Actor does not download media files.", "default": true }, "saveErrors": { "title": "Save detailed error records", "type": "boolean", "description": "Save actionable failures with their affected Facebook URLs in the error-records dataset. Errors are separate from result rows.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Choose Apify Proxy, your own proxy URLs, or no proxy. Availability can vary by route. Your explicit selection is preserved.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }