{ "openapi": "3.0.1", "info": { "title": "Facebook Media Downloader – Video, Reel & Photo Links", "description": "Download public Facebook videos, Reels, Watch pages, and photos by URL. Returns direct CDN links plus metadata; optionally saves bounded files to run storage. Cookieless, no login. MCP-ready. $0.005/media.", "version": "0.1", "x-build-id": "sKmS7agNhQToecegX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~facebook-media-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-facebook-media-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-media-downloader/runs": { "post": { "operationId": "runs-sync-khadinakbar-facebook-media-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-media-downloader/run-sync": { "post": { "operationId": "run-sync-khadinakbar-facebook-media-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": [ "mediaUrls" ], "properties": { "mediaUrls": { "title": "Facebook media URLs", "type": "array", "description": "Use this when you have public Facebook video, Reel, Watch, photo, or post URLs and need direct downloadable media links. Example: https://www.facebook.com/reel/1535656380759655/ or https://www.facebook.com/photo.php?fbid=1635563591272344. Accepts facebook.com, fb.watch, and m.facebook.com. Not for private posts, Stories, Marketplace, or page album crawls.", "items": { "type": "string" } }, "maxMedia": { "title": "Max media records", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Use this to set a hard run-wide cap on saved and billed media records. Defaults to 20; range 1-1000. One Facebook URL can yield more than one media asset. Not a per-URL cap.", "default": 20 }, "mediaTypes": { "title": "Media types to keep", "type": "array", "description": "Optional filter of media kinds to keep after resolve. Leave empty to keep every public video, Reel, Watch, and photo asset the providers return. Use photo to keep still images only, or video/reel/watch for motion media.", "items": { "type": "string", "enum": [ "video", "reel", "watch", "photo" ], "enumTitles": [ "Video", "Reel", "Watch", "Photo" ] }, "default": [] }, "providerOrder": { "title": "Data provider", "enum": [ "scrapecreators-first", "sociavault-first", "scrapecreators-only", "sociavault-only" ], "type": "string", "description": "Use this when you need to select the managed public-data provider order. Defaults to ScrapeCreators then SociaVault fallback. Provider-only choices help diagnose upstream availability. This is not a Facebook login, cookie, or proxy setting.", "default": "scrapecreators-first" }, "downloadToStorage": { "title": "Save media files to storage", "type": "boolean", "description": "Use this when you need the actor to copy an available progressive MP4 or image into this run's key-value store. Defaults to false; direct CDN links are always returned. HLS-only, DRM, expired, or oversized media remain link-only. Only download media you are authorized to save. CDN links expire — save promptly when you need a durable copy.", "default": false }, "maxFileSizeMB": { "title": "Maximum file size (MB)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to cap each optional file written to storage. Defaults to 200 MB; range 1-500 MB. Media exceeding this cap is not downloaded but its direct link remains in the dataset. Only applies when Save media files is enabled.", "default": 200 } } }, "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 } } } } } } } } } }