{
  "openapi": "3.0.1",
  "info": {
    "title": "TikTok Video Downloader - No Watermark MP4 + MP3",
    "description": "Download TikTok videos as no-watermark MP4 files plus optional MP3 audio and cover image, saved as permanent Apify Key-Value store URLs. Provider-backed, no cookies required, MCP optimized for AI agents.",
    "version": "0.2",
    "x-build-id": "hRYZhPbuVheloddi3"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~tiktok-no-watermark-downloader/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-tiktok-no-watermark-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~tiktok-no-watermark-downloader/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-tiktok-no-watermark-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~tiktok-no-watermark-downloader/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-tiktok-no-watermark-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": {
          "videoUrls": {
            "title": "TikTok video links",
            "type": "array",
            "description": "Video links to download, for example https://www.tiktok.com/@user/video/1234567890 or a short share link like https://vm.tiktok.com/ZMabc123/. Photo-post links work too. Duplicates are removed. Profile links belong in 'Profiles' (a profile link pasted here is moved there automatically).",
            "items": {
              "type": "string"
            }
          },
          "profiles": {
            "title": "Profiles (download recent videos of an account)",
            "type": "array",
            "description": "TikTok accounts to back up, written as @username or a profile link like https://www.tiktok.com/@username. Newest videos first. Control how many with 'Max videos per profile' and the date fields. Leave empty to use only video links.",
            "items": {
              "type": "string"
            }
          },
          "videoIds": {
            "title": "Video IDs",
            "type": "array",
            "description": "Numeric TikTok video IDs (15 to 22 digits), one per line. Use this when you only have IDs, for example 7654638524729216287.",
            "items": {
              "type": "string"
            }
          },
          "maxVideos": {
            "title": "Max videos per run",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Hard limit on posts saved (and billed) in one run, across all links and profiles. Default 50, maximum 1000. Extra targets are left out and reported in the run summary as left over.",
            "default": 50
          },
          "maxVideosPerProfile": {
            "title": "Max videos per profile",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "How many recent videos to take from each profile. Default 20. Use 0 to take as many as 'Max videos per run' allows.",
            "default": 20
          },
          "postedAfter": {
            "title": "Posted after",
            "type": "string",
            "description": "Only videos posted on or after this date. Use a date like 2026-10-01 or a relative value like '7 days' or '2 weeks'. Pinned videos are always kept. Leave empty for no start date."
          },
          "postedBefore": {
            "title": "Posted before",
            "type": "string",
            "description": "Only videos posted on or before this date, for example 2026-11-01. Leave empty for no end date."
          },
          "onlyNewVideos": {
            "title": "Only new videos (incremental backup)",
            "type": "boolean",
            "description": "For profiles: skip videos this Actor already saved for you on an earlier run and stop at the first one it recognises. The memory is kept in your own storage called tiktok-downloader-seen. If nothing is new the run ends with VALID_EMPTY and no charge.",
            "default": false
          },
          "skipPhotoPosts": {
            "title": "Skip photo posts",
            "type": "boolean",
            "description": "Photo slideshows are saved as image files by default and count as one post. Tick this to take videos only.",
            "default": false
          },
          "quality": {
            "title": "Video quality",
            "enum": [
              "compatible",
              "highest",
              "smallest"
            ],
            "type": "string",
            "description": "compatible = standard no-watermark MP4 that plays everywhere (recommended). highest = the largest resolution TikTok offers, often 1080p in H.265 which some old players cannot open. smallest = the smallest file for quick archives.",
            "default": "compatible"
          },
          "downloadFiles": {
            "title": "Save files to storage",
            "type": "boolean",
            "description": "On (default): each file is saved to your run storage and you get permanent links. Off: only fresh direct TikTok links are returned (no files saved, faster); those links expire in roughly 48 hours. Billing per video is the same.",
            "default": true
          },
          "extractAudio": {
            "title": "Also save the MP3 sound",
            "type": "boolean",
            "description": "Saves each video's sound as an MP3. Billed separately per audio file saved (see Pricing). Default off.",
            "default": false
          },
          "includeCover": {
            "title": "Also save the cover image",
            "type": "boolean",
            "description": "Saves the cover thumbnail as a JPEG. Free. Default on.",
            "default": true
          },
          "includeWatermarked": {
            "title": "Also save the watermarked MP4",
            "type": "boolean",
            "description": "Saves TikTok's own watermarked version next to the clean one. Free. Default off.",
            "default": false
          },
          "createZip": {
            "title": "Pack videos into ZIP files",
            "type": "boolean",
            "description": "After the run, builds ZIP file(s) of all saved MP4s plus a metadata.csv (about 120 MB per ZIP part). Free. Needs 'Save files to storage' on.",
            "default": false
          },
          "maxFileSizeMb": {
            "title": "Max file size (MB)",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Files larger than this are skipped for free and marked skipped_too_large. Default 50, maximum 100.",
            "default": 50
          },
          "maxConcurrency": {
            "title": "Parallel downloads",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many posts are processed at the same time. Default 4 (8 when saving links only). Maximum 10. Lower it if you see download errors.",
            "default": 4
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}