{ "openapi": "3.0.1", "info": { "title": "Facebook Page Video Downloader", "description": "Discover videos from public Facebook Page Videos and Reels tabs, paginate and deduplicate results, and save bounded MP4 files with source metadata and download status.", "version": "0.3", "x-build-id": "rgUiGzBTqgWJwIL43" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~facebook-page-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-facebook-page-video-downloader", "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/khadinakbar~facebook-page-video-downloader/runs": { "post": { "operationId": "runs-sync-khadinakbar-facebook-page-video-downloader", "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/khadinakbar~facebook-page-video-downloader/run-sync": { "post": { "operationId": "run-sync-khadinakbar-facebook-page-video-downloader", "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": [ "pageUrls" ], "properties": { "pageUrls": { "title": "Facebook Page URLs", "minItems": 1, "maxItems": 10, "type": "array", "description": "Enter 1–10 HTTPS public Facebook Page home URLs or Videos/Reels tab URLs. The Actor reads the public Videos listing or Reels grid without a login. Example: https://www.facebook.com/NASA/. Use Facebook Video Downloader when you already have individual video URLs.", "items": { "type": "string" } }, "mode": { "title": "Video discovery source", "enum": [ "feed", "reels", "both" ], "type": "string", "description": "Read the public Videos listing, Reels grid, or both. The stable API value feed selects the Videos listing. Discovery rotates through input Page/source pairs before fetching more pages. Only videos owned by the resolved Page enter the Dataset.", "default": "feed" }, "maxVideos": { "title": "Maximum video results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Stop after this many unique video records across all input Pages. Duplicate video IDs are returned once. This caps video-result events. The scan cap can stop discovery earlier.", "default": 10 }, "maxScans": { "title": "Maximum discovery pages", "minimum": 1, "maximum": 50, "type": "integer", "description": "Cap logical discovery pages across Pages and sources, including unsuccessful attempts. Native discovery has no scan-event fee. A discovery page can need a bounded redirect or a public query request. Increase this limit to paginate further, subject to the run deadline.", "default": 2 }, "downloadMp4": { "title": "Save MP4 files", "type": "boolean", "description": "Save complete MP4 copies to this run’s key-value store. Direct links and metadata are returned when files are unavailable or exceed the limits. Download status explains skipped files. Platform transfer and storage usage are additional.", "default": true }, "quality": { "title": "Preferred MP4 quality", "enum": [ "sd", "hd" ], "type": "string", "description": "Choose SD for smaller files or HD when exposed. The Actor uses the available quality if the preferred URL is absent. HD is not guaranteed. Large files can be skipped under your byte limits.", "default": "sd" }, "maxFileSizeMB": { "title": "Maximum single file size (MiB)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Limit each stored MP4 by actual bytes read, even without a size header. Oversized files are skipped with a reason. Direct links remain in the Dataset. The unit is 1,048,576 bytes.", "default": 25 }, "maxTotalDownloadMB": { "title": "Maximum total stored files (MiB)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap combined saved MP4 bytes across the run. Further files are skipped after the limit. Video link results continue to your maxVideos cap. The unit is 1,048,576 bytes.", "default": 100 } } }, "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 } } } } } } } } } }