{ "openapi": "3.0.1", "info": { "title": "TikTok Video Downloader", "description": "Download TikTok videos without watermark as MP4, convert TikTok to MP3 audio, or save photo slideshows as ZIP. Supports Douyin. No proxy needed, no login required. Returns the actual file in key-value store with full metadata (title, author, views, likes, duration).", "version": "1.1", "x-build-id": "7Rsg7hxZWu4IFIc6E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dltik~tiktok-video-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dltik-tiktok-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/dltik~tiktok-video-downloader/runs": { "post": { "operationId": "runs-sync-dltik-tiktok-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/dltik~tiktok-video-downloader/run-sync": { "post": { "operationId": "run-sync-dltik-tiktok-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": { "url": { "title": "TikTok URL (single)", "type": "string", "description": "Single public TikTok or Douyin post URL. Use 'urls' for batch processing." }, "urls": { "title": "TikTok URLs (batch)", "type": "array", "description": "List of public TikTok or Douyin post URLs. Each gets its own download file in the key-value store (OUTPUT, OUTPUT-2, OUTPUT-3, etc.).", "items": { "type": "string" } }, "output": { "title": "Output format", "enum": [ "mp4", "mp3", "photos_zip" ], "type": "string", "description": "mp4 = video (no watermark), mp3 = audio only, photos_zip = photo slideshow as ZIP.", "default": "mp4" }, "quality": { "title": "Video quality", "enum": [ "best", "1080", "720", "480" ], "type": "string", "description": "Maximum video resolution. 'best' = highest available (usually 1080p). Lower = smaller file, faster download.", "default": "best" }, "watermarkPolicy": { "title": "Watermark policy", "enum": [ "standard", "require_none" ], "type": "string", "description": "standard = best available quality (usually no watermark). require_none = fail if no watermark-free source exists.", "default": "standard" }, "extractSubtitles": { "title": "Extract subtitles / captions", "type": "boolean", "description": "Extract auto-generated captions as plain text. Useful for content repurposing, transcription, and SEO. Included in metadata output.", "default": false }, "metadataOnly": { "title": "Metadata only (no download)", "type": "boolean", "description": "Extract metadata (title, author, views, likes, hashtags, music) without downloading the file. Charges metadata rate instead of download rate.", "default": false }, "cookies": { "title": "TikTok cookies (optional)", "type": "array", "description": "TikTok session cookies to bypass IP blocks. Get them from Chrome DevTools → Application → Cookies → tiktok.com. Copy sessionid, ttwid, s_v_web_id. Format: [{\"name\": \"sessionid\", \"value\": \"abc123\"}, ...]", "items": { "type": "object", "properties": { "name": { "title": "Cookie name", "type": "string", "description": "Cookie name (e.g. sessionid)" }, "value": { "title": "Cookie value", "type": "string", "description": "Cookie value" } } } } } }, "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 } } } } } } } } } }