{ "openapi": "3.0.1", "info": { "title": "Social Video Downloader - TikTok, Instagram, Facebook, X", "description": "Download TikTok, Instagram Reels, Facebook, X (Twitter), Reddit and Vimeo videos by URL as MP4 up to 1080p or MP3/M4A audio, from 1,000+ sites. A direct download link per video with title, author, duration and file size. Bulk links, no login. Errors are free.", "version": "0.1", "x-build-id": "GuH5qb3kyqVJCTGuK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~social-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-social-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/scrapewise~social-video-downloader/runs": { "post": { "operationId": "runs-sync-scrapewise-social-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/scrapewise~social-video-downloader/run-sync": { "post": { "operationId": "run-sync-scrapewise-social-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", "properties": { "urls": { "title": "Video links", "type": "array", "description": "One link per line: TikTok videos, Instagram reels and video posts, Facebook videos and reels, X (Twitter) posts with video, Reddit video posts, Vimeo, Dailymotion and 1,000+ other video pages. Single videos only (not profiles or playlists). YouTube is not supported.", "items": { "type": "string" } }, "quality": { "title": "Video quality", "enum": [ "best", "1080", "720", "480", "360" ], "type": "string", "description": "Highest resolution up to this limit (the short side of the video, so 1080 also means 1080x1920 for vertical videos). When a video has nothing at or below the limit, the closest one above it is used.", "default": "best" }, "maxCompatibility": { "title": "Prefer H.264 (plays everywhere)", "type": "boolean", "description": "Some sites serve their best quality as VP9 or H.265, which older players and some editors do not open. Turn this on to prefer H.264 MP4, even if it means a lower resolution.", "default": false }, "audioOnly": { "title": "Audio only", "type": "boolean", "description": "Deliver only the sound of each video as an audio file (format below) instead of the MP4. Same price per file.", "default": false }, "audioFormat": { "title": "Audio format", "enum": [ "m4a", "mp3" ], "type": "string", "description": "Used only with Audio only. M4A keeps the original AAC sound when possible; MP3 is re-encoded for players that need it.", "default": "m4a" }, "maxItems": { "title": "Max files", "minimum": 0, "type": "integer", "description": "Stop after this many files are delivered. 0 = no limit (every link). Apify Free plan runs are capped at 20 files.", "default": 0 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Larger videos come back as a free MEDIA_TOO_LARGE row instead of a file. Lower the quality to fit long videos under the limit.", "default": 300 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Videos are read from the server's own IP first (the fastest way). The proxy is used only when a site refuses that IP. Facebook videos that ask for login get one more try through the Apify residential proxy, used only to read the page, never to download the file.", "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 } } } } } } } } } }