API Data Hub Docs Get a key

TikTok API reference

27 read-only endpoints for public TikTok data: profiles, posts, comments, stories, highlights, playlists, collections, sounds, hashtags, search and trending. Every endpoint is a GET request that returns JSON.

Base URL

All requests go over HTTPS to:

https://api.apidatahub.site

Add the endpoint path and pass parameters in the query string, for example https://api.apidatahub.site/tiktok/v2/profiles?uniqueId=tiktok.

Authentication

Send your API key in the x-api-key header on every request.

cURL
curl "https://api.apidatahub.site/tiktok/v2/profiles?uniqueId=tiktok" \
  -H "x-api-key: YOUR_API_KEY"

To get a key, write to george@apidatahub.site. Keep it on your server. Don't ship it in browser code or commit it to a public repository.

Response format

Every successful response has the same envelope. The endpoint's payload is in data.

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.31,
  "data": { ... }
}
  • code: 0 on success. See Errors for the other values.
  • msg: "success", or a short explanation when something went wrong.
  • processed_time: seconds the request took on our side.

Media URLs in responses (play, cover, avatars, music) are signed by TikTok's CDN and expire after a few hours. Download the files you need rather than storing the URLs.

The response examples on this page are shortened: lists show one item, and long media URLs are cut at the query string.

Errors

Check code in the response body:

CodeMeaning
0Success.
-1The request failed. Read msg for the reason, for example a missing parameter, a private account, or content that doesn't exist.
10401The API key is missing or invalid. The body is {"message": "Invalid API key in request", "code": "10401"}.

Something not behaving as documented? Write to george@apidatahub.site with the request you sent.

Users

Profiles, a user's posts, reposts, liked videos and stories.

GET/tiktok/v2/profiles

Get profile

Returns a user's public profile and stats: follower, following, like and video counts.

Parameters

Query paramTypeRequiredDescription
uniqueIdstringOne ofThe user's handle, without the @.
Example: tiktok
userIdstringOne ofNumeric TikTok user ID.
Example: 107955

Send uniqueId or userId. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/profiles?uniqueId=tiktok" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.7516,
  "data": {
    "user": {
      "id": "107955",
      "uniqueId": "tiktok",
      "nickname": "TikTok",
      "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.webp?...",
      "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.webp?...",
      "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.webp?...",
      "signature": "One TikTok can make a big impact",
      "verified": true,
      "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "secret": false,
      "ftc": false,
      "relation": 0,
      "openFavorite": false,
      "commentSetting": null,
      "duetSetting": null,
      "stitchSetting": null,
      "privateAccount": false,
      "isADVirtual": false,
      "isUnderAge18": false,
      "ins_id": "",
      "twitter_id": "",
      "youtube_channel_title": "",
      "youtube_channel_id": "",
      "UserStoryStatus": 0,
      "createTime": 1425144149,
      "bioLink": {
        "link": "linktr.ee/tiktok"
      }
    },
    "stats": {
      "followingCount": 3,
      "followerCount": 93418588,
      "heartCount": 456233558,
      "videoCount": 1490,
      "diggCount": 0,
      "heart": 456233558
    }
  }
}
GET/tiktok/v2/posts

List a user's posts

Returns a user's published videos, newest first.

Parameters

Query paramTypeRequiredDescription
secUidstringOne ofThe user's secUid, returned by Get profile.
Example: MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM
userIdstringOne ofNumeric TikTok user ID.
Example: 107955
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Send secUid or userId. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/posts?secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.3083,
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000d71c2ovog65rucrbjmug",
        "video_id": "7620867673357962527",
        "region": "US",
        "title": "brb learning how to make dumplings so I can catch up to @esther choi 😋 #TheDiscoverList #FNHotList #TheFutureofFlavor",
        "content_desc": [],
        "cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oAmpwADHEECEADu0fEAAI7AFnsCu7jALuNeRVw~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg?...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oAmpwADHEECEADu0fEAAI7AFnsCu7jALuNeRVw~tplv-tiktokx-origin.image?...",
        "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oQDIqIw9AAC5i872IifzW0BAcD4W9iC5zMaxAC~tplv-tiktokx-360p.webp?...",
        "duration": 41,
        "play": "https://v16m.tiktokcdn-eu.com/b1c44541b398adc87a1fe28598548f33/69c558b1/video/tos/maliva/tos-maliva-ve-0068c799-us/oQjgtEfEcAwNpj6V5IBFRzASLmQfF1EgD3OsiF/?...",
        "wmplay": "https://v16m.tiktokcdn-eu.com/445c6c13710e6e2c8de66648239d5c19/69c558b1/video/tos/maliva/tos-maliva-ve-0068c799-us/o4jqE5fwAF3RAQ1ppKImmCFkEzEFVsfhBtg6Dj/?...",
        "size": 6030914,
        "wm_size": 5533897,
        "music": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx2/7620867864177707806.mp3",
        "music_info": {
          "id": "7620867795462392607",
          "title": "original sound - tiktok",
          "play": "https://sf16.tiktokcdn-us.com/obj/ies-music-tx2/7620867864177707806.mp3",
          "cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?...",
          "author": "TikTok",
          "original": true,
          "duration": 41,
          "album": ""
        },
        "play_count": 52963,
        "digg_count": 2041,
        "comment_count": 444,
        "share_count": 213,
        "download_count": 7,
        "collect_count": 190,
        "create_time": 1774371567,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "auction_ad_invited": false,
          "with_comment_filter_words": false,
          "adv_promotable": false,
          "branded_content_type": 0,
          "organic_log_extra": "{\"req_id\":\"20260326000216C906B12C610355DE72A1\"}",
          "is_diversion_ad": 0
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "6800850810743653382",
        "author": {
          "id": "107955",
          "unique_id": "tiktok",
          "nickname": "TikTok",
          "avatar": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.webp?..."
        },
        "is_top": 0
      }
    ],
    "cursor": "1773419703000",
    "hasMore": true
  }
}
GET/tiktok/v2/reposts

List a user's reposts

Returns the videos a user has reposted.

Parameters

Query paramTypeRequiredDescription
secUidstringOne ofThe user's secUid, returned by Get profile.
Example: MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM
userIdstringOne ofNumeric TikTok user ID.
Example: 107955
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Send secUid or userId. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/reposts?secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.9125,
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000d724vbfog65ugaj79100",
        "video_id": "7621307384165666079",
        "region": "US",
        "title": "the way I FaceTimed my friends like I’m getting engaged…it’s just a podcast 🤣 ",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osfiqItQDz2eJCUCAEfrA9CSpFBULTIIb9AjgE~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg?...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ooJCt0tf7EITFIAeIevAjUhDAErIqyAqgZi2I6~tplv-tiktokx-origin.image?...",
        "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQJgqFDzjIIxVIitvEEIqeCAUA0Ave8ZiTfAhb~tplv-tiktokx-360p.webp?...",
        "duration": 124,
        "play": "https://v16m.tiktokcdn-us.com/9179cb0c35ec2bedff17847f80b78a1c/69d2bdec/video/tos/useast8/tos-useast8-pve-0068-tx2/ooTiDehUEqJAC0gIItNEEIAuQjFzoqfqqAZDeE/?...",
        "wmplay": "https://v16m.tiktokcdn-us.com/58f30cb8b00ccf8f811742cf8da1e952/69d2bdec/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oIrIeyD4FMhtiUETljUAAC0IgeZIEqQfATJq3E/...",
        "size": 14319755,
        "wm_size": 13199748,
        "music": "https://v16-ies-music.tiktokcdn-us.com/0e0096ef6e9f2517da80e5f93f8dfb6b/69dba4a3/video/tos/useast8/tos-useast8-v-27dcd7-tx2/o4UULEXDAFBBzLeFf5pJEQC9IBEUsxMbF...",
        "music_info": {
          "id": "7621307427723447071",
          "title": "original sound - thecarterb",
          "play": "https://v16-ies-music.tiktokcdn-us.com/0e0096ef6e9f2517da80e5f93f8dfb6b/69dba4a3/video/tos/useast8/tos-useast8-v-27dcd7-tx2/o4UULEXDAFBBzLeFf5pJEQC9IBEUsxMbF...",
          "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/91c8492aa3b1bb647add3dc24e9892b7~tplv-tiktokx-cropcenter:1080:1080.jpeg?...",
          "author": "Carter Gregory",
          "original": true,
          "duration": 124,
          "album": ""
        },
        "play_count": 92670,
        "digg_count": 5362,
        "comment_count": 322,
        "share_count": 240,
        "download_count": 24,
        "collect_count": 325,
        "create_time": 1774473919,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20260405135216B014C608A5A7BCB3F782\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "6756295321263490053",
          "unique_id": "thecarterb",
          "nickname": "Carter Gregory",
          "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/91c8492aa3b1bb647add3dc24e9892b7~tplv-tiktokx-cropcenter:300:300.jpeg?..."
        },
        "is_top": 0
      }
    ],
    "cursor": "10",
    "hasMore": true
  }
}
GET/tiktok/v2/user/favorite

List a user's liked videos

Returns the videos a user has liked. Only works when the user has made their liked videos public.

Parameters

Query paramTypeRequiredDescription
secUidstringOne ofThe user's secUid, returned by Get profile.
Example: MS4wLjABAAAA...
userIdstringOne ofNumeric TikTok user ID.
Example: 6622077159488258054
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Send secUid or userId. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/user/favorite?secUid=MS4wLjABAAAA..." \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 1.3132,
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000d69ev9nog65o2t8vufjg",
        "video_id": "7607406228058295582",
        "region": "US",
        "title": "olha o que esses animais fazem com esse fotógrafo #fotografo #natureza #animais #suricate #guepardo",
        "content_desc": [],
        "cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocKeEqED3LfIfwhD8TdSIPnIBNFbqjAJPmC1kA~tplv-tiktokx-cropcenter-q:300:400:q72.webp?...",
        "ai_dynamic_cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMIPOmIAqOAFnEd8SyjPwJfqDeDhIClIfFCTLS~tplv-tiktokx-origin.image?...",
        "origin_cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0lDdIbmSwTAn5w8qSEWCFJIjICDLAeqPIfafP~tplv-tiktokx-360p.jpeg?...",
        "play": "https://v19.tiktokcdn.com/8196ad735deb35d5315bd84b39c53485/69c5586d/video/tos/maliva/tos-maliva-ve-0068c799-us/okK8QOXezoqNGfVlIgMAI9JAjuTA4C0IhdQf8E/?...",
        "wmplay": "https://v19.tiktokcdn.com/0caf59b5852abcfab72658b27f482aeb/69c5586d/video/tos/maliva/tos-maliva-ve-0068c799-us/oUJdfMJIIAqNufgIAI4Q789gDQMjATXfTlCoO8/?...",
        "size": 17725722,
        "wm_size": 16934769,
        "music": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oUt7660DmBZO7wSgEB8kCeqngIQOVBfxbvrtJ0",
        "music_info": {
          "id": "7255011118329989121",
          "title": "My Love Mine All Mine",
          "play": "https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/oUt7660DmBZO7wSgEB8kCeqngIQOVBfxbvrtJ0",
          "cover": "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/ooPZ0QAmIDXOl0ABvfktdnRBrIraQtAbgCbeFZ.jpeg",
          "author": "Mitski",
          "original": false,
          "duration": 60,
          "album": "The Land Is Inhospitable and So Are We"
        },
        "play_count": 1159273,
        "digg_count": 262730,
        "comment_count": 448,
        "share_count": 23611,
        "download_count": 1376,
        "collect_count": 21200,
        "create_time": 1771237401,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20260326000047855CE038981CB0010633\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "7169302951449969707",
          "unique_id": "fun.maker.s50",
          "nickname": "fun.maker.s50",
          "avatar": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/6b4e305f2e0a5adbc142f6e34cb29665~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?..."
        },
        "is_top": 0
      }
    ],
    "cursor": "1772791616778456",
    "hasMore": true
  }
}
GET/tiktok/v2/stories

List a user's stories

Returns a user's active stories.

Parameters

Query paramTypeRequiredDescription
userIdstringRequiredNumeric TikTok user ID.
Example: 7128593328456041478
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/stories?userId=7128593328456041478" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 1.0559,
  "data": {
    "videos": [
      {
        "aweme_id": "",
        "video_id": "7668960671035346198",
        "region": "AT",
        "title": "",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-i-photomode-no/2b5574585fee4fb79301e5258534ca04~tplv-photomode-image-cover:640:0:q70.webp?...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-i-photomode-no/2b5574585fee4fb79301e5258534ca04~tplv-photomode-image-cover:640:0:q70.webp?...",
        "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-i-photomode-no/2b5574585fee4fb79301e5258534ca04~tplv-photomode-image-cover:640:0:q70.webp?...",
        "duration": 0,
        "play": "https://sf19-music.tiktokcdn-eu.com/obj/tiktok-obj/7650432746740779792.mp3",
        "wmplay": "https://sf19-music.tiktokcdn-eu.com/obj/tiktok-obj/7650432746740779792.mp3",
        "size": 0,
        "wm_size": 0,
        "music": "https://sf19-music.tiktokcdn-eu.com/obj/tiktok-obj/7650432746740779792.mp3",
        "music_info": {
          "id": "7647269099185949448",
          "title": "original sound - sillyhamtaro",
          "play": "https://sf19-music.tiktokcdn-eu.com/obj/tiktok-obj/7650432746740779792.mp3",
          "cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-alisg-avt-0068/62a24d0ebe72e61dd86aeb1aec389e56~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?...",
          "author": "️️ ️",
          "original": true,
          "duration": 8,
          "album": ""
        },
        "play_count": 6126,
        "digg_count": 290,
        "comment_count": 0,
        "share_count": 2,
        "download_count": 0,
        "collect_count": 0,
        "create_time": 1785569057,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20260802152136F32491975F5B3743D372\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 3,
        "mentioned_users": "",
        "author": {
          "id": "7128593328456041478",
          "unique_id": "isi.cos",
          "nickname": "isi💕 || twitch.tv/isiicos",
          "avatar": "https://p19-common-sign.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/6f5ba7e1b231d441e3819617bd0219af~tplv-tiktokx-cropcenter-q:300:300:q70.webp?..."
        },
        "is_nff_or_nr": false,
        "images": [
          "https://p16-common-sign.tiktokcdn-eu.com/tos-no1a-i-photomode-no/2b5574585fee4fb79301e5258534ca04~tplv-photomode-image-v1:q70.webp?..."
        ],
        "is_top": 0
      }
    ],
    "cursor": "1785608108135",
    "hasMore": true
  }
}

Posts and comments

A single video, its comments, and replies to a comment.

GET/tiktok/v2/post-details

Get post details

Returns full details for one video or photo post: caption, stats, author, music, and video and cover URLs.

Parameters

Query paramTypeRequiredDescription
videoIdstringRequiredThe video ID, the number at the end of a TikTok video URL.
Example: 7612965843596479751

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/post-details?videoId=7612965843596479751" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.2929,
  "data": {
    "aweme_id": "v14044g50000d6javofog65oscmug370",
    "id": "7612965843596479751",
    "region": "JP",
    "title": "藤原千花ちゃんお誕生日おめでとう!#藤原千花コスプレ #chikafujiwara #かぐや様は告らせたいコスプレ #kaguyasamaloveiswar #cosplay ",
    "content_desc": [],
    "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/ogA2wtamuoAABIZZBzPBasAhEiYCgiAENlaH5~tplv-tiktokx-cropcenter-q:300:400:q72.jpeg?...",
    "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/ogA2wtamuoAABIZZBzPBasAhEiYCgiAENlaH5~tplv-tiktokx-origin.image?...",
    "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/ogDQQcF4IlohtG0NDCDAQfTxjxTAYCVI1VEvfe~tplv-tiktokx-360p.webp?...",
    "duration": 8,
    "play": "https://v19.tiktokcdn-us.com/47320156299829b6c62f2fd787acfe54/69c45aaa/video/tos/alisg/tos-alisg-pve-0037c001/o4qGIEmEjolfQfecsAgVPIHTQAxTvxDRyhCDFC/?...",
    "wmplay": "https://v19.tiktokcdn-us.com/ad197961472ddc1a3d20f61ea4aa85d2/69c45aaa/video/tos/alisg/tos-alisg-pve-0037c001/o0ImEQBDRs3pAaBp4iaYfDtyOf4EwiCgUoqEBu/?...",
    "hdplay": "https://v16.tokcdn.com/4bd73d5b9cbb550bc5265c4cec627798/69a62480/7612965843596479751_original.mp4",
    "size": 2161877,
    "wm_size": 2152607,
    "hd_size": 14394587,
    "music": "https://v16-ies-music.tiktokcdn-us.com/23e0b0c9cb1903c1bc26302b53481dd0/69cd40d2/video/tos/alisg/tos-alisg-v-27dcd7/o41NfPBIARmLAIfIhFLmJYFGAeAFAGGDesmQGB/?...",
    "music_info": {
      "id": "7612965861980261128",
      "title": "original sound - artchiist",
      "play": "https://v16-ies-music.tiktokcdn-us.com/23e0b0c9cb1903c1bc26302b53481dd0/69cd40d2/video/tos/alisg/tos-alisg-v-27dcd7/o41NfPBIARmLAIfIhFLmJYFGAeAFAGGDesmQGB/?...",
      "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?...",
      "author": "ちい/Chii",
      "original": true,
      "duration": 8,
      "album": ""
    },
    "play_count": 165593,
    "digg_count": 15586,
    "comment_count": 311,
    "share_count": 298,
    "download_count": 117,
    "collect_count": 1656,
    "create_time": 1772531742,
    "anchors": null,
    "anchors_extras": "",
    "is_ad": false,
    "commerce_info": {
      "adv_promotable": false,
      "auction_ad_invited": false,
      "branded_content_type": 0,
      "is_diversion_ad": 0,
      "organic_log_extra": "{\"req_id\":\"20260325155857890FA30C22889B0E7DBF\"}",
      "with_comment_filter_words": false
    },
    "commercial_video_info": "",
    "item_comment_settings": 0,
    "mentioned_users": "",
    "author": {
      "id": "7093407411964986370",
      "unique_id": "artchiist",
      "nickname": "ちい/Chii",
      "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?..."
    }
  }
}
GET/tiktok/v2/post-comments

List comments

Returns top-level comments on a video.

Parameters

Query paramTypeRequiredDescription
videoIdstringRequiredThe video ID.
Example: 7612965843596479751
countintegerOptionalItems per page. Max 50.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/post-comments?videoId=7612965843596479751" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.7009,
  "data": {
    "comments": [
      {
        "id": "7612974191419720455",
        "video_id": "7612965843596479751",
        "text": "can you be my waifu? ^ ^",
        "images": [
          "https://p19-comment-sign-sg.tiktokcdn.com/tos-alisg-i-zt8igodiya-sg/32b98b194bb94a5fbfe3e4dbf9a1b033~tplv-jj85edgx6n-image-origin.jpeg?..."
        ],
        "create_time": 1772533688,
        "digg_count": 22,
        "reply_total": 1,
        "user": {
          "id": "6991419942752486426",
          "region": "PH",
          "sec_uid": "MS4wLjABAAAAEvD4ZLM54Ugm89hsybssOqT0TR5KZUA2KXGcXRMe8PVb7LQp7Op7KUelQKKOnUje",
          "unique_id": "dohrehnvrse",
          "nickname": "D O H R E H N",
          "signature": "アニメの大ファン",
          "avatar": "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/b56e489e41ef69fea1075f402aee4011~tplv-tiktokx-cropcenter-q:100:100:q70.webp?...",
          "verified": false,
          "secret": false,
          "aweme_count": 0,
          "following_count": 0,
          "follower_count": 0,
          "favoriting_count": 0,
          "total_favorited": 0,
          "ins_id": "",
          "youtube_channel_title": "",
          "youtube_channel_id": "",
          "twitter_name": "",
          "twitter_id": ""
        },
        "status": 1
      }
    ],
    "total": 311,
    "cursor": 10,
    "hasMore": true
  }
}
GET/tiktok/v2/post-comment-replies

List comment replies

Returns replies to one comment.

Parameters

Query paramTypeRequiredDescription
videoIdstringRequiredThe video the comment belongs to.
Example: 7612965843596479751
commentIdstringRequiredThe comment ID, from List comments.
Example: 7612966844110914334
countintegerOptionalItems per page. Max 50.
Example: 20
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/post-comment-replies?videoId=7612965843596479751&commentId=7612966844110914334" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.7061,
  "data": {
    "comments": [
      {
        "id": "7612967610280805138",
        "video_id": "7612965843596479751",
        "text": "Thx𓀠𓀠",
        "images": [],
        "create_time": 1772532161,
        "digg_count": 35,
        "user": {
          "id": "7093407411964986370",
          "region": "JP",
          "sec_uid": "MS4wLjABAAAANiBD2T6ao7u2cE5Xj1zRRiVjShx-oKRUIDUFgHqmbyUkUOH-bk4iehKJ7eOsUkrJ",
          "unique_id": "artchiist",
          "nickname": "ちい/Chii",
          "signature": "𖦹ܾ 𖥧🌿⸝⋆꙳⟡.· ⋆ 🗺\n\n🪵 ɪɢ / x / ᴛʜʀᴇᴀᴅꜱ: @ artchiist\nContact▶︎ artchiist.official@gmail.com\nꜱᴜʙ→@たいやきくん(ちい)     ʙᴏyɪꜱʜ →@壱",
          "avatar": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/05fb1570b7fe0e2957d819ea183b2aa7~tplv-tiktokx-cropcenter-q:100:100:q70.webp?...",
          "verified": false,
          "secret": false,
          "aweme_count": 0,
          "following_count": 0,
          "follower_count": 0,
          "favoriting_count": 0,
          "total_favorited": 0,
          "ins_id": "",
          "youtube_channel_title": "ちい / Chii ",
          "youtube_channel_id": "UC2TBRqMZfvmyl7OELXV4GeA",
          "twitter_name": "",
          "twitter_id": ""
        },
        "status": 1
      }
    ],
    "total": 3,
    "cursor": 3,
    "hasMore": false
  }
}

Story highlights

Highlight reels saved on a user's profile.

GET/tiktok/v2/highlight/list

List a user's highlights

Returns the story highlights pinned to a user's profile.

Parameters

Query paramTypeRequiredDescription
userIdstringOne ofNumeric TikTok user ID.
Example: 6638285105437048833
secUidstringOne ofThe user's secUid, returned by Get profile.
Example: MS4wLjABAAAA...

Send userId or secUid. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/highlight/list?userId=6638285105437048833" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.2572,
  "data": [
    {
      "highlight_id": "14422591245",
      "cover": "https://p19-highlight0-sign-useast8.tiktokcdn-us.com/tos-useast8-i-m2ynv1o1us-tx2/9ca6a768e2f14e58b4701b828bc5df37~tplv-m2ynv1o1us-compat.jpeg?...",
      "count": 6,
      "title": "Life"
    }
  ]
}
GET/tiktok/v2/highlight/info

Get highlight

Returns a highlight's title, cover, and the IDs of the videos in it.

Parameters

Query paramTypeRequiredDescription
highlightIdstringRequiredThe highlight ID, from List a user's highlights.
Example: 8367703309

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/highlight/info?highlightId=8367703309" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.1536,
  "data": {
    "highlight_id": "8367703309",
    "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogfBZQeIWAJkovsUGQFbGnAPYfQvLhRPGawfrW~tplv-tiktokx-origin.jpeg?...",
    "count": 70,
    "title": "Easy Tips!",
    "aweme_ids": [
      "7640916756059540766"
    ]
  }
}
GET/tiktok/v2/highlight/posts

List highlight videos

Returns the videos in a highlight.

Parameters

Query paramTypeRequiredDescription
highlightIdstringRequiredThe highlight ID.
Example: 8367703309
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/highlight/posts?highlightId=8367703309" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.6125,
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000d9lravnog65gbo0p5epg",
        "video_id": "7668422305982303519",
        "region": "US",
        "title": "",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oYurfXqiqgIGAIGESAi1AtRBAzqr6iwYvdNCSw~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oc8rQqmveDAwaAgg62FgIjUBDIlAdCe1QMfvXE~tplv-tiktokx-origin.image?...",
        "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIU15gdtQe2mClvIQeWrdIAUBjFYSqfASAMDrE~tplv-tiktokx-shrink-aq:360:360:q75.webp?...",
        "duration": 19,
        "play": "https://v16m.tiktokcdn-us.com/7156fd3d03b3c7641bb65133a8ad7488/6a948a2f/video/tos/useast8/tos-useast8-ve-0068c004-tx2/o8RNqIfEBGUqdAtuAivYA3QqSiXgB1iCcwzIbr/...",
        "wmplay": "https://v16m.tiktokcdn-us.com/8b1656add93245c2624226185fbaa971/6a948a2f/video/tos/useast8/tos-useast8-ve-0068c002-tx2/oUvBtdfqNAiiGVzIQESgwBApuXqAY1lgBCIrih/...",
        "size": 1741076,
        "wm_size": 1581126,
        "music": "",
        "play_count": 5,
        "digg_count": 0,
        "comment_count": 0,
        "share_count": 0,
        "download_count": 0,
        "collect_count": 0,
        "create_time": 1785443713,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"202608301353001F7E5BD2EF38BF6BCBD8\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 3,
        "mentioned_users": "",
        "author": {
          "id": "6638285105437048833",
          "unique_id": "cleiamazzeo86",
          "nickname": "Cleia | TikTok Growth Coach",
          "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/1588ad533b19600220e19cb22b88edad~tplv-tiktokx-cropcenter:300:300.jpeg?..."
        },
        "is_nff_or_nr": false,
        "is_story": true,
        "is_top": 0
      }
    ],
    "cursor": 10,
    "hasMore": true
  }
}

Playlists

Playlists (TikTok calls them mixes) that creators build from their own videos.

GET/tiktok/v2/mix/list

List a user's playlists

Returns the playlists a user has created.

Parameters

Query paramTypeRequiredDescription
secUidstringOne ofThe user's secUid, returned by Get profile.
Example: MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM
userIdstringOne ofNumeric TikTok user ID.
Example: 107955
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Send secUid or userId. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/mix/list?secUid=MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.6946,
  "data": {
    "mix_list": [
      {
        "id": "7585292371022088990",
        "name": "TikTok Awards",
        "type": 1
      }
    ],
    "cursor": 3,
    "hasMore": false
  }
}
GET/tiktok/v2/mix/info

Get playlist

Returns a playlist's name, creator and video count.

Parameters

Query paramTypeRequiredDescription
urlstringRequiredPlaylist URL or playlist ID.
Example: 7516638364301265695

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/mix/info?url=7516638364301265695" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.8881,
  "data": {
    "id": "7516638364301265695",
    "name": "In The Mix",
    "type": 1,
    "creator_unique_id": "tiktok",
    "video_count": 16
  }
}
GET/tiktok/v2/mix/posts

List playlist videos

Returns the videos in a playlist.

Parameters

Query paramTypeRequiredDescription
mixIdstringRequiredThe playlist ID.
Example: 7551954991259339534
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/mix/posts?mixId=7551954991259339534" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 1.373,
  "data": {
    "videos": [
      {
        "aweme_id": "v12044gd0000d36a8f7og65g9d6s0oe0",
        "video_id": "7551591701182303543",
        "region": "US",
        "title": "Oh hey! You likey? Push the buttons, make the comments! K, today we are chit chattin about maps. Get a Road Atlas! Video series inspired by @Chris Valenti #p...",
        "content_desc": [],
        "cover": "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocPPUzcMMB3MMYk4iI4EcwapBEIL0gSAqitAy~tplv-tiktokx-dmt-logoccm:300:400:tos-useast5-i-0068-tx/ooKEqzAD...",
        "ai_dynamic_cover": "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8PiaBA4B0iOBy7MKcEIIAI3gSYzpPkqMwMUE~tplv-tiktokx-dmt-logom:tos-useast5-i-0068-tx/ooKEqzADiFpfACSALo...",
        "origin_cover": "https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ogSUZMIYPiHgkM4cB3DpiyrMIwiBEA0sBaAPE~tplv-tiktokx-360p.webp?...",
        "duration": 325,
        "play": "https://v77.tiktokcdn.com/4f53ae9918ca8d444e1b656f103fce89/69c55be6/video/tos/maliva/tos-maliva-ve-0068c799-us/osTBMBAQc3ilnEw0EkgHPiuYaMIPA4kRypiUS/?...",
        "wmplay": "https://v77.tiktokcdn.com/847b0bda396a9438a2de3fd5ad399fc1/69c55be6/video/tos/maliva/tos-maliva-ve-0068c799-us/ocPTLIBiPwQnMwyBj4gEpiUS3WMYAa0EckMAi/?...",
        "size": 39359341,
        "wm_size": 41100272,
        "music": "https://sf16-ies-music-va.tiktokcdn.com/obj/ies-music-ttp-dup-us/7551591869751364407.mp3",
        "play_count": 48224,
        "digg_count": 7433,
        "comment_count": 145,
        "share_count": 808,
        "download_count": 370,
        "collect_count": 2041,
        "create_time": 1758241991,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"202603260011128DC60ED13021E001075D\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "7220190996801274923",
        "author": {
          "id": "6778260995771040774",
          "unique_id": "bentleyhensel",
          "nickname": "Bentley Hensel",
          "avatar": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/2f5bcfa267cad8940b83d8eb8472abff~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?..."
        },
        "is_top": 0
      }
    ],
    "cursor": 10,
    "hasMore": true
  }
}

Collections

Public collections of saved videos.

GET/tiktok/v2/collection/list

List a user's collections

Returns a user's public collections.

Parameters

Query paramTypeRequiredDescription
secUidstringOne ofThe user's secUid, returned by Get profile.
Example: MS4wLjABAAAA...
userIdstringOne ofNumeric TikTok user ID.
Example: 7453595326067278894
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Send secUid or userId. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/collection/list?secUid=MS4wLjABAAAA..." \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.7386,
  "data": {
    "collection_list": [
      {
        "id": "7488553521853139758",
        "name": "gyat",
        "state": 3,
        "video_count": 18
      }
    ],
    "cursor": 1,
    "hasMore": false
  }
}
GET/tiktok/v2/collection/info

Get collection

Returns a collection's name, creator and video count.

Parameters

Query paramTypeRequiredDescription
urlstringRequiredCollection URL or collection ID.
Example: 7488553521853139758

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/collection/info?url=7488553521853139758" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.7269,
  "data": {
    "id": "7488553521853139758",
    "name": "gyat",
    "creator_user_id": "7453595326067278894",
    "creator_username": "look at collection",
    "state": 3,
    "video_count": 18
  }
}
GET/tiktok/v2/collection/posts

List collection videos

Returns the videos in a collection.

Parameters

Query paramTypeRequiredDescription
collectionIdstringRequiredThe collection ID.
Example: 7488553521853139758
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/collection/posts?collectionId=7488553521853139758" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 1.9184,
  "data": {
    "videos": [
      {
        "aweme_id": "",
        "video_id": "7387900717643681057",
        "region": "GB",
        "title": "#nike #viral #fyp #foryoupage #viralvideo #viraltiktok #virall ",
        "content_desc": [],
        "cover": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-i-photomode-euttp/0dccf25054ba4a22976b038b7489ff5b~tplv-photomode-image-cover:640:0:q70.webp?...",
        "ai_dynamic_cover": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-i-photomode-euttp/0dccf25054ba4a22976b038b7489ff5b~tplv-photomode-image-cover:640:0:q70.webp?...",
        "origin_cover": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-i-photomode-euttp/0dccf25054ba4a22976b038b7489ff5b~tplv-photomode-image-cover:640:0:q70.webp?...",
        "duration": 0,
        "play": "https://v19.tiktokcdn.com/6db5e53795e5f7a6e2f046a0452b082d/69c55de1/video/tos/no1a/tos-no1a-v-2370-no/o4eRoHsEGlIqPvImCNIMJcnFRfuwsxUPDDtBQa/?...",
        "wmplay": "https://v19.tiktokcdn.com/6db5e53795e5f7a6e2f046a0452b082d/69c55de1/video/tos/no1a/tos-no1a-v-2370-no/o4eRoHsEGlIqPvImCNIMJcnFRfuwsxUPDDtBQa/?...",
        "size": 0,
        "wm_size": 0,
        "music": "https://v19.tiktokcdn.com/6db5e53795e5f7a6e2f046a0452b082d/69c55de1/video/tos/no1a/tos-no1a-v-2370-no/o4eRoHsEGlIqPvImCNIMJcnFRfuwsxUPDDtBQa/?...",
        "play_count": 34608,
        "digg_count": 478,
        "comment_count": 7,
        "share_count": 23,
        "download_count": 46,
        "collect_count": 121,
        "create_time": 1720129688,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "auction_ad_invited": false,
          "with_comment_filter_words": false,
          "adv_promotable": false,
          "branded_content_type": 0,
          "organic_log_extra": "{\"req_id\":\"2026032600243090B337FD3BB1ED0139C9\"}",
          "is_diversion_ad": 0
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "7379195032975524897",
          "unique_id": "ur.fave497",
          "nickname": "Ur fave",
          "avatar": "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/60153abc0e3b4d02db55a25a63831c98~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?..."
        },
        "images": [
          "https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-i-photomode-euttp/0dccf25054ba4a22976b038b7489ff5b~tplv-photomode-image-v1:q70.jpeg?..."
        ],
        "is_top": 0
      }
    ],
    "cursor": 10,
    "hasMore": true
  }
}

Music

Sounds and the videos that use them.

GET/tiktok/v2/music/info

Get sound

Returns a sound's title, author, duration, audio URL and how many videos use it.

Parameters

Query paramTypeRequiredDescription
urlstringRequiredSound URL (https://www.tiktok.com/music/...) or sound ID.
Example: 7002634556977908485

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/music/info?url=7002634556977908485" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.8295,
  "data": {
    "id": "7002634556977908485",
    "title": "original sound - 🇺🇸",
    "play": "https://sf16-ies-music-va.tiktokcdn.com/obj/musically-maliva-obj/7002634676770999045.mp3",
    "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7350346788798218286~tplv-tiktokx-cropcenter:720:720.jpeg?...",
    "author": "🇺🇸",
    "original": true,
    "duration": 6,
    "album": "",
    "video_count": 1001
  }
}
GET/tiktok/v2/music/posts

List videos using a sound

Returns videos that use a sound.

Parameters

Query paramTypeRequiredDescription
musicIdstringRequiredThe sound ID.
Example: 7002634556977908485
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/music/posts?musicId=7002634556977908485" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 1.2965,
  "data": {
    "videos": [
      {
        "aweme_id": "v09044g40000c5d1kirc77uf6a6olms0",
        "video_id": "7014949174089125125",
        "region": "VE",
        "title": "Tu 4@ se quiere quedar encerrado en una habitación contigo 🙊 #yarelyly",
        "content_desc": [],
        "cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/a68fea2b2cf04086992a8a3e2a296a61~tplv-tiktokx-cropcenter-q:300:400:q72.webp?...",
        "ai_dynamic_cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/114fa5c90e98427d8dccc28b06719d0a_1633295133~tplv-tiktokx-origin.image?...",
        "origin_cover": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/8014300fd390454ea573c5bd26303448_1633295135~tplv-tiktokx-360p.webp?...",
        "duration": 7,
        "play": "https://v31-jp.tiktokcdn.com/79cfd0fdb2ecd8c0017cb9e94cb1abac/69c55911/video/tos/useast2a/tos-useast2a-ve-0068c001/02c44b704bbc47a89973defae608799f/?...",
        "wmplay": "https://v31-jp.tiktokcdn.com/8afb6f98dc4cb1e608d8996db0b19279/69c55911/video/tos/maliva/tos-maliva-ve-0068c801-us/70b68cae2d2d460ea7c00aee935d7b1a/?...",
        "size": 1122002,
        "wm_size": 1141387,
        "music": "https://v31-jp.tiktokcdn.com/e176ba1cd6c655c06942df3885f2f0fc/69cd4216/video/tos/useast2a/tos-useast2a-v-27dcd7/027a053b7f134dd89fe965442572ea58/?...",
        "play_count": 2580941,
        "digg_count": 327151,
        "comment_count": 1499,
        "share_count": 4124,
        "download_count": 11911,
        "collect_count": 11914,
        "create_time": 1633295132,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"202603260004250A5FBF94E485AB010B31\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "6764339504008446982",
          "unique_id": "yarelyly",
          "nickname": "Yarelyly",
          "avatar": "https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/ae595a5f8a00558785bd3c5d9aab598d~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?..."
        },
        "is_top": 0
      }
    ],
    "cursor": 12,
    "hasMore": 1
  }
}

Hashtags

Hashtags (TikTok calls them challenges) and their videos.

GET/tiktok/v2/challenge/info

Get hashtag

Returns a hashtag's description, view count and creator count. Pass either the ID or the name.

Parameters

Query paramTypeRequiredDescription
challengeIdstringOne ofThe hashtag ID.
Example: 33380
challengeNamestringOne ofThe hashtag name, without the #.
Example: cosplay

Send challengeId or challengeName. At least one is required.

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/challenge/info?challengeId=33380" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.8269,
  "data": {
    "id": "33380",
    "cha_name": "Cosplay",
    "desc": "#Cosplay your favorite character, and show the world your power!",
    "user_count": 44675028,
    "view_count": 406491795171,
    "is_pgcshow": false,
    "is_commerce": false,
    "is_challenge": false,
    "is_strong_music": false,
    "type": 2,
    "cover": "https://p16-sign-sg.tiktokcdn.com/tiktok-obj/8dc87afbcc425ff89c9c68e5514ddb8e.jpeg~tplv-tiktokx-origin.image?..."
  }
}
GET/tiktok/v2/challenge/posts

List hashtag videos

Returns videos tagged with a hashtag.

Parameters

Query paramTypeRequiredDescription
challengeIdstringRequiredThe hashtag ID, from Get hashtag.
Example: 33380
countintegerOptionalItems per page. Max 30.
Example: 10
cursorstringOptionalPagination cursor. Start at 0, then pass the cursor from the previous response while hasMore is true.
Example: 0
regionstringOptionalTwo-letter region code, for example US. See List regions.
Example: US

Request

cURL
curl "https://api.apidatahub.site/tiktok/v2/challenge/posts?challengeId=33380" \
  -H "x-api-key: YOUR_API_KEY"

Response 200 · application/json

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.6079,
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000d71e1e7og65imtvfq0pg",
        "video_id": "7620902461158575391",
        "region": "US",
        "title": "I just realized how many pow pows I own 😭😭😭 #cosplayprops #cosplayer #cosplay #GenshinImpact #chainsawman ",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oYAAXIAQCy0ABOH4Kwi2Bi4CIi6BDAHKlEfDDx~tplv-tiktokx-origin.image?...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oYAAXIAQCy0ABOH4Kwi2Bi4CIi6BDAHKlEfDDx~tplv-tiktokx-origin.image?...",
        "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osaIxUCEoVI9AuBR7Ai4DyigVLBizpt3APTBc~tplv-tiktokx-360p.webp?...",
        "duration": 21,
        "play": "https://v16m.tiktokcdn-us.com/2665e41e3237c0d1dfa8d8ff0ec78271/69c46876/video/tos/useast8/tos-useast8-ve-0068c003-tx2/o4FeBREIQEAp4dwfv4FVCoD6mpC3NEAbDBuRgl/...",
        "wmplay": "https://v16m.tiktokcdn-us.com/88a8b0df624add72d7cbb930a3dafe70/69c46876/video/tos/useast8/tos-useast8-ve-0068c002-tx2/ocLCBV4kIiRC973zXMgipAuEEQa4AqABP7tcy/?...",
        "size": 3113652,
        "wm_size": 2800125,
        "music": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oMl5jzLSfBAUO2BtWlhTcyMwHis5cSaxSoiIAc",
        "music_info": {
          "id": "7189151224833247234",
          "title": "Blicky",
          "play": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oMl5jzLSfBAUO2BtWlhTcyMwHis5cSaxSoiIAc",
          "cover": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/oYXhoiBosWAulEAdvSiEOsAB9Acwj4AnyzfHSC~tplv-tiktokx-cropcenter:720:720.jpeg?...",
          "author": "Fresh X Reckless",
          "original": false,
          "duration": 59,
          "album": "Blicky"
        },
        "play_count": 341389,
        "digg_count": 62364,
        "comment_count": 146,
        "share_count": 1007,
        "download_count": 133,
        "collect_count": 4670,
        "create_time": 1774379655,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20260325165736C1C2CAFE548762101945\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "6808332640475677702",
          "unique_id": "projectmoshii",
          "nickname": "projectmoshii",
          "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/f53f654939d11931c57b82e5f363ca66~tplv-tiktokx-cropcenter:300:300.jpeg?..."
        },
        "is_top": 0
      }
    ],
    "cursor": 10,
    "hasMore": true
  }
}