TikTok

Video

Download a TikTok video with its cover, every available quality, stats and the list of caption tracks.

Endpoint

GET
/s/tiktok/post

Send your API key in the X-API-Key header. tiktok is the usual service slug; use the one shown on your subscription if it differs.

Query parameters

NameDescription
urlrequired
Link to the video. You can pass the numeric ID as id instead.Example: https://www.tiktok.com/@scout2015/video/6718335390845095173

Accepted links

  • https://www.tiktok.com/@user/video/<id>
  • Short links: https://vm.tiktok.com/<code>, https://vt.tiktok.com/<code>, https://www.tiktok.com/t/<code>
  • A numeric video ID (id=6718335390845095173)

Example request

curl '/s/tiktok/post?url=https%3A%2F%2Fwww.tiktok.com%2F%40scout2015%2Fvideo%2F6718335390845095173' \
  -H 'X-API-Key: YOUR_API_KEY'

Example response

The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.

{
  "data": {
    "platform": "tiktok",
    "id": "6718335390845095173",
    "url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
    "type": "video",
    "text": "Scramble up ur name & I’ll try to guess it 😍❤️ #foryoupage",
    "createdAt": "2019-07-28T19:45:12Z",
    "author": {
      "id": "6743219038927391749",
      "username": "scout2015",
      "name": "Scout & Suki",
      "avatar": "https://cdn.example/avatar.jpg",
      "verified": false
    },
    "media": [
      {
        "type": "video",
        "url": "https://v16.tiktokcdn.example/video-1080.mp4",
        "thumbnail": "https://p16.tiktokcdn.example/cover.jpeg",
        "width": 1080,
        "height": 1920,
        "duration": 15,
        "variants": [
          {
            "url": "https://v16.tiktokcdn.example/video-720.mp4",
            "contentType": "video/mp4",
            "bitrate": 1100000,
            "width": 720,
            "height": 1280
          }
        ]
      }
    ],
    "stats": {
      "likes": 1240000,
      "comments": 24800,
      "views": 9500000,
      "shares": 3100,
      "saves": 18200
    },
    "captions": [
      {
        "language": "eng-US",
        "label": "English (US)",
        "url": "https://v16.tiktokcdn.example/sub.vtt",
        "format": "webvtt",
        "autoGenerated": true
      }
    ]
  }
}

Notes