logoPandorLabs
social data api

TikTok logoTikTok

Profiles, videos, transcripts, comments, followers, search, songs, trending feeds and live rooms.

Creator profile1 request
Account region1 request
Audience countries26 requests
Videos in a collection1 request
Videos posted by a creator1 request
Video details1 request
Video transcript1 request+
Creator's live stream1 request
Live room details1 request
Video comments1 request
Replies to a comment1 request
Accounts a creator follows1 request
Followers of a creator1 request
Find accounts1 request
Search autocomplete1 request
Videos for a hashtag1 request
Videos for a keyword1 request
Top results for a query1 request
Popular creators1 request
Sound details1 request
Videos using a sound1 request
Trending feed by region1 request
GET/v1/tiktok/profile

Creator profile

1 request

Look up a public TikTok account by handle or user_id to get who the creator is and how big the account is. The response has a user object with display name, avatar URLs, signature (bio), verification flag, and bio link, plus a stats object with followerCount, followingCount, heartCount (total likes), and videoCount. Only account metadata comes back; the account's videos and follower list are served by other endpoints.

Query parameters

handle
string
The account's TikTok handle. Provide either this or user_id.
user_id
string
The account's TikTok user id.
cache_max_age
string
Accept a stored response up to this age. Inside that window the answer is free and comes back with cached: true and a cached_at time; past it, the request runs live for 1 request.

1d3d7d14d30d

curl "https://api.pandorlabs.com/v1/tiktok/profile" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "user": {
    "id": "6659752019493208069",
    "shortId": "",
    "uniqueId": "stoolpresidente",
    "nickname": "Dave Portnoy",
    "avatarLarger": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=58494&refresh_token=466ff0b92ed2f51170dbbdc2a30b9e9a&x-expires=1737921600&x-signature=uZnt1AjbwQ5pMTWNSV5hqw8QhMM%3D&shp=a5d4807…",
    "avatarMedium": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_720x720.jpeg?lk3s=a5d48078&nonce=18587&refresh_token=4c5e30ff3fe99ca813d9f79d74c41fb1&x-expires=1737921600&x-signature=6ropsZzca3J6jx%2BH49D%2BAgxMoe4%3D&shp=a5d48…",
    "avatarThumb": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~c5_100x100.jpeg?lk3s=a5d48078&nonce=56685&refresh_token=52483b418cbeceeaf2863a9fe0feb830&x-expires=1737921600&x-signature=xGLErTLpukZpmPcYw1ZBHJpPEbM%3D&shp=a5d48078&…",
    "signature": "El Presidente/Barstool Sports Founder.",
    "createTime": 1550594547,
    "verified": true,
    "secUid": "MS4wLjABAAAAINC_ElRR-l1RCcnEjOZhNO-9wOzAMf-YHXqRY8vvG9bEhMRa6iu23TaE3JPZYXBD",
    "ftc": false,
    "relation": 0,
    "openFavorite": false,
    "bioLink": {
      "link": "https://www.barstoolsports.com/bios/Surviving-Barstool",
      "risk": 0
    },
    "commentSetting": 0,
    "commerceUserInfo": {
      "commerceUser": false
    },
    "duetSetting": 0,
    "stitchSetting": 0,
    "privateAccount": false,
    "secret": false,
    "isADVirtual": false,
    "roomId": "",
    "uniqueIdModifyTime": 0,
    "ttSeller": false,
    "downloadSetting": 0,
    "profileTab": {
      "showMusicTab": false,
      "showQuestionTab": false,
      "showPlayListTab": true
    },
    "followingVisibility": 1,
    "recommendReason": "",
    "nowInvitationCardUrl": "",
    "nickNameModifyTime": 0,
    "isEmbedBanned": false,
    "canExpPlaylist": true,
    "profileEmbedPermission": 1,
    "language": "en",
    "eventList": [],
    "suggestAccountBind": false,
    "isOrganization": 0
  },
  "stats": {
    "followerCount": 4100000,
    "followingCount": 74,
    "heart": 190400000,
    "heartCount": 190400000,
    "videoCount": 2017,
    "diggCount": 0,
    "friendCount": 52
  },
  "itemList": []
}
GET/v1/tiktok/profile/region

Account region

1 request

Gives the region code TikTok assigns to a public account, for example US (United States) or MX (Mexico).

Query parameters

handle
stringrequired
The account's TikTok handle.
curl "https://api.pandorlabs.com/v1/tiktok/profile/region?handle=stoolpresidente" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "credits": 100,
  "handle": "stoolpresidente",
  "profile_url": "https://www.tiktok.com/@stoolpresidente",
  "region": "US"
}
GET/v1/tiktok/user/audience

Audience countries

26 requests

Breaks down a TikTok account's followers by country. The response holds audienceLocations, a list where each entry has country, countryCode, count, and percentage. Each call costs 26 requests.

Query parameters

handle
stringrequired
The account's TikTok handle.
curl "https://api.pandorlabs.com/v1/tiktok/user/audience?handle=shakira" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 26,
  "audienceLocations": [
    {
      "country": "Mexico",
      "countryCode": "MX",
      "count": 83,
      "percentage": "15.96%"
    }
  ]
}
GET/v1/tiktok/collection/videos

Videos in a collection

1 request

Lists the videos inside a public TikTok collection (TikTok also labels these playlists), given its URL. Items in videos follow TikTok's own web video object shape, with id, desc, author, stats, and video. While has_more is true, send the max_cursor you received as cursor to load the next page.

Query parameters

url
stringrequired
URL of the public TikTok collection.
cursor
string
Pagination cursor; set it to max_cursor from the prior response.
curl "https://api.pandorlabs.com/v1/tiktok/collection/videos?url=https%3A%2F%2Fwww.tiktok.com%2F%40kibblemaster808%2Fcollection%2FWant-to-go-7665668414573546258" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "collection_id": "7665668414573546258",
  "has_more": false,
  "max_cursor": "5",
  "status_code": 0,
  "status_msg": "",
  "videos": [
    {
      "AIGCDescription": "",
      "CategoryType": 116,
      "IsHDBitrate": false,
      "ShowAIGC": true,
      "anchors": [
        {
          "description": "CapCut · Video Editor",
          "type": 54
        }
      ],
      "author": {
        "id": "7506421330087576593",
        "uniqueId": "miotravelapp",
        "nickname": "miotravelapp"
      },
      "createTime": 1784185607,
      "desc": "How often do you reckon they think about the Roman Empire? 🐈‍⬛",
      "id": "7663018809392909588",
      "stats": {
        "collectCount": 18900,
        "commentCount": 359,
        "diggCount": 113000,
        "playCount": 865200,
        "shareCount": 15700
      },
      "video": {
        "duration": 68,
        "height": 1024,
        "width": 576,
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/oUYM7iBIKB1BL5CGgwAtAiwJEfLCFXAiX9IAEA~tplv-tiktokx-origin.image"
      }
    }
  ]
}
GET/v3/tiktok/profile/videos

Videos posted by a creator

1 request

Pulls a creator's posted videos, ordered by newest or most popular. Each entry in aweme_list carries aweme_id, desc (the caption), statistics (play_count, digg_count for likes, comment_count, share_count, collect_count for saves), and video (cover image, duration, download URLs). To page forward, send the max_cursor from the last response. When an account that clearly has videos comes back empty, retry with region=US or another fitting two-letter country code.

Query parameters

handle
stringrequired
The account's TikTok handle.
user_id
string
The account's TikTok user id; responses are quicker when you supply it.
sort_by
string
Ordering of the returned videos.

latestpopular

max_cursor
string
Pagination cursor; use max_cursor from the prior response.
region
string
Two-letter country code to localise results, GB when omitted. Try US or another relevant code to see videos available in that country.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v3/tiktok/profile/videos?handle=stoolpresidente" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "aweme_list": [
    {
      "aweme_id": "7517114944362499342",
      "desc": "You can say whatever you want about the WNBA is but it’s never boring",
      "desc_language": "en",
      "region": "US",
      "statistics": {
        "aweme_id": "7517114944362499342",
        "collect_count": 1565,
        "comment_count": 587,
        "digg_count": 59605,
        "download_count": 178,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 559925,
        "repost_count": 0,
        "share_count": 3424,
        "whatsapp_share_count": 7
      },
      "video": {
        "CoverTsp": 140.193500922967,
        "ai_dynamic_cover": {
          "uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=2a5a8daf&x-expires=1750370400&x-signature=PsejWQNXF%2BXPz%2BcpwWcdtCU9ddY%3D&t=bacd0480&ps=4f5296…"
          ],
          "url_prefix": null
        },
        "ai_dynamic_cover_bak": {
          "uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=2a5a8daf&x-expires=1750370400&x-signature=PsejWQNXF%2BXPz%2BcpwWcdtCU9ddY%3D&t=bacd0480&ps=4f5296…"
          ],
          "url_prefix": null
        },
        "animated_cover": {
          "uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=2a5a8daf&x-expires=1750370400&x-signature=PsejWQNXF%2BXPz%2BcpwWcdtCU9ddY%3D&t=bacd0480&ps=4f5296…"
          ],
          "url_prefix": null
        },
        "big_thumbs": [
          {
            "duration": 173.66667,
            "fext": "jpeg",
            "img_num": 174,
            "img_uris": [
              "tos-maliva-p-0068c799-us/ogA4IiXKCF41BKBgnU9aS9ECP7zIZsMvTIivE"
            ],
            "img_url": "",
            "img_urls": [
              "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/ogA4IiXKCF41BKBgnU9aS9ECP7zIZsMvTIivE~tplv-noop.image?x-expires=1750371666&x-signature=1vtd4zbxRXSMA9ysRa68cfDAtLM%3D"
            ],
            "img_x_len": 5,
            "img_x_size": 136,
            "img_y_len": 5,
            "img_y_size": 240,
            "interval": 1,
            "uri": ""
          }
        ],
        "bit_rate": [
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 694328,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "adapt_lower_720_2",
            "is_bytevc1": 2,
            "play_addr": {
              "data_size": 15073438,
              "file_cs": "c:0-144831-d8fd",
              "file_hash": "bade4c49b717e85095bf288836f2cf41",
              "height": 1280,
              "uri": "v12044gd0000d192fcnog65ouluk5f60",
              "url_key": "v12044gd0000d192fcnog65ouluk5f60_bytevc2_720p_694328",
              "url_list": [
                "https://v45.tiktokcdn-eu.com/e026c66342e50c03deeb909ecf672f65/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oQOIKCXpeQMxlHgA9YwA8fQqQkIfj3UHkctEaC/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&…",
                "https://v19.tiktokcdn-eu.com/a0bbafb1a81b3f9bf00b6e80dcf95092/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oQOIKCXpeQMxlHgA9YwA8fQqQkIfj3UHkctEaC/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&…"
              ],
              "url_prefix": null,
              "width": 720
            },
            "quality_type": 14,
            "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 264024}, {\\\"time\\\": 2, \\\"offset\\\": 330253}, {\\\"time\\\": 3, \\\"offset\\\": 403843}, {\\\"time\\\": 4, \\\"offset\\\": 488694}, {\\\"time\\\": 5, \\\"offset\\\": 579736}, {\\\"time\\\": 10, \\\"offset\\\": 996199}]\",\"mvmaf\":\"{…"
          }
        ],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": [
            {
              "caption_format": "webvtt",
              "caption_length": 2908,
              "cla_subtitle_id": 7517115695181434000,
              "complaint_id": 7517115695181434000,
              "expire": 1752877266,
              "is_auto_generated": true,
              "is_original_caption": true,
              "lang": "eng-US",
              "language_code": "en",
              "language_id": 2,
              "source_tag": "trantor,vv_counter,",
              "sub_id": -1038776546,
              "sub_version": "1",
              "subtitle_type": 1,
              "translation_type": 0,
              "translator_id": 0,
              "url": "https://v16-cla.tiktokcdn.com/60e8a5e0d717490c9dbed68c8634a71e/687ac8d2/video/tos/maliva/tos-maliva-v-0068c799-us/62a5670f178245afb69f54becd90c657/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7…",
              "url_list": [
                "https://v16-cla.tiktokcdn.com/60e8a5e0d717490c9dbed68c8634a71e/687ac8d2/video/tos/maliva/tos-maliva-v-0068c799-us/62a5670f178245afb69f54becd90c657/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7…",
                "https://v19-cla.tiktokcdn.com/edb0dca1f663541ce8d23d8e6bd51a4e/687ac8d2/video/tos/maliva/tos-maliva-v-0068c799-us/62a5670f178245afb69f54becd90c657/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7…"
              ],
              "variant": "big_caption"
            }
          ],
          "captions_type": 2,
          "creator_edited_caption_id": 0,
          "enable_auto_caption": 0,
          "has_original_audio": 1,
          "hide_original_caption": false,
          "no_caption_reason": 0,
          "original_language_info": {
            "can_translate_realtime": false,
            "can_translate_realtime_skip_translation_lang_check": true,
            "first_subtitle_time": 340,
            "is_burnin_caption": false,
            "lang": "eng-US",
            "language_code": "en",
            "language_id": 2,
            "original_caption_type": 1
          },
          "vertical_positions": null
        },
        "cover": {
          "height": 720,
          "uri": "tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI",
          "url_list": [
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI~tplv-tiktokx-cropcenter-q:300:400:q72.heic?dr=9232&refresh_token=e9f72667&x-expires=1750370400&x-signature=ASUnIL%2BG4pudjttwvChahXtZEW4%3D&t=bacd…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "cover_is_custom": true,
        "did_profile_labels": "",
        "download_addr": {
          "data_size": 24637995,
          "file_cs": "c:0-143697-b9bb",
          "height": 720,
          "uri": "v12044gd0000d192fcnog65ouluk5f60",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/a304184e3539ff8ceb2bcea1b5cd67f6/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/osMffQHg9IKplXhIekq8xUpGsKuYCjAqSQQEAH/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "download_no_watermark_addr": {
          "data_size": 23315651,
          "file_cs": "c:0-143697-b9bb",
          "file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
          "height": 1024,
          "uri": "v12044gd0000d192fcnog65ouluk5f60",
          "url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/c8fc49d58f379d7e3ea4a564a2ddbde2/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&c…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "duration": 173675,
        "dynamic_cover": {
          "height": 720,
          "uri": "tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F~tplv-tiktokx-origin.image?dr=9229&refresh_token=e20935f0&x-expires=1750370400&x-signature=%2FbtL8pYPrWExQyGJg5RtZyYoL0w%3D&t=bacd0480&ps=4f5296ae…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "has_watermark": true,
        "height": 1024,
        "is_bytevc1": 0,
        "is_callback": true,
        "is_long_video": 1,
        "meta": "{\"LoudnessRange\":\"4.2\",\"LoudnessRangeEnd\":\"-15.5\",\"LoudnessRangeStart\":\"-19.7\",\"MaximumMomentaryLoudness\":\"-9.6\",\"MaximumShortTermLoudness\":\"-14\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"MaximumMomentaryLoudness\\\":-9.6,\\\"MaximumShortTermLoudness\\…",
        "misc_download_addrs": "{\"suffix_scene\":{\"uri\":\"v12044gd0000d192fcnog65ouluk5f60\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/6c7c8708936435dba8b7b2b12ca777ec/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=M0Bz…",
        "need_set_token": false,
        "origin_cover": {
          "height": 720,
          "uri": "tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=19df3a47&x-expires=1750370400&x-signature=OQr8OiFdm5ns29aFllaVRuNSYI4%3D&t=bacd0480&ps=d97f9a4f&sh…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "play_addr": {
          "data_size": 23315651,
          "file_cs": "c:0-143697-b9bb",
          "file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
          "height": 1024,
          "uri": "v12044gd0000d192fcnog65ouluk5f60",
          "url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/c8fc49d58f379d7e3ea4a564a2ddbde2/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&c…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "play_addr_bytevc1": {
          "data_size": 13687862,
          "file_cs": "c:0-144445-e93b",
          "file_hash": "2758eda4b7836458bd1d717a50e4625c",
          "height": 1024,
          "uri": "v12044gd0000d192fcnog65ouluk5f60",
          "url_key": "v12044gd0000d192fcnog65ouluk5f60_bytevc1_540p_630504",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/40a7c7ce8a5412baec20ec1ed1070059/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/oIekjEYsQQkaIGHHWCpXd69QIUMgqZAKlA8e2f/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "play_addr_h264": {
          "data_size": 23315651,
          "file_cs": "c:0-143697-b9bb",
          "file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
          "height": 1024,
          "uri": "v12044gd0000d192fcnog65ouluk5f60",
          "url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/c8fc49d58f379d7e3ea4a564a2ddbde2/68548d52/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=M0BzMzU8OGYpNzo5Zi5wIzEuLjpkNDQwOg%3D%3D&ch=0&cr=13&dr=0&er=0&lr=all&net=0&c…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "ratio": "540p",
        "source_HDR_type": 0,
        "tags": null,
        "vid_profile_labels": "{\"tier3\":\"10059\"}",
        "video_model": "",
        "width": 576
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "account_region": "",
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "apple_account": 0,
        "authority_status": 0,
        "avatar_168x168": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/7310178711609032710",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/7310178711609032710",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/7310178711609032710",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/7310178711609032710",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_meta_info_list": [
          {
            "avatar_category": 6,
            "avatar_meta_info": {}
          }
        ],
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/7310178711609032710",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=PUBLISH&sc=avatar&shcp=132edbea&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-maliva-avt-0068/7310178711609032710",
        "aweme_count": 2135,
        "bind_phone": "",
        "bold_fields": null,
        "can_message_follow_status_list": [
          0
        ],
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": [],
        "create_time": 0,
        "custom_verify": "Account verificato",
        "cv_level": "",
        "download_prompt_ts": 0,
        "download_setting": 0,
        "duet_setting": 0,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "events": null,
        "fake_data_info": {},
        "favoriting_count": 174,
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 4424699,
        "follower_status": 0
      },
      "create_time": 1750214725,
      "is_ad": false,
      "is_eligible_for_commission": true,
      "is_paid_partnership": false,
      "create_time_utc": "2025-09-03T18:37:38.000Z",
      "url": "https://www.tiktok.com/@branttakes/video/7545933721589910798",
      "shop_product_url": "https://www.tiktok.com/shop/pdp/1729494515984797858"
    }
  ],
  "max_cursor": 1748286476000
}
GET/v2/tiktok/video

Video details

1 request

Returns everything about one TikTok video from its URL: metadata, engagement, and the transcript on request. The aweme_detail object includes desc (caption), statistics (play_count, digg_count for likes, comment_count, share_count, collect_count), video URLs, author, and music; with get_transcript=true a WEBVTT transcript is added. For a watermark-free file, prefer aweme_detail.video.download_no_watermark_addr.url_list[0] when present. If that field is absent and aweme_detail.video.has_watermark is false, aweme_detail.video.play_addr.url_list[0] is already clean. When download_no_watermark_addr is absent and has_watermark is true, TikTok supplied no watermark-free URL for the video.

Query parameters

url
stringrequired
URL of the TikTok video.
get_transcript
boolean
When true, includes the video's transcript.
region
string
Two-letter country code (US, GB, FR, and so on) to localise results. Use the video's home country, for example 'PH' for videos from the Philippines.
trim
boolean
When true, returns a slimmer response.
cache_max_age
string
Accept a stored response up to this age. Inside that window the answer is free and comes back with cached: true and a cached_at time; past it, the request runs live for 1 request.

1d3d7d14d30d

curl "https://api.pandorlabs.com/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40randomspamvideos25%2Fvideo%2F7251387037834595630" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "aweme_detail": {
    "aweme_id": "7517114944362499342",
    "desc": "You can say whatever you want about the WNBA is but it’s never boring",
    "desc_language": "en",
    "region": "US",
    "statistics": {
      "aweme_id": "7517114944362499342",
      "collect_count": 1633,
      "comment_count": 618,
      "digg_count": 62522,
      "download_count": 190,
      "forward_count": 0,
      "lose_comment_count": 0,
      "lose_count": 0,
      "play_count": 589745,
      "repost_count": 0,
      "share_count": 3585,
      "whatsapp_share_count": 8
    },
    "video": {
      "CoverTsp": 140.193500922967,
      "ai_dynamic_cover": {
        "uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
        "url_list": [
          "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae…"
        ],
        "url_prefix": null
      },
      "ai_dynamic_cover_bak": {
        "uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
        "url_list": [
          "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae…"
        ],
        "url_prefix": null
      },
      "animated_cover": {
        "uri": "tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H",
        "url_list": [
          "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0QcUfjIQHA8EQBSBQtAfYqKkCX9eKpMEOHl1H~tplv-tiktokx-origin.image?dr=9229&refresh_token=1d205fbb&x-expires=1750374000&x-signature=3iaAsuyxWAl52xo73%2FzWWOnRFBo%3D&t=bacd0480&ps=4f5296ae…"
        ],
        "url_prefix": null
      },
      "bit_rate": [
        {
          "HDR_bit": "",
          "HDR_type": "",
          "bit_rate": 694328,
          "dub_infos": null,
          "fid_profile_labels": "",
          "fps": 30,
          "gear_name": "adapt_lower_720_2",
          "is_bytevc1": 2,
          "play_addr": {
            "data_size": 15073438,
            "file_cs": "c:0-144831-d8fd",
            "file_hash": "bade4c49b717e85095bf288836f2cf41",
            "height": 1280,
            "uri": "v12044gd0000d192fcnog65ouluk5f60",
            "url_key": "v12044gd0000d192fcnog65ouluk5f60_bytevc2_720p_694328",
            "url_list": [
              "https://v45.tiktokcdn-eu.com/181058a705ab5b81ac71c7ec81b7d91c/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oQOIKCXpeQMxlHgA9YwA8fQqQkIfj3UHkctEaC/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "quality_type": 14,
          "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 264024}, {\\\"time\\\": 2, \\\"offset\\\": 330253}, {\\\"time\\\": 3, \\\"offset\\\": 403843}, {\\\"time\\\": 4, \\\"offset\\\": 488694}, {\\\"time\\\": 5, \\\"offset\\\": 579736}, {\\\"time\\\": 10, \\\"offset\\\": 996199}]\",\"mvmaf\":\"{…"
        }
      ],
      "bit_rate_audio": [],
      "cdn_url_expired": 0,
      "cover": {
        "height": 720,
        "uri": "tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI",
        "url_list": [
          "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oUKFS4HhaMvXICUEIc1AgN7HEs9nivBIBC4iI~tplv-tiktokx-cropcenter-q:300:400:q72.heic?dr=9232&refresh_token=df2ee5c4&x-expires=1750374000&x-signature=F1wskCOFUKVbHMDT%2BjC%2F4ioi3Vw%3D&t=ba…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "cover_is_custom": true,
      "did_profile_labels": "",
      "download_addr": {
        "data_size": 24637995,
        "file_cs": "c:0-143697-b9bb",
        "height": 720,
        "uri": "v12044gd0000d192fcnog65ouluk5f60",
        "url_list": [
          "https://v45.tiktokcdn-eu.com/3d049ec218f82d1ad3e7e9ee12cccb39/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/osMffQHg9IKplXhIekq8xUpGsKuYCjAqSQQEAH/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "download_no_watermark_addr": {
        "data_size": 23315651,
        "file_cs": "c:0-143697-b9bb",
        "file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
        "height": 1024,
        "uri": "v12044gd0000d192fcnog65ouluk5f60",
        "url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
        "url_list": [
          "https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%…"
        ],
        "url_prefix": null,
        "width": 576
      },
      "duration": 173675,
      "dynamic_cover": {
        "height": 720,
        "uri": "tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F",
        "url_list": [
          "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oIQCgk8IAMQfKA2ewUdC8XIH9HktlgfqjEpU2F~tplv-tiktokx-origin.image?dr=9229&refresh_token=949e4dcb&x-expires=1750374000&x-signature=nMjefiiuLg8GZ9QABQL3YDVaKHo%3D&t=bacd0480&ps=4f5296ae&s…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "has_watermark": true,
      "height": 1024,
      "is_bytevc1": 0,
      "is_callback": true,
      "is_long_video": 1,
      "meta": "{\"LoudnessRange\":\"4.2\",\"LoudnessRangeEnd\":\"-15.5\",\"LoudnessRangeStart\":\"-19.7\",\"MaximumMomentaryLoudness\":\"-9.6\",\"MaximumShortTermLoudness\":\"-14\",\"Version\":\"2\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-19.7,\\\"MaximumShortTermLoudness\\\":-14…",
      "misc_download_addrs": "{\"suffix_scene\":{\"uri\":\"v12044gd0000d192fcnog65ouluk5f60\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/eb4b1ebe709b6ec8bb4b8e40c7c1d919/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oMQjUpISHhGffZMKCA8YXqAkg9Qe0xUlHEpQRI/?a=1233&bti=OUBz…",
      "need_set_token": false,
      "origin_cover": {
        "height": 720,
        "uri": "tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI",
        "url_list": [
          "https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooyQIJ3YQXAq5pBAQjeMklUKEeUk9HQk5Hf8CI~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=4649c5e4&x-expires=1750374000&x-signature=NcVGrk0KTmDoN6EaPa%2Fn05CEyq4%3D&t=bacd0480&ps=d97f9a4f&…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "play_addr": {
        "data_size": 23315651,
        "file_cs": "c:0-143697-b9bb",
        "file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
        "height": 1024,
        "uri": "v12044gd0000d192fcnog65ouluk5f60",
        "url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
        "url_list": [
          "https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%…"
        ],
        "url_prefix": null,
        "width": 576
      },
      "play_addr_bytevc1": {
        "data_size": 13687862,
        "file_cs": "c:0-144445-e93b",
        "file_hash": "2758eda4b7836458bd1d717a50e4625c",
        "height": 1024,
        "uri": "v12044gd0000d192fcnog65ouluk5f60",
        "url_key": "v12044gd0000d192fcnog65ouluk5f60_bytevc1_540p_630504",
        "url_list": [
          "https://v45.tiktokcdn-eu.com/6f7ee0f58f0c58d39943fdbb31ca96b5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/oIekjEYsQQkaIGHHWCpXd69QIUMgqZAKlA8e2f/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0…"
        ],
        "url_prefix": null,
        "width": 576
      },
      "play_addr_h264": {
        "data_size": 23315651,
        "file_cs": "c:0-143697-b9bb",
        "file_hash": "dc0d3f39653d5d1383f62d1c61ad9d5e",
        "height": 1024,
        "uri": "v12044gd0000d192fcnog65ouluk5f60",
        "url_key": "v12044gd0000d192fcnog65ouluk5f60_h264_540p_1073989",
        "url_list": [
          "https://v45.tiktokcdn-eu.com/c0fb0c4c63ed4f5076758092137da3f5/68549d47/video/tos/maliva/tos-maliva-ve-0068c799-us/o4u9CaIEvIMFiAHihBB4ng4sXQUWSFK1E1PvI/?a=1233&bti=OUBzOTg7QGo6OjZAL3AjLTAzYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%…"
        ],
        "url_prefix": null,
        "width": 576
      },
      "ratio": "540p",
      "source_HDR_type": 0,
      "tags": null,
      "vid_profile_labels": "{\"tier3\":\"10059\"}",
      "video_model": "",
      "width": 576
    },
    "author": {
      "accept_private_policy": false,
      "account_labels": null,
      "account_region": "",
      "ad_cover_url": null,
      "advance_feature_item_order": null,
      "advanced_feature_info": null,
      "apple_account": 0,
      "authority_status": 0,
      "avatar_168x168": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/7310178711609032710",
        "url_list": [
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_larger": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/7310178711609032710",
        "url_list": [
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_thumb": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/7310178711609032710",
        "url_list": [
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/7310178711609032710~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=AWEME_DETAIL&sc=avatar&shcp=1d1a97fc&shp=45126217&t=223449c4"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_uri": "tos-maliva-avt-0068/7310178711609032710",
      "aweme_count": 0,
      "bind_phone": "",
      "bold_fields": null,
      "can_message_follow_status_list": [
        0
      ],
      "can_set_geofencing": null,
      "cha_list": null,
      "comment_filter_status": 0,
      "comment_setting": 0,
      "commerce_user_level": 0,
      "cover_url": [],
      "create_time": 0,
      "custom_verify": "Account verificato",
      "cv_level": "",
      "download_prompt_ts": 0,
      "download_setting": 0,
      "duet_setting": 0,
      "enabled_filter_all_comments": false,
      "enterprise_verify_reason": "",
      "events": null,
      "fake_data_info": {},
      "favoriting_count": 0,
      "fb_expire_time": 0,
      "follow_status": 0,
      "follower_count": 0,
      "follower_status": 0,
      "followers_detail": null,
      "following_count": 0,
      "friends_status": 0
    },
    "create_time": 1750214725,
    "is_ad": false,
    "is_eligible_for_commission": true,
    "is_paid_partnership": false,
    "create_time_utc": "2025-09-03T18:37:38.000Z",
    "url": "https://www.tiktok.com/@branttakes/video/7545933721589910798",
    "shop_product_url": "https://www.tiktok.com/shop/pdp/1729494515984797858"
  },
  "transcript": "WEBVTT\n\n\n00:00:00.340 --> 00:00:01.860\nAll right. W N B A. Rant.\n\n00:00:01.861 --> 00:00:02.741\nI know. It's like,\n\n00:00:02.742 --> 00:00:03.261\noh, Dave,\n\n00:00:03.262 --> 00:00:04.941\nwe don't wanna hear about you in the W N B A.\n\n00:00:…"
}
GET/v1/tiktok/video/transcript

Video transcript

1 request11 requests when the AI fallback transcribes the video

Retrieves the captions or subtitles a TikTok video already has, given its URL. You get back id, url, and transcript, a WEBVTT string of timestamped segments. Video length does not matter when a transcript already exists. Setting use_ai_as_fallback=true lets AI transcribe the video when none exists; that path only handles videos of 2 minutes or less and adds 10 requests.

Query parameters

url
stringrequired
URL of the TikTok video.
language
string
Two-letter language code for the transcript, such as 'en', 'es', 'fr', 'de', 'it', 'ja', 'ko', or 'zh'.
use_ai_as_fallback
string
Pass 'true' to have AI transcribe the video when no transcript exists. This path is capped at 2 minutes of video and adds 10 requests, while existing transcripts work at any length.
curl "https://api.pandorlabs.com/v1/tiktok/video/transcript?url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7499229683859426602" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "id": "7499229683859426602",
  "url": "https://www.tiktok.com/@stoolpresidente/video/7499229683859426602",
  "transcript": "WEBVTT\n\n\n00:00:00.120 --> 00:00:01.840\nAlright, pizza review time.\n\n00:00:01.841 --> 00:00:03.761\nSal's Pizza Factory. Oh,\n\n00:00:03.762 --> 00:00:05.721\nit's Fucking Corn. We're in Charlotte.\n\n00:00:05.722 --> 00:00:07.861\nAlright man, any…"
}
GET/v1/tiktok/user/live

Creator's live stream

1 request

Tells you whether a TikTok account is broadcasting right now and describes its live room. Read the top-level is_live boolean rather than interpreting TikTok's numeric status codes. The response also contains liveRoomUserInfo (nickname, avatar, followerCount, roomId) and liveRoom (title, startTime, status, liveRoomStats with enterCount and userCount, and streamData with playback URLs at several qualities).

Query parameters

handle
stringrequired
The account's TikTok handle.
curl "https://api.pandorlabs.com/v1/tiktok/user/live?handle=thejustalex" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "is_live": true,
  "liveRoomUserInfo": {
    "avatarLarger": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=c39a7259&x-expires=1751918400&x-signature=2Q%2F13wVO%2F%2F5OFBDinwMuULyBINc%3…",
    "avatarMedium": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=7da1901a&x-expires=1751918400&x-signature=WDVM4wsOBsWKV04aQNYqBRnllxQ%3D&t=4d5b…",
    "avatarThumb": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=baf34a19&x-expires=1751918400&x-signature=fWClWNGmv23Nggnk7gE17yC3D78%3D&t=4d5b…",
    "id": "6742945285876515845",
    "nickname": "JustAlex",
    "secUid": "MS4wLjABAAAA3_8rhYkKsHyYO45EzOF7RBQJRs1EaHBqHFtYIaz3aka44bMVgCLONvFaXPkddJei",
    "secret": false,
    "uniqueId": "thejustalex",
    "verified": false,
    "roomId": "7523685855395842871",
    "signature": "🔴LIVE EVERYDAY🔴\n—\n📧rainzbizemail@gmail.com📧\nSocials 👇",
    "status": 2,
    "followStatus": 0,
    "followingCount": 1225,
    "followerCount": 601562
  },
  "liveRoom": {
    "coverUrl": "https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b169e9223700dc8d20d327510eb47f94~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=524467bc&x-expires=1751918400&x-signature=dYrBW7UodqMDScfs4YMnmfK24Zg%3D&t=4d5b…",
    "squareCoverImg": "https://p16-webcast.tiktokcdn-us.com/webcast-oci-tx/98159d71f96ce0a13c8234c485082e14~tplv-obj.image",
    "title": "6'13 Grateful Streamer",
    "startTime": 1751744708,
    "status": 2,
    "paidEvent": {
      "event_id": 0,
      "paid_type": 0
    },
    "liveSubOnly": 0,
    "liveRoomMode": 6,
    "hashTagId": 5,
    "gameTagId": 1983,
    "liveRoomStats": {
      "enterCount": 30960,
      "userCount": 804
    },
    "streamData": {
      "pull_data": {
        "options": {
          "default_quality": {
            "icon_type": 0,
            "level": 0,
            "name": "540p",
            "resolution": "",
            "sdk_key": "sd",
            "v_codec": ""
          },
          "qualities": [
            {
              "icon_type": 6,
              "level": 10,
              "name": "Original",
              "resolution": "",
              "sdk_key": "origin",
              "v_codec": ""
            }
          ],
          "show_quality_button": false
        },
        "stream_data": "{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2137}}\\\"}\",\"user_count…"
      }
    },
    "streamId": "3576322110592123836",
    "multiStreamScene": 0,
    "multiStreamSource": 0,
    "hevcStreamData": {
      "pull_data": {
        "options": {
          "default_quality": {
            "icon_type": 0,
            "level": 0,
            "name": "540p",
            "resolution": "",
            "sdk_key": "sd",
            "v_codec": ""
          },
          "qualities": [
            {
              "icon_type": 6,
              "level": 10,
              "name": "Original",
              "resolution": "",
              "sdk_key": "origin",
              "v_codec": ""
            }
          ],
          "show_quality_button": false
        },
        "stream_data": "{\"common\":{\"session_id\":\"173-20250705204222D51B254BA2C5D264202E\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83506(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2137}}\\\"}\",\"user_count…"
      }
    }
  }
}
GET/v1/tiktok/live

Live room details

1 request

Returns a compact summary of one TikTok live room. Call /v1/tiktok/user/live first to obtain the room_id, and if you only know the handle, call /v1/tiktok/profile to get the numeric user.id. It differs from /v1/tiktok/user/live in that it relies on a separate upstream request and trims the output to the key fields: room_id, like_count, viewer_count, status, title, cover_url, and owner.

Query parameters

room_id
stringrequired
ID of the live room, found in liveRoomUserInfo.roomId or liveRoom.id from /v1/tiktok/user/live while the account is live.
user_id
stringrequired
Numeric TikTok user id of the broadcaster, found in user.id from /v1/tiktok/profile.
curl "https://api.pandorlabs.com/v1/tiktok/live?room_id=7523685855395842871&user_id=6742945285876515845" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "room_id": "7523685855395842871",
  "like_count": 4317,
  "viewer_count": 268,
  "status": "live",
  "title": "6'13 Grateful Streamer",
  "cover_url": "https://p16-webcast.tiktokcdn-us.com/webcast/cover.jpeg",
  "owner": {
    "id": "6742945285876515845",
    "username": "thejustalex",
    "display_name": "JustAlex"
  }
}
GET/v1/tiktok/video/comments

Video comments

1 request

Collects the comments left on a TikTok video, identified by URL. Every item in comments has text, digg_count (likes), reply_comment_total, create_time, plus user (the commenter's unique_id and nickname); total gives the overall comment count. Send the cursor from the prior response to get more.

Query parameters

url
stringrequired
URL of the TikTok video.
cursor
number
Pagination cursor; use cursor from the prior response.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v1/tiktok/video/comments?url=<url>" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "comments": [
    {
      "aweme_id": "7517114944362499342",
      "text": "DAVE BUY A TEAM",
      "user": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "uri": "tos-useast5-avt-0068-tx/446370164449562d1008889225530f6d",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/446370164449562d1008889225530f6d~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=662e5e49&x-expires=1750374000&x-signature=a6DJxD8%2BkNeZRm7Sfpjc55T8mhE%3D&t=4d5b0474&ps=13…"
          ],
          "url_prefix": null
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "",
        "enterprise_verify_reason": "",
        "events": null,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "Robert Lessner",
        "platform_sync_info": null,
        "relative_users": null,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAA9rB4k_Ei3NexA5p2lb8naaa4LTgNCOdY0W9NHVo63016XkdsuZgvjkgolBnUkG8W",
        "shield_edit_field_info": null,
        "type_label": null,
        "uid": "6958917445306926086",
        "unique_id": "dimebag.duster",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      },
      "create_time": 1750216932,
      "reply_comment_total": 14,
      "digg_count": 3322,
      "comment_language": "en"
    }
  ],
  "cursor": 20,
  "total": 1114
}
GET/v1/tiktok/video/comment/replies

Replies to a comment

1 request

Lists the replies under one TikTok comment, identified by its ID. Each item in comments includes text, user details, and create_time. Send the cursor from the prior response to get more.

Query parameters

comment_id
stringrequired
ID of the parent comment, the cid value from the comments endpoint.
url
stringrequired
URL of the TikTok video, the same url used with the comments endpoint.
cursor
number
Pagination cursor; use cursor from the prior response.
curl "https://api.pandorlabs.com/v1/tiktok/video/comment/replies?comment_id=7623828115408274207&url=https%3A%2F%2Fwww.tiktok.com%2F%40stoolpresidente%2Fvideo%2F7623818255903329566" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "comments": [
    {
      "aweme_id": "7623818255903329566",
      "cid": "7623874021293212447",
      "collect_stat": 0,
      "comment_language": "en",
      "comment_post_item_ids": null,
      "create_time": 1775071525,
      "digg_count": 3,
      "fold_status": 0,
      "image_list": null,
      "is_author_digged": false,
      "is_comment_translatable": true,
      "is_high_purchase_intent": false,
      "label_list": null,
      "no_show": false,
      "reply_comment": null,
      "reply_id": "7623828115408274207",
      "reply_to_reply_id": "0",
      "share_info": {
        "acl": {
          "code": 1,
          "extra": "{\"is_share_handler_failed\":\"1\"}"
        },
        "desc": "",
        "title": "",
        "url": ""
      },
      "status": 1,
      "stick_position": 0,
      "text": "Brilliant",
      "text_extra": [],
      "thread_has_more": false,
      "thread_id": 4,
      "trans_btn_style": 0,
      "user": {
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "avatar_thumb": {
          "uri": "tos-useast5-avt-0068-tx/93d55c77c594984967fe43b4a657912e",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/93d55c77c594984967fe43b4a657912e~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=21a0ec0e&x-expires=1775250000&x-signature=vqdvvwo3gQAIiccDNbj%2B3KBK27Q%3D&t=4d5b047…"
          ],
          "url_prefix": null
        },
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "cover_url": null,
        "custom_verify": "",
        "enterprise_verify_reason": "",
        "events": null,
        "followers_detail": null,
        "geofencing": null,
        "homepage_bottom_toast": null,
        "item_list": null,
        "mutual_relation_avatars": null,
        "need_points": null,
        "nickname": "Katy",
        "platform_sync_info": null,
        "predicted_age_group": "4",
        "relative_users": null,
        "search_highlight": null,
        "sec_uid": "MS4wLjABAAAAGQCGrZCPx6snYndsBtuAIif17vTOTEfDZ9qd_9yCZlhb3iU0q19qTWYg8xXSwMng",
        "shield_edit_field_info": null,
        "type_label": null,
        "uid": "6813803505255154693",
        "unique_id": "katylynnm",
        "user_profile_guide": null,
        "user_tags": null,
        "white_cover_url": null
      },
      "user_buried": false,
      "user_digged": 0
    }
  ],
  "cursor": 6,
  "extra": {
    "fatal_item_ids": [],
    "logid": "2026040221232018E558310EA56D7D6188",
    "now": 1775165000000
  },
  "has_more": 1,
  "log_pb": {
    "impr_id": "2026040221232018E558310EA56D7D6188"
  },
  "status_code": 0,
  "status_msg": "",
  "total": 36
}
GET/v1/tiktok/user/following

Accounts a creator follows

1 request

Lists the accounts a TikTok user follows, looked up by handle. Each entry in followings has nickname, unique_id, uid, follower_count, following_count, signature, and avatar URLs, and total reports the full count. Page forward with the min_time value from the prior response.

Query parameters

handle
stringrequired
The account's TikTok handle.
min_time
number
Pagination value; use min_time from the prior response.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v1/tiktok/user/following?handle=stoolpresidente" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "followings": [
    {
      "create_time": 1748628014,
      "follower_count": 2175,
      "following_count": 10,
      "language": "en",
      "nickname": "Barstool Beach House",
      "region": "US",
      "sec_uid": "MS4wLjABAAAAbQK_EH0QRu1Wqk9mXsWvWW2dGpK1_LSiVdJx0oXtFCE_oOX8RIeGFfaYJQthUoaH",
      "signature": "Coming in August",
      "uid": "7510299285881160735",
      "unique_id": "barstoolbeachhouse",
      "avatar_medium": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/14f24ed9e7e1b1fc6764375b799c6ed7",
        "url_list": [
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/14f24ed9e7e1b1fc6764375b799c6ed7~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=a5540255&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=3031079…"
        ],
        "url_prefix": null,
        "width": 720
      }
    }
  ],
  "min_time": 1734010829,
  "total": 81
}
GET/v1/tiktok/user/followers

Followers of a creator

1 request

Lists the accounts following a TikTok user, looked up by handle or user_id. Each entry in followers has nickname, unique_id, uid, follower_count, following_count, and avatar URLs, and total reports the overall follower count. Page forward with the min_time value from the prior response.

Query parameters

handle
string
The account's TikTok handle.
user_id
string
The account's TikTok user id; responses are quicker when you supply it.
min_time
number
Pagination value; use min_time from the prior response.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v1/tiktok/user/followers" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "followers": [
    {
      "create_time": 1585489718,
      "follower_count": 319,
      "following_count": 1375,
      "language": "en",
      "nickname": "Kelsey Levens Haskin",
      "region": "US",
      "sec_uid": "MS4wLjABAAAAG-DXjA9PmiU6daPQzr9ux9Xr8EQ_SU_STIlWxqs2huXTZR94IdbY2kpoGhiSzAxn",
      "signature": "",
      "uid": "6802639142851609605",
      "unique_id": "klh723",
      "avatar_medium": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/7324817662562402310",
        "url_list": [
          "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7324817662562402310~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=ae851b19&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&…"
        ],
        "url_prefix": null,
        "width": 720
      }
    }
  ],
  "min_time": 1750289478,
  "total": 4424847
}
GET/v1/tiktok/search/users

Find accounts

1 request

Finds TikTok accounts whose name or handle matches a search term. Each entry in users contains user_info (nickname, unique_id, signature for bio, follower_count, following_count, avatar) along with related items. Send the cursor from the prior response to get more.

Query parameters

query
stringrequired
Term to match against account names and handles.
cursor
number
Pagination cursor; use cursor from the prior response.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v1/tiktok/search/users?query=<query>" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "users": [
    {
      "follower_count": 163953,
      "following_count": 63,
      "nickname": "ADRIAN",
      "sec_uid": "MS4wLjABAAAAcT5kdL_w3D2p3a3DkULhrVE6Ir17Ua1M9GZK4cnvnKxbJg3qy0xDdbaFeY260Qzz",
      "uid": "6757029651601835013",
      "unique_id": "adrianzyno",
      "avatar_medium": {
        "height": 720,
        "uri": "tos-maliva-avt-0068/60a12c00b42288dd3503cf3025165093",
        "url_list": [
          "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/60a12c00b42288dd3503cf3025165093~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=30310797&t=223449c4"
        ],
        "url_prefix": null,
        "width": 720
      }
    }
  ],
  "cursor": 30
}
GET/v1/tiktok/search/suggestions

Search autocomplete

1 request

Returns the type-ahead suggestions TikTok displays as a user enters a search. The suggestions field is a tidy list of proposed terms, each with its most relevant metadata.

Query parameters

query
stringrequired
Partial or full search text to complete.
region
string
Region code used when fetching suggestions.
curl "https://api.pandorlabs.com/v1/tiktok/search/suggestions?query=dogs" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "suggestions": [
    {
      "text": "dogs cute",
      "position": 0,
      "language": "en",
      "score": 0.011535803
    }
  ]
}
GET/v1/tiktok/search/hashtag

Videos for a hashtag

1 request

Finds TikTok videos posted under a given hashtag, handy for topic or trend research. Each entry in aweme_list has aweme_id, desc (caption), statistics (play_count, digg_count for likes, comment_count, share_count), video details, and author information. Send the cursor from the prior response to get more. TikTok sometimes repeats results across pages.

Query parameters

hashtag
stringrequired
Hashtag to look up, without the leading #.
region
string
Country to localise results. It does not limit results to videos from that country.
cursor
number
Pagination cursor; use cursor from the prior response.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v1/tiktok/search/hashtag?hashtag=<hashtag>" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "aweme_list": [
    {
      "aweme_id": "7277923990184742177",
      "desc": "best boys #friends #joeytribbiani #chandlerbing #joeyandchandler #sitcom #mecore #uscore #bromance #matthewperry #mattleblanc ",
      "desc_language": "en",
      "region": "DE",
      "statistics": {
        "aweme_id": "7277923990184742177",
        "collect_count": 385471,
        "comment_count": 94635,
        "digg_count": 2840077,
        "download_count": 1318,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 12711728,
        "repost_count": 0,
        "share_count": 614428,
        "whatsapp_share_count": 19390
      },
      "video": {
        "CoverTsp": 7.68255116568915,
        "ai_dynamic_cover": {
          "uri": "tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739",
          "url_list": [
            "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0…"
          ],
          "url_prefix": null
        },
        "ai_dynamic_cover_bak": {
          "uri": "tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739",
          "url_list": [
            "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0…"
          ],
          "url_prefix": null
        },
        "animated_cover": {
          "uri": "tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739",
          "url_list": [
            "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/5a4c497ba73c4d3f90203a4debd33196_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=c493f93a&x-expires=1750377600&x-signature=zaHE9yF93tRa0sZXJA%2FE5yrYa3I%3D&t=bacd0…"
          ],
          "url_prefix": null
        },
        "big_thumbs": [],
        "bit_rate": [
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 364924,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "adapt_540_1",
            "is_bytevc1": 1,
            "play_addr": {
              "data_size": 759407,
              "file_cs": "c:0-15397-6132",
              "file_hash": "f44716c0f1de35c8618470f551dde04b",
              "height": 576,
              "uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
              "url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_bytevc1_540p_364924",
              "url_list": [
                "https://v45.tiktokcdn-eu.com/339e98fc0becce4e1728c5ef64d69b69/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%…",
                "https://v16m.tiktokcdn-eu.com/26ed2d2ab13ba6450402fd18f3d23348/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0…"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 28,
            "video_extra": "{\"PktOffsetMap\":\"[{\\\"time\\\": 1, \\\"offset\\\": 105212}, {\\\"time\\\": 2, \\\"offset\\\": 155336}, {\\\"time\\\": 3, \\\"offset\\\": 188263}, {\\\"time\\\": 4, \\\"offset\\\": 240132}, {\\\"time\\\": 5, \\\"offset\\\": 297488}, {\\\"time\\\": 10, \\\"offset\\\": 500467}]\",\"mvmaf\":\"\"…"
          }
        ],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": null,
          "captions_type": 0,
          "creator_edited_caption_id": 0,
          "enable_auto_caption": 0,
          "has_original_audio": 0,
          "hide_original_caption": false,
          "no_caption_reason": 3,
          "vertical_positions": null
        },
        "cover": {
          "height": 720,
          "uri": "tos-useast2a-p-0037-euttp/7eb5601a4f4b4134b8321955a5ceb515_1694523738",
          "url_list": [
            "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/7eb5601a4f4b4134b8321955a5ceb515_1694523738~tplv-tiktokx-origin.image?dr=1347&refresh_token=04c0a26b&x-expires=1750377600&x-signature=D80fHwx2YQmu%2Bs7fKVs6JvfrDwo%3D&t=bacd0…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "cover_is_custom": true,
        "did_profile_labels": "",
        "download_addr": {
          "data_size": 1645666,
          "file_cs": "c:0-15212-b6fb",
          "height": 720,
          "uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/de0e8da0f33c14a280afb63dbbd7200f/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/oYBtGfE0AWGREzMHElYDeRkucMhEAlDPQQBAIR/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&c…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "download_no_watermark_addr": {
          "data_size": 1596498,
          "file_cs": "c:0-15212-b6fb",
          "file_hash": "865acc2a4a685aa6fe71256e1f7c8510",
          "height": 576,
          "uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
          "url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "duration": 16648,
        "dynamic_cover": {
          "height": 720,
          "uri": "tos-useast2a-p-0037-euttp/d1dfbab565b84a92ad94eca69e455a4c_1694523739",
          "url_list": [
            "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/d1dfbab565b84a92ad94eca69e455a4c_1694523739~tplv-tiktokx-origin.image?dr=9229&refresh_token=508a3268&x-expires=1750377600&x-signature=KsNxQZIhu4mTRZLEkpl%2FgG0WJVE%3D&t=bacd0…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "has_watermark": true,
        "height": 576,
        "is_bytevc1": 0,
        "is_callback": true,
        "meta": "{\"LoudnessRange\":\"0.7\",\"LoudnessRangeEnd\":\"-9.5\",\"LoudnessRangeStart\":\"-10.2\",\"MaximumMomentaryLoudness\":\"-7.7\",\"MaximumShortTermLoudness\":\"-9.4\",\"Version\":\"1\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-10.2,\\\"Version\\\":1,\\\"LoudnessRangeEnd…",
        "misc_download_addrs": "{\"suffix_scene\":{\"uri\":\"v0f044gc0000ck062fbc77uc8kdoc7ig\",\"url_list\":[\"https://v45.tiktokcdn-eu.com/4f9aadaa474b036d50f519f6afd2bd4d/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/o0EAztMeEhDPExJHRQlQfBRRIKRGAoGlFDFBuz/?a=1233&b…",
        "need_set_token": false,
        "origin_cover": {
          "height": 720,
          "uri": "tos-useast2a-p-0037-euttp/8645744258524a9eb63d68fac73a3fd2_1694523738",
          "url_list": [
            "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-p-0037-euttp/8645744258524a9eb63d68fac73a3fd2_1694523738~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=262a17a9&x-expires=1750377600&x-signature=1EZLLyR6gut1idQPWSTz6KJLaWk%3D&t=bacd0480…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "play_addr": {
          "data_size": 1596498,
          "file_cs": "c:0-15212-b6fb",
          "file_hash": "865acc2a4a685aa6fe71256e1f7c8510",
          "height": 576,
          "uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
          "url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "play_addr_bytevc1": {
          "data_size": 759407,
          "file_cs": "c:0-15397-6132",
          "file_hash": "f44716c0f1de35c8618470f551dde04b",
          "height": 576,
          "uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
          "url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_bytevc1_540p_364924",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/339e98fc0becce4e1728c5ef64d69b69/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o4LNPmDIQDQl9hAbjwePAS4MK1EcfEAinBGRXY/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "play_addr_h264": {
          "data_size": 1596498,
          "file_cs": "c:0-15212-b6fb",
          "file_hash": "865acc2a4a685aa6fe71256e1f7c8510",
          "height": 576,
          "uri": "v0f044gc0000ck062fbc77uc8kdoc7ig",
          "url_key": "v0f044gc0000ck062fbc77uc8kdoc7ig_h264_540p_767178",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/a99d33899bc03dd0c27ade23be118c55/6854a8e2/video/tos/useast2a/tos-useast2a-ve-0068-euttp/osjwrgDKl4DecPcABYeDQEn9EAARrtCIQibMPG/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "ratio": "540p",
        "source_HDR_type": 0,
        "tags": null,
        "vid_profile_labels": "{\"tier3\":\"10045\"}",
        "width": 576
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "account_region": "",
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "apple_account": 0,
        "authority_status": 0,
        "avatar_168x168": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-no1a-avt-0068c001-no/cf197741686b5d5513c17da87246c931",
        "aweme_count": 0,
        "bind_phone": "",
        "bold_fields": null,
        "can_message_follow_status_list": [
          2
        ],
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": [],
        "create_time": 0,
        "custom_verify": "",
        "cv_level": "",
        "download_prompt_ts": 0,
        "download_setting": 0,
        "duet_setting": 0,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "events": null,
        "fake_data_info": {},
        "favoriting_count": 0,
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 0,
        "follower_status": 0,
        "followers_detail": null
      },
      "is_eligible_for_commission": true,
      "is_paid_partnership": false,
      "create_time_utc": "2025-09-03T18:37:38.000Z",
      "url": "https://www.tiktok.com/@branttakes/video/7545933721589910798",
      "shop_product_url": "https://www.tiktok.com/shop/pdp/1729494515984797858"
    }
  ],
  "cursor": 20
}
GET/v1/tiktok/search/keyword

Videos for a keyword

1 request

Runs TikTok's general video search for a word or phrase. Each entry in search_item_list wraps an aweme_info object with aweme_id, desc (caption), statistics (play_count, digg_count for likes, comment_count, share_count), video details, and author information. Use cursor to page through results. TikTok sometimes repeats results across pages.

Query parameters

query
stringrequired
Word or phrase to search for.
date_posted
string
Restricts results to videos posted within this period.

yesterdaythis-weekthis-monthlast-3-monthslast-6-monthsall-time

sort_by
string
Ordering of the results.

relevancemost-likeddate-posted

region
string
Two-letter country code (US, GB, FR, and so on) to localise results. It does not restrict results to that country; use it to include posts visible there.
cursor
number
Pagination cursor; use cursor from the prior response.
trim
boolean
When true, returns a slimmer response.
curl "https://api.pandorlabs.com/v1/tiktok/search/keyword?query=<query>" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "search_item_list": [
    {
      "aweme_id": "7268287584244124971",
      "desc": "Tìm 'musclesandnursing'",
      "desc_language": "vi",
      "region": "US",
      "statistics": {
        "aweme_id": "7268287584244124971",
        "collect_count": 6978,
        "comment_count": 187,
        "digg_count": 481608,
        "download_count": 458,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 1282645,
        "repost_count": 0,
        "share_count": 2721,
        "whatsapp_share_count": 56
      },
      "video": {
        "CoverTsp": 0,
        "ai_dynamic_cover": {
          "uri": "tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5…"
          ],
          "url_prefix": null
        },
        "ai_dynamic_cover_bak": {
          "uri": "tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5…"
          ],
          "url_prefix": null
        },
        "animated_cover": {
          "uri": "tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/094a5ba1ff174727a9a483476a8d1642_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=f517ff94&x-expires=1750438800&x-signature=D3imLVwGqpA9zsbLqnvdO%2FafuVs%3D&t=bacd0480&ps=4f5…"
          ],
          "url_prefix": null
        },
        "big_thumbs": [],
        "bit_rate": [
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 1225469,
            "dub_infos": null,
            "fid_profile_labels": "",
            "fps": 30,
            "gear_name": "normal_540_0",
            "is_bytevc1": 0,
            "play_addr": {
              "data_size": 3503925,
              "file_cs": "c:0-20264-cec0",
              "file_hash": "2e54ea91b0d4db38c7e631f3e5d316a0",
              "height": 1024,
              "uri": "v12025gd0000cjf2aabc77u3cqbmfgsg",
              "url_key": "v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469",
              "url_list": [
                "https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%…",
                "https://v15m.tiktokcdn-eu.com/6c9dc53edb12347e833248d3eb85ae4c/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0…"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 20
          }
        ],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": [
            {
              "caption_format": "webvtt",
              "caption_length": 438,
              "cla_subtitle_id": 7270020544014290000,
              "complaint_id": 7270020544014290000,
              "expire": 1752947008,
              "is_auto_generated": true,
              "is_original_caption": true,
              "lang": "eng-US",
              "language_code": "en",
              "language_id": 2,
              "source_tag": "vv_counter,",
              "sub_id": -956551204,
              "sub_version": "1",
              "subtitle_type": 1,
              "translation_type": 0,
              "translator_id": 0,
              "url": "https://v16-cla.tiktokcdn.com/aaaf4ba5cf24681036ef3698a5d762b9/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C…",
              "url_list": [
                "https://v16-cla.tiktokcdn.com/aaaf4ba5cf24681036ef3698a5d762b9/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C…",
                "https://v19-cla.tiktokcdn.com/4eacae0c5eb2cd31bf9682dbb31d41b2/687bd940/video/tos/maliva/tos-maliva-v-0068c799-us/c2eeae68718f4599a720342941eca2bf/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C…"
              ],
              "variant": "default"
            }
          ],
          "captions_type": 1,
          "creator_edited_caption_id": 0,
          "enable_auto_caption": 0,
          "has_original_audio": 0,
          "hide_original_caption": false,
          "no_caption_reason": 0,
          "original_language_info": {
            "can_translate_realtime": false,
            "can_translate_realtime_skip_translation_lang_check": true,
            "first_subtitle_time": 0,
            "is_burnin_caption": true,
            "lang": "eng-US",
            "language_code": "en",
            "language_id": 2,
            "original_caption_type": 5
          },
          "vertical_positions": null
        },
        "cover": {
          "height": 720,
          "uri": "tos-useast5-p-0068-tx/0f577ee28df74315b4a8627da155b294",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/0f577ee28df74315b4a8627da155b294~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=10397&idc=no1a&ps=13740610&refresh_token=b8b3e6e4&shcp=9b759fb9&shp=c133309…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "did_profile_labels": "",
        "download_addr": {
          "data_size": 3577718,
          "height": 720,
          "uri": "v12025gd0000cjf2aabc77u3cqbmfgsg",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/53531e0e8cb8cabe9f9fb43d31f0477a/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/osgGPDi7kD0SShpGAnBhusf3egUQSobVpCSz8y/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "download_no_watermark_addr": {
          "data_size": 3503925,
          "file_cs": "c:0-20264-cec0",
          "file_hash": "2e54ea91b0d4db38c7e631f3e5d316a0",
          "height": 1024,
          "uri": "v12025gd0000cjf2aabc77u3cqbmfgsg",
          "url_key": "v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "duration": 22874,
        "dynamic_cover": {
          "height": 720,
          "uri": "tos-useast5-p-0068-tx/67ce9300736f4166847161d8b805eb29_1692280121",
          "url_list": [
            "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/67ce9300736f4166847161d8b805eb29_1692280121~tplv-tiktokx-origin.image?dr=9229&refresh_token=8a667f0e&x-expires=1750438800&x-signature=61HY87iHMGwIIjamvp5W6BMWgZc%3D&t=bacd0480&ps=4f529…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "has_watermark": true,
        "height": 1024,
        "is_bytevc1": 0,
        "is_callback": true,
        "need_set_token": false,
        "origin_cover": {
          "height": 720,
          "uri": "tos-useast5-p-0068-tx/b077d60fb7304b5ca66c894b70eacd63_1692280121",
          "url_list": [
            "https://p19-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/b077d60fb7304b5ca66c894b70eacd63_1692280121~tplv-dmt-adapt-360p.heic?dr=1360&refresh_token=01618ed2&x-expires=1750438800&x-signature=enrj%2FQcrnnqO5EfF6R%2FI98%2F2GKA%3D&t=bacd0480&ps=…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "play_addr": {
          "data_size": 3503925,
          "file_cs": "c:0-20264-cec0",
          "file_hash": "2e54ea91b0d4db38c7e631f3e5d316a0",
          "height": 1024,
          "uri": "v12025gd0000cjf2aabc77u3cqbmfgsg",
          "url_key": "v12025gd0000cjf2aabc77u3cqbmfgsg_h264_540p_1225469",
          "url_list": [
            "https://v45.tiktokcdn-eu.com/9376fcf5b7e4e4056ac2238e8a50a2d8/68559dc0/video/tos/maliva/tos-maliva-ve-0068c799-us/ooh8ViyMkQSGCrDGSB3eWuUDo7ngz8APpgbenS/?a=1233&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=all&net=0&cd=0%7C0%…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "ratio": "540p",
        "source_HDR_type": 0,
        "tags": null,
        "vid_profile_labels": "{\"tier3\":\"10014\"}",
        "width": 576
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "authority_status": 0,
        "avatar_168x168": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=45126217&t=223449c4"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
          "url_list": [
            "https://p16-amd-va.tiktokcdn.com/tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777~tplv-tiktokx-cropcenter-q:100:100:q70.heic?biz_tag=musically_video.video_user_cover&dr=9606&idc=no1a&ps=87d6e48a&s=SEARCH&sc=avatar&shcp=c1333099&shp=4512…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-maliva-avt-0068/ff3b7c30f1dbed9da420371d20c57777",
        "aweme_count": 0,
        "bold_fields": null,
        "can_message_follow_status_list": null,
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": null,
        "custom_verify": "",
        "cv_level": "",
        "download_prompt_ts": 0,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "events": null,
        "fake_data_info": {},
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 147630,
        "follower_status": 0,
        "followers_detail": null,
        "following_count": 0,
        "friends_status": 0,
        "geofencing": null,
        "hide_search": false,
        "homepage_bottom_toast": null,
        "ins_id": "",
        "is_ad_fake": false
      },
      "create_time": 1692280120,
      "is_ad": false,
      "is_eligible_for_commission": false,
      "create_time_utc": "2023-08-17T13:48:40.000Z",
      "url": "https://www.tiktok.com/@thatgreygentlemanitdxz/video/7268287584244124971"
    }
  ],
  "cursor": 30
}
GET/v1/tiktok/search/top

Top results for a query

1 request

Queries TikTok's 'Top' search tab, which mixes videos and photo carousels, whereas keyword search returns videos only. Each entry in items has id, desc (caption), content_type (video or photo carousel), statistics (play_count, digg_count for likes, comment_count, share_count), video details, and images for carousels. Use cursor to page through results. TikTok sometimes repeats results across pages.

Query parameters

query
stringrequired
Word or phrase to search for.
publish_time
string
Restricts results to posts published within this period.

yesterdaythis-weekthis-monthlast-3-monthslast-6-monthsall-time

sort_by
string
Ordering of the results.

relevancemost-likeddate-posted

region
string
Two-letter country code (US, GB, FR, and so on) to localise results. It does not restrict results to that country; use it to include posts visible there.
cursor
number
Pagination cursor; use cursor from the prior response.
curl "https://api.pandorlabs.com/v1/tiktok/search/top?query=funny" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "items": [
    {
      "id": "7620673421353012494",
      "desc": "#fyp #dog #funny #humor  #blowthisup?   ",
      "content_type": "multi_photo",
      "create_time": "2026-03-24T04:25:45.000Z",
      "desc_language": "un",
      "region": "US",
      "is_top": 0,
      "statistics": {
        "aweme_id": "7620673421353012494",
        "collect_count": 75335,
        "comment_count": 2555,
        "digg_count": 570679,
        "download_count": 1026,
        "forward_count": 0,
        "lose_comment_count": 0,
        "lose_count": 0,
        "play_count": 2674660,
        "repost_count": 0,
        "share_count": 146329,
        "whatsapp_share_count": 430
      },
      "video": {
        "ai_dynamic_cover": {
          "data_size": 0,
          "height": 814,
          "uri": "tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt…"
          ],
          "url_prefix": null,
          "width": 640
        },
        "ai_dynamic_cover_bak": {
          "data_size": 0,
          "height": 814,
          "uri": "tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt…"
          ],
          "url_prefix": null,
          "width": 640
        },
        "big_thumbs": [],
        "bit_rate": [],
        "bit_rate_audio": [],
        "cdn_url_expired": 0,
        "cla_info": {
          "caption_infos": null,
          "captions_type": 0,
          "creator_edited_caption_id": 0,
          "enable_auto_caption": 0,
          "has_original_audio": 0,
          "hide_original_caption": false,
          "is_author_dubbing_qualified": false,
          "no_caption_reason": 3,
          "no_caption_reason_v2": 3,
          "vertical_positions": null
        },
        "cover": {
          "data_size": 0,
          "height": 814,
          "uri": "tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?biz_tag=musically_general.pics_cover&dr=12229&idc=useast8&ps=d5b8ac02&refresh_token=b1c65c7d&s=SE…"
          ],
          "url_prefix": null,
          "width": 640
        },
        "download_addr": {
          "height": 720,
          "uri": "",
          "url_list": [],
          "url_prefix": null,
          "width": 720
        },
        "duration": 0,
        "dynamic_cover": {
          "data_size": 0,
          "height": 814,
          "uri": "tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt…"
          ],
          "url_prefix": null,
          "width": 640
        },
        "has_watermark": false,
        "height": 0,
        "is_bytevc1": 0,
        "is_callback": false,
        "meta": "{\"Loudness\":\"-7.8\",\"LoudnessRange\":\"2\",\"LoudnessRangeEnd\":\"-6.9\",\"LoudnessRangeStart\":\"-8.9\",\"MaximumMomentaryLoudness\":\"-5.8\",\"MaximumShortTermLoudness\":\"-6.6\",\"Peak\":\"1\",\"Version\":\"1\",\"VolumeInfoJson\":\"{\\\"LoudnessRangeStart\\\":-8.9,\\\"Maxim…",
        "need_set_token": false,
        "origin_cover": {
          "data_size": 0,
          "height": 814,
          "uri": "tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-cover:640:0:q72.heic?dr=12229&refresh_token=b1c65c7d&x-expires=1777644000&x-signature=%2Fud5EfXS%2Fh0MoLcb%2BlOTtddSxt…"
          ],
          "url_prefix": null,
          "width": 640
        },
        "play_addr": {
          "height": 720,
          "uri": "https://v16m.tiktokcdn-us.com/c7621dcf09b9341fd297a5fde52650eb/69ea3264/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/oIFNlEJniBUCfwZeDIIhwCIXUBLDbrFQNJMOCy/?a=1233&bti=bmQxZmR2bndsQGo0QHM6OjZAYG1lb2IrbGhxYCMucCMxNDNg&ch=0&cr=0&dr=0&er=0&l…",
          "url_key": "7110642235061947141",
          "url_list": [
            "https://v16m.tiktokcdn-us.com/c7621dcf09b9341fd297a5fde52650eb/69ea3264/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/oIFNlEJniBUCfwZeDIIhwCIXUBLDbrFQNJMOCy/?a=1233&bti=bmQxZmR2bndsQGo0QHM6OjZAYG1lb2IrbGhxYCMucCMxNDNg&ch=0&cr=0&dr=0&er=0&l…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "ratio": "720p",
        "tags": null,
        "width": 0
      },
      "author": {
        "accept_private_policy": false,
        "account_labels": null,
        "ad_cover_url": null,
        "advance_feature_item_order": null,
        "advanced_feature_info": null,
        "authority_status": 0,
        "avatar_168x168": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:168:168.webp?dr=9638&refresh_token=6a1adba9&x-expires=1776434400&x-signature=RHwVN7IVaYS3wYc93K3Xvt6xHIg%3D&t=4d5b0474…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:300:300.webp?dr=9638&refresh_token=59698e3f&x-expires=1776434400&x-signature=IGQFUwoqQ5%2FQs%2BE%2F6IxBe%2Bla%2FMs%3D&…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=071322d1&x-expires=1776434400&x-signature=n6Y%2FOeq3wWDaJErvVXX2deeZ%2BS8%3D&t=4d…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=316847ed&x-expires=1776434400&x-signature=7wRGo7gdVGUeqGWYRh037aNRPsQ%3D&t=4d5b0474…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708",
          "url_list": [
            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708~tplv-tiktokx-cropcenter:100:100.webp?biz_tag=musically_general.pics_user_cover&dr=9640&idc=useast8&ps=13740610&refresh_token=17c8dbe7&shcp=34f…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-useast5-avt-0068-tx/09640951ebb9ad9f6ae1ae283d7b4708",
        "aweme_count": 0,
        "bold_fields": null,
        "can_message_follow_status_list": [
          2
        ],
        "can_set_geofencing": null,
        "cha_list": null,
        "comment_filter_status": 0,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": null,
        "custom_verify": "",
        "cv_level": "",
        "download_prompt_ts": 0,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "events": null,
        "fake_data_info": {},
        "fb_expire_time": 0,
        "follow_status": 0,
        "follower_count": 1680,
        "follower_status": 0,
        "followers_detail": null,
        "following_count": 504,
        "friends_status": 0,
        "geofencing": null,
        "hide_search": true,
        "homepage_bottom_toast": null,
        "ins_id": "",
        "is_ad_fake": false
      },
      "images": [
        "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-i-photomode-tx/d986e70321f24c6f84a0ceca0aa3487f~tplv-photomode-image-v1:q70.webp?dr=8793&refresh_token=4f303086&x-expires=1777644000&x-signature=i2s38bIqG87eWf6DIfKDjn5LYMU%3D&t=5897f7ec&…"
      ],
      "music": {
        "author": "𝐙",
        "duration": 16,
        "id": 7110642235061947000,
        "title": "original sound - al7a.z",
        "play_url": "https://v16m.tiktokcdn-us.com/c7621dcf09b9341fd297a5fde52650eb/69ea3264/video/tos/useast5/tos-useast5-ve-27dcd7c799-tx/oIFNlEJniBUCfwZeDIIhwCIXUBLDbrFQNJMOCy/?a=1233&bti=bmQxZmR2bndsQGo0QHM6OjZAYG1lb2IrbGhxYCMucCMxNDNg&ch=0&cr=0&dr=0&er=0&l…",
        "matched_song": {
          "author": "Soulja Boy Tell'em",
          "id": "6732704090041616385",
          "title": "Crank That (Soulja Boy)"
        }
      },
      "is_eligible_for_commission": false,
      "is_paid_partnership": false,
      "is_ad": false,
      "url": "https://www.tiktok.com/@idk_kid712/photo/7620673421353012494",
      "shop_product_url": null
    }
  ],
  "cursor": 30
}
GET/v1/tiktok/song

Sound details

1 request

Returns metadata for one TikTok sound, identified by its clipId. The music_info object contains title, author, album, duration, user_count (how many videos use the sound), play_url, artist details, and cover art. The clipId appears in a sound's URL and in the output of the endpoint listing popular songs.

Query parameters

clipId
stringrequired
The sound's clipId, not a song ID. TikTok identifies a clipped segment of a track, so the same song can have several clipIds.
curl "https://api.pandorlabs.com/v1/tiktok/song?clipId=7439295283975702544" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "music_info": {
    "album": "Different",
    "allow_offline_music_to_detail_page": false,
    "artists": [
      {
        "avatar": {
          "uri": "tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848",
          "url_list": [
            "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_168x168.webp?lk3s=544a444f&nonce=23330&refresh_token=9e7d26286320fa35b998105f0dcbc158&x-expires=1741053600&x-signature=5oUamOIDpQFqlJS8XBBgEaNiNK0%3D&…"
          ],
          "url_prefix": null
        },
        "enter_type": 2,
        "follow_status": 0,
        "follower_status": 0,
        "handle": "micahtylertok",
        "is_block": false,
        "is_blocked": false,
        "is_private_account": false,
        "is_verified": false,
        "is_visible": false,
        "nick_name": "Micah Tyler",
        "sec_uid": "MS4wLjABAAAAEdwuYUJfZcFMddE2j_F7VdBPJ-mFgfmhvS_OEZc_CwP9mgiFLDBlqsJOgEaAaHR5",
        "status": 1,
        "uid": "7086245766293226538"
      }
    ],
    "audition_duration": 60,
    "author": "Micah Tyler",
    "author_deleted": false,
    "author_position": null,
    "avatar_medium": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_720x720.webp?lk3s=544a444f&nonce=64063&refresh_token=84290303432aef362a12963995398c8c&x-expires=1741053600&x-signature=VWm%2FJPJZmHRb23mnxnbZIoyMEfY%3…"
      ],
      "url_prefix": null,
      "width": 720
    },
    "avatar_thumb": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848",
      "url_list": [
        "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/e7d4971260ccf9834d92fe6a3c63e848~c5_100x100.webp?lk3s=544a444f&nonce=19785&refresh_token=546fc5e384f6934ebcb6a569ae37a54d&x-expires=1741053600&x-signature=q5%2FBVdNQxITSyrSbvd69kij1sRE%3…"
      ],
      "url_prefix": null,
      "width": 720
    },
    "binded_challenge_id": 0,
    "can_be_stitched": true,
    "can_not_reuse": false,
    "collect_stat": 0,
    "commercial_right_type": 3,
    "cover_large": {
      "height": 720,
      "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
      "url_list": [
        "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_medium": {
      "height": 720,
      "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
      "url_list": [
        "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_thumb": {
      "height": 720,
      "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
      "url_list": [
        "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
      ],
      "url_prefix": null,
      "width": 720
    },
    "create_time": 1563960621,
    "dmv_auto_show": false,
    "duration": 60,
    "duration_high_precision": {
      "audition_duration_precision": 60,
      "duration_precision": 60,
      "shoot_duration_precision": 60,
      "video_duration_precision": 60
    },
    "external_song_info": [],
    "extra": "{\"aed_music_dur\":35.15,\"amplitude_peak\":0.90573657,\"apple_song_id\":1294619219,\"beats\":{\"audio_effect_onset\":\"https://sf16-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oUAUk8ZzzEAU6HBiB7fAhDsjbAN8yAAEhqQTWg\",\"beats_tracker\":\"https://sf77-…",
    "full_song": {
      "full_song_duration": 195,
      "full_song_duration_precision": 195.12,
      "full_song_id": "6739983931317159937",
      "full_song_play_url": {
        "uri": "tos-alisg-ve-2774/ok4uNQDaztAMCS5ZA6iiwxBnWrBsBXAMIVfyoN",
        "url_list": [
          "https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-ve-2774/ok4uNQDaztAMCS5ZA6iiwxBnWrBsBXAMIVfyoN"
        ],
        "url_prefix": null
      },
      "full_song_shoot_duration": 60,
      "full_song_shoot_duration_precision": 60
    },
    "has_commerce_right": false,
    "id": 6717159721276541000,
    "id_str": "6717159721276540930",
    "is_audio_url_with_cookie": false,
    "is_author_artist": true,
    "is_commerce_music": true,
    "is_matched_metadata": false,
    "is_original": false,
    "is_original_sound": false,
    "is_pgc": true,
    "is_shooting_allow": true,
    "log_extra": "{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}",
    "lyric_short_position": null,
    "matched_song": {
      "author": "Micah Tyler",
      "chorus_info": {
        "duration_ms": 85824,
        "start_ms": 91968
      },
      "cover_medium": {
        "height": 720,
        "uri": "tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb",
        "url_list": [
          "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/okeuMAAZnBBv88JZBjFEgjDOtWCZQ4AEEwfoQb.jpeg"
        ],
        "url_prefix": null,
        "width": 720
      },
      "full_duration": 195120,
      "h5_url": "",
      "id": "6717159725093390337",
      "performers": null,
      "title": "Different (Acoustic)"
    },
    "meme_song_info": {},
    "mid": "6717159721276540930"
  },
  "rec_list": [],
  "similar_music": [],
  "similar_music_ids": null,
  "status_code": 0,
  "status_msg": ""
}
GET/v1/tiktok/song/videos

Videos using a sound

1 request

Lists TikTok videos that use a particular sound, identified by clipId. Each entry in aweme_list has aweme_id, desc (caption), statistics (play_count, digg_count for likes, comment_count, share_count), video details, and author information. Send the cursor from the prior response to get more.

Query parameters

clipId
string
The sound's clipId, the trailing number in a URL such as https://www.tiktok.com/music/That%27s-Who-I-Praise-7370375686554782506 (here 7370375686554782506).
cursor
number
Pagination cursor for the next page of results.
curl "https://api.pandorlabs.com/v1/tiktok/song/videos" \  -H "Authorization: Bearer $PANDORLABS_KEY"
Example response

Response

{
  "success": true,
  "credits_charged": 1,
  "aweme_list": [
    {
      "added_sound_music_info": {
        "album": "GNX",
        "allow_offline_music_to_detail_page": false,
        "artists": [],
        "audition_duration": 59,
        "author": "Kendrick Lamar & SZA",
        "author_deleted": false,
        "author_position": null,
        "binded_challenge_id": 0,
        "can_be_stitched": true,
        "can_not_reuse": false,
        "collect_stat": 0,
        "commercial_right_type": 3,
        "cover_large": {
          "height": 720,
          "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
          "url_list": [
            "https://p16-sg.tiktokcdn.com/aweme/720x720/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
          ],
          "url_prefix": null,
          "width": 720
        },
        "cover_medium": {
          "height": 720,
          "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
          "url_list": [
            "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
          ],
          "url_prefix": null,
          "width": 720
        },
        "cover_thumb": {
          "height": 720,
          "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
          "url_list": [
            "https://p16-sg.tiktokcdn.com/aweme/100x100/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
          ],
          "url_prefix": null,
          "width": 720
        },
        "create_time": 1732317312,
        "dmv_auto_show": false,
        "duration": 59,
        "duration_high_precision": {
          "audition_duration_precision": 59.037,
          "duration_precision": 59.037,
          "shoot_duration_precision": 59.037,
          "video_duration_precision": 60
        },
        "external_song_info": [],
        "extra": "{\"amplitude_peak\":0.9612427,\"apple_song_id\":1781316886,\"beats\":{\"audio_effect_onset\":\"https://sf77-ies-music-sg.tiktokcdn.com/obj/tos-alisg-v-2774/oc3znOgNABAyAsloQEiaoshBsf9juFtiAWABFE\",\"beats_tracker\":\"https://sf77-ies-music-sg.tiktokcdn.…",
        "has_commerce_right": false,
        "id": 7439295283975703000,
        "id_str": "7439295283975702544",
        "is_audio_url_with_cookie": false,
        "is_author_artist": false,
        "is_commerce_music": true,
        "is_matched_metadata": false,
        "is_original": false,
        "is_original_sound": false,
        "is_pgc": true,
        "is_play_music": false,
        "is_shooting_allow": true,
        "language": "English",
        "log_extra": "{\"meta_song_matched_type\":\"pgc\",\"ttm_matched_type\":\"\",\"ttm_track_id\":\"\",\"matched_meta_song_id\":\"\",\"vid\":\"\",\"owner_id\":\"\"}",
        "lyric_short_position": null,
        "matched_song": {
          "author": "Kendrick Lamar & SZA",
          "chorus_info": {
            "duration_ms": 27456,
            "start_ms": 119808
          },
          "cover_medium": {
            "height": 720,
            "uri": "tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA",
            "url_list": [
              "https://p16-sg.tiktokcdn.com/aweme/200x200/tos-alisg-v-2774/oAQAfe3r0KfAKAMDJpQVILIMTeGSVPAmreQznA.jpeg"
            ],
            "url_prefix": null,
            "width": 720
          },
          "full_duration": 177599,
          "h5_url": "",
          "id": "7440101671265486864",
          "performers": null,
          "title": "luther"
        },
        "meme_song_info": {},
        "mid": "7439295283975702544",
        "multi_bit_rate_play_info": null
      },
      "aigc_info": {
        "aigc_label_type": 0,
        "created_by_ai": false
      },
      "allow_gift": true,
      "anchors": [
        {
          "actions": [],
          "anchor_strong": null,
          "caption": "",
          "component_key": "anchor_capcut",
          "description": "CapCut · Video Editor",
          "general_type": 1,
          "icon": {
            "height": 720,
            "uri": "tiktok-obj/cc_anchor_logo_230222.png",
            "url_list": [
              "https://p77-sg.tiktokcdn.com/tiktok-obj/cc_anchor_logo_230222.png~tplv-tiktokx-origin.image?biz_tag=anchor.capcut&dr=10423&idc=no1a&nonce=10587&ps=933b5bde&refresh_token=ea868bfe485d80c4fb34e71dbd716e98&shcp=d05b14bd&shp=45126217&t=4d5b0474"
            ],
            "url_prefix": null,
            "width": 720
          },
          "id": "0",
          "keyword": "CapCut · 2024 in 43 photos",
          "log_extra": "{\"anchor_id\":0,\"anchor_name\":\"CapCut · 2024 in 43 photos\",\"anchor_name_type\":\"template_1\",\"anchor_title_detail\":\"None\",\"anchor_type\":\"TT_CAPCUT\",\"capability_key\":\"none\",\"cc_template_pay_type\":0,\"if_device_language\":\"1\",\"if_race_trigger\":0,\"…",
          "schema": "aweme://lynxview/?bundle=landing%2Ftemplate.js&channel=tiktok_capcut_anchor_landing_page&container_bg_color=000000&download_optimization=1&dynamic=3&enable_prefetch=1&experiment_70720234=1&experiment_70734729=1&experiment_71198425=1&experim…",
          "thumbnail": {
            "height": 64,
            "uri": "tiktok-obj/64x_Capcut3x.png",
            "url_list": [
              "https://p77-sg.tiktokcdn.com/tiktok-obj/64x_Capcut3x.png~tplv-tiktokx-origin.image?dr=10423&nonce=77923&refresh_token=77b96e44e22e72876d95216d492cac0d&idc=no1a&ps=933b5bde&shcp=d05b14bd&shp=45126217&t=4d5b0474"
            ],
            "url_prefix": null,
            "width": 64
          },
          "type": 54
        }
      ],
      "anchors_extras": "",
      "animated_image_info": {
        "effect": 0,
        "type": 0
      },
      "author": {
        "ad_cover_url": null,
        "authority_status": 0,
        "avatar_168x168": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&nonce=23496&ps=87d6e48a&refresh_token=00c6e144ba14a3929bba66f8d4eeb95c&s=MUSIC_AWEME&sc…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_300x300": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&nonce=71045&ps=87d6e48a&refresh_token=e1a2307775247b3cbcbb4c405a3dd051&s=MUSIC_AWEME&sc…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_larger": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&nonce=740&ps=87d6e48a&refresh_token=eec1741aa128547d6c4408853e59ba16&s=MUSIC_AWEME&sc…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&nonce=98842&ps=87d6e48a&refresh_token=c9ced2e139cbb90b75fe4222b231bfb1&s=MUSIC_AWEME&sc…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "height": 720,
          "uri": "tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5",
          "url_list": [
            "https://p16-pu-no.tiktokcdn-eu.com/tos-no1a-avt-0068c001-no/63a0c1998edd418ab288993da2afe4a5~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&nonce=29842&ps=87d6e48a&refresh_token=31964afe9e3aaab0ed796eece3c31b1b&s=MUSIC_AWEME&sc…"
          ],
          "url_prefix": null,
          "width": 720
        },
        "cha_list": null,
        "comment_filter_status": 1,
        "comment_setting": 0,
        "commerce_user_level": 0,
        "cover_url": [],
        "custom_verify": "",
        "download_setting": 3,
        "duet_setting": 0,
        "enabled_filter_all_comments": false,
        "enterprise_verify_reason": "",
        "follow_status": 0,
        "follower_status": 0,
        "followers_detail": null,
        "friends_status": 0,
        "is_ad_fake": false,
        "is_block": false,
        "is_discipline_member": false,
        "is_star": false,
        "language": "es",
        "nickname": "El rey de las bromas oficial",
        "prevent_download": false,
        "region": "MX",
        "relative_users": null,
        "room_id": 0,
        "sec_uid": "MS4wLjABAAAAbhqboEW5Qk6emunyGrRmD04w52fJAPvOI8XPuGxq9xwnkN9ID8cpxME-yUqEwaYU",
        "secret": 0,
        "share_info": {
          "now_invitation_card_image_urls": null,
          "share_desc": "",
          "share_desc_info": "",
          "share_qrcode_url": {
            "height": 720,
            "uri": "",
            "url_list": [],
            "url_prefix": null,
            "width": 720
          },
          "share_title": "",
          "share_title_myself": "",
          "share_title_other": "",
          "share_url": ""
        },
        "short_id": "0",
        "signature": "Sigan a mi editor y les mando un saludo ⬇️⬇️⬇️",
        "stitch_setting": 0,
        "uid": "7431412724132922400",
        "unique_id": "elreydelasbromasoficial",
        "user_now_pack_info": {}
      },
      "author_user_id": 7431412724132922000,
      "aweme_acl": {
        "download_general": {
          "code": 1,
          "extra": "101",
          "mute": false,
          "show_type": 0,
          "transcode": 1
        },
        "download_mask_panel": {
          "code": 1,
          "extra": "101",
          "mute": false,
          "show_type": 0,
          "transcode": 1
        },
        "platform_list": null,
        "press_action_list": null,
        "share_action_list": null,
        "share_general": {
          "code": 1,
          "extra": "101",
          "mute": false,
          "show_type": 1,
          "toast_msg": "This action isn’t allowed for this post",
          "transcode": 1
        },
        "share_list_status": 0
      },
      "aweme_id": "7452069943757114646",
      "aweme_type": 0,
      "banners": null,
      "behind_the_song_music_ids": null,
      "behind_the_song_video_music_ids": null,
      "bodydance_score": 0,
      "branded_content_accounts": null,
      "cc_template_info": {
        "author_name": "",
        "clip_count": 0,
        "desc": "",
        "duration_milliseconds": 0,
        "match_type": "top_item",
        "music_copyright": true,
        "onelink": "https://capcut-yt.onelink.me/W3Oy/mpy6xee2",
        "related_music_id": "",
        "schema_extra": "{\"experiment_id\":\"72683638\"}",
        "style_type": 1,
        "template_id": "7439087471498956085"
      },
      "cha_list": [
        {
          "author": {
            "account_labels": null,
            "ad_cover_url": null,
            "advance_feature_item_order": null,
            "advanced_feature_info": null,
            "bold_fields": null,
            "can_message_follow_status_list": null,
            "can_set_geofencing": null,
            "cha_list": null,
            "cover_url": null,
            "events": null,
            "followers_detail": null,
            "geofencing": null,
            "homepage_bottom_toast": null,
            "item_list": null,
            "mutual_relation_avatars": null,
            "need_points": null,
            "platform_sync_info": null,
            "relative_users": null,
            "search_highlight": null,
            "shield_edit_field_info": null,
            "type_label": null,
            "user_profile_guide": null,
            "user_tags": null,
            "white_cover_url": null
          },
          "banner_list": null,
          "cha_attrs": null,
          "cha_name": "memestiktok",
          "cid": "1615484249350165",
          "collect_stat": 0,
          "connect_music": [],
          "desc": "¡Llegaste al lugar indicado para encontrar memazos! \n\nCada viernes podrás encontrar a los 9 #MEMESTikTok oficiales de la semana.",
          "extra_attr": {
            "is_live": false
          },
          "hashtag_profile": "musically-maliva-obj/422f2c33d377dddff0f11cb5a276196f",
          "is_challenge": 0,
          "is_commerce": false,
          "is_pgcshow": false,
          "schema": "aweme://aweme/challenge/detail?cid=1615484249350165",
          "search_highlight": null,
          "share_info": {
            "bool_persist": 0,
            "now_invitation_card_image_urls": null,
            "share_desc": "Check out #memestiktok on TikTok!",
            "share_desc_info": "Check out #memestiktok on TikTok!",
            "share_quote": "",
            "share_signature_desc": "",
            "share_signature_url": "",
            "share_title": "It is a becoming a big trend on TikTok now! Click here: memestiktok",
            "share_title_myself": "",
            "share_title_other": "",
            "share_url": "https://www.tiktok.com/tag/memestiktok?_r=1&name=memestiktok&u_code=ed95h8gmi905eb&_d=ed95ee344m3h4g&share_challenge_id=1615484249350165&sharer_language=en&source=h5_m"
          },
          "show_items": null,
          "sub_type": 0,
          "type": 1,
          "use_count": 0,
          "user_count": 0,
          "view_count": 0
        }
      ],
      "challenge_position": null,
      "cmt_swt": false,
      "collect_stat": 0,
      "comment_config": {
        "comment_panel_show_tab_config": null,
        "emoji_recommend_list": null,
        "long_press_recommend_list": null,
        "preload": {
          "preds": "{\"item_post_comment\":0.00011830986683832393}"
        },
        "quick_comment": {
          "enabled": true
        },
        "quick_comment_emoji_recommend_list": null
      },
      "commerce_config_data": null,
      "commerce_info": {
        "adv_promotable": true,
        "auction_ad_invited": false,
        "branded_content_type": 0,
        "with_comment_filter_words": false
      },
      "content_desc": "",
      "content_desc_extra": [],
      "content_model": {
        "custom_biz": {
          "aweme_trace": "202502180605264FFF1CE5D6043F4CF934"
        },
        "standard_biz": {
          "e_commerce": {
            "ttec_content_tag": {
              "recommendation_tag_consumer_str": "",
              "recommendation_tag_creator_str": ""
            }
          },
          "tts_voice_info": {
            "tts_voice_attr": "[]",
            "tts_voice_reuse_params": ""
          },
          "vc_filter_info": {
            "vc_filter_attr": "[]"
          }
        }
      },
      "content_original_type": 1,
      "content_size_type": 1,
      "content_type": "video",
      "cover_labels": null,
      "create_time": 1735070246,
      "creation_info": {
        "creation_used_functions": [
          "select_music"
        ]
      },
      "desc": "2024 en 43 fotos el rey de las bromas #memestiktok #elreydelasbromas #bromita #pepe #reto #grillo #racha #fotos #luther #2024 #2025 ",
      "desc_language": "es",
      "distance": "",
      "distribute_type": 1,
      "follow_up_publish_from_id": -1,
      "geofencing": null,
      "geofencing_regions": null
    }
  ],
  "can_pin_video": false,
  "cursor": 12,
  "extra": {
    "fatal_item_ids": [],
    "logid": "202502180605264FFF1CE5D6043F4CF934",
    "now": 1739829927000
  },
  "has_more": 1,
  "log_pb": {
    "impr_id": "202502180605264FFF1CE5D6043F4CF934"
  },
  "need_lazy_loading": false,
  "status_code": 0,
  "status_msg": ""
}