Top Search

GET/v1/tiktok/search/top1 credit

Returns the videos from TikTok's "Top" search results for a keyword, as compact objects, 30 per page.

01Query parameters

Name	Type	Description
queryrequired	string	The search term.
publish_timeoptional	string	Only videos posted within this period. An unknown value is ignored.Accepted values:`yesterdaythis-weekthis-monthlast-3-monthslast-6-monthsall-time`
sort_byoptional	string	Result order. An unknown value is ignored.Accepted values:`relevancemost-likeddate-posted`
cursoroptional	integer	The `cursor` value of the previous page, to get the next one.

02Request

curl "https://api.scrapesocial.ai/v1/tiktok/search/top?query=funny" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/tiktok/search/top?query=funny

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "items": [
    {
      "id": "7556372363550510337",
      "desc": "Hilarious Best Funny Comedy videos of the day 🤣😂🤣  This is so Hilarious and Funny 😂😂🤣  Bro was pranked in a funny manner 😂😂😂  #creatorsearchinsights #hilariousvideos  #funny #comedy #funnyvideos ",
      "content_type": "video",
      "create_time": "2025-10-01T21:45:10.000Z",
      "desc_language": "en",
      "region": null,
      "is_top": 0,
      "statistics": {
        "aweme_id": "7556372363550510337",
        "collect_count": 5598,
        "comment_count": 1200,
        "digg_count": 57300,
        "play_count": 1700000,
        "repost_count": 0,
        "share_count": 6445
      },
      "video": {
        "bit_rate": [
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 335651,
            "dub_infos": null,
            "fps": 0,
            "gear_name": "lower_540_0",
            "is_bytevc1": 0,
            "play_addr": {
              "data_size": 916791,
              "file_cs": "c:0-19536-4226",
              "file_hash": "c3a507ed7576c86eb562e4f76a592ce1",
              "height": 1024,
              "uri": "v14044g50000d3eq0g7og65s410dt1lg",
              "url_key": "v14044g50000d3eq0g7og65s410dt1lg_h264_540p_335651",
              "url_list": [
                "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/owGdmofBQC6uNgIROejoI7wDgCis0AGQ3gAeLR/?a=1988&bti=ODszNWYuMDE6&&bt=327&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=Z2g3OTQ8NGc7N2Q1NzQzZkBpajRnNHY5cmp0NjMzODczNEA2YDVfMi9eX2IxYC9hXjMtYSNpcS0xMmQ0LWJhLS1kMTFzcw%3D%3D&expire=1793121060&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&signature=540…",
                "https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/owGdmofBQC6uNgIROejoI7wDgCis0AGQ3gAeLR/?a=1988&bti=ODszNWYuMDE6&&bt=327&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=Z2g3OTQ8NGc7N2Q1NzQzZkBpajRnNHY5cmp0NjMzODczNEA2YDVfMi9eX2IxYC9hXjMtYSNpcS0xMmQ0LWJhLS1kMTFzcw%3D%3D&expire=1793121060&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&signature=540…"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 24,
            "video_extra": "{}"
          },
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 271304,
            "dub_infos": null,
            "fps": 0,
            "gear_name": "adapt_lower_720_1",
            "is_bytevc1": 1,
            "play_addr": {
              "data_size": 741035,
              "file_cs": "c:0-19739-9524",
              "file_hash": "19aa9a29e72aa412042d78bd116335dd",
              "height": 1280,
              "uri": "v14044g50000d3eq0g7og65s410dt1lg",
              "url_key": "v14044g50000d3eq0g7og65s410dt1lg_bytevc1_720p_271304",
              "url_list": [
                "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oEfHqaAU3BBFGHrILEeq4TAIhQBg8owIDERdEv/?a=1988&bti=ODszNWYuMDE6&&bt=264&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=N2Y8OzY5ZWZmZmkzOGlnNkBpajRnNHY5cmp0NjMzODczNEAxMy80NTZgXmAxXzEyNV42YSNpcS0xMmQ0LWJhLS1kMTFzcw%3D%3D&expire=1793121060&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&signature=220…",
                "https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oEfHqaAU3BBFGHrILEeq4TAIhQBg8owIDERdEv/?a=1988&bti=ODszNWYuMDE6&&bt=264&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=N2Y8OzY5ZWZmZmkzOGlnNkBpajRnNHY5cmp0NjMzODczNEAxMy80NTZgXmAxXzEyNV42YSNpcS0xMmQ0LWJhLS1kMTFzcw%3D%3D&expire=1793121060&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&signature=220…"
              ],
              "url_prefix": null,
              "width": 720
            },
            "quality_type": 14,
            "video_extra": "{}"
          }
        ],
        "cover": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-alisg-p-0037/okh4ooBHfABFCIDAEOmdBQIgGFRga35GeUEIBr",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/okh4ooBHfABFCIDAEOmdBQIgGFRga35GeUEIBr~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=xfm%2BRUZvfBxV2c%2BGPawIddXC6hk%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "download_addr": {
          "height": 1024,
          "uri": "v14044g50000d3eq0g7og65s410dt1lg",
          "url_list": [
            "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c815-sg/oIO9QWFzfIUALDldBgDAIB34RQogoBvECaEGfP/?a=1988&bti=ODszNWYuMDE6&&bt=560&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=Z2hnZmRnaTU7Zjs4Zzk8NkBpajRnNHY5cmp0NjMzODczNEAtYC5fMl8zXzUxLTUvYzJgYSNpcS0xMmQ0LWJhLS1kMTFzcw%3D%3D&expire=1793121060&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&signature=c38…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "duration": 21000,
        "dynamic_cover": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-alisg-p-0037/oUGBQUWQADAdQIlERaF4BRoC2E9gDBW3QGfe7E",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oUGBQUWQADAdQIlERaF4BRoC2E9gDBW3QGfe7E~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=K87wvHEfHwn2zdn1e0nkpSS5MpY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "has_watermark": true,
        "height": 1024,
        "origin_cover": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-alisg-p-0037/oQ2bAfhIDBPoFdGEAdEoa9IO3BUIQreg4jRxBA",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/oQ2bAfhIDBPoFdGEAdEoa9IO3BUIQreg4jRxBA~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=9Z1MiYXjMMktDrwlfi9V47Q%2BVpk%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "play_addr": {
          "height": 1024,
          "uri": "v14044g50000d3eq0g7og65s410dt1lg",
          "url_list": [
            "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/owGdmofBQC6uNgIROejoI7wDgCis0AGQ3gAeLR/?a=1988&bti=ODszNWYuMDE6&&bt=327&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=Z2g3OTQ8NGc7N2Q1NzQzZkBpajRnNHY5cmp0NjMzODczNEA2YDVfMi9eX2IxYC9hXjMtYSNpcS0xMmQ0LWJhLS1kMTFzcw%3D%3D&expire=1793121060&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&signature=540…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "ratio": "540p",
        "width": 576
      },
      "author": {
        "avatar_larger": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=7a203f13&x-expires=1793120400&x-signature=01PXv2h4uks1oZmVt3frBhvpy6s%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=6dc6fa0b&x-expires=1793120400&x-signature=BHiMzBTQgzVCgEGZLfzrlUfHH4w%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797",
          "url_list": [
            "https://p19-common-sign.tiktokcdn.com/tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=8e72c097&x-expires=1793120400&x-signature=BqKIyjBMkjK9oiAXHCrfzy7tq%2F8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-alisg-avt-0068/579c3c5690cacdddf48fd80f52b93797",
        "follower_count": 23300,
        "following_count": 223,
        "nickname": "Immortal",
        "sec_uid": "MS4wLjABAAAA5vwSks_5ZZr2_99G85rFUKWpapZTUzYVYOkesLHwDORWPUYjrc6yloxzbFwH5vCw",
        "secret": 0,
        "uid": "6900326286725039109",
        "unique_id": "am_immortal1"
      },
      "music": {
        "author": "Immortal",
        "duration": 21,
        "id": 7556372662474329000,
        "title": "original sound",
        "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/oobATEN6PD6AAAioi7iEPdi2YClaBUgLOBgGA/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThLf4dGXq8Zmo&mime_type=audio_mpeg&rc=M206cnQ5cnR0NjMzODU8NEBpM206cnQ5cnR0NjMzODU8NEAwamQ0MmQ0LmJhLS1kMS1zYSMwamQ0MmQ0LmJhLS1kMS1zcw%3D%3D&expire=1792969860&l=202610260110385A90F1B52BF493680B3D&ply_type=3&policy=3&signature=9dac3f0f47a5d95e8d400e…"
      },
      "is_eligible_for_commission": false,
      "is_paid_partnership": false,
      "is_ad": false,
      "url": "https://www.tiktok.com/@am_immortal1/video/7556372363550510337",
      "shop_product_url": null
    },
    {
      "id": "7493974857235909910",
      "desc": "",
      "content_type": "video",
      "create_time": "2025-04-16T18:09:52.000Z",
      "desc_language": "un",
      "region": null,
      "is_top": 0,
      "statistics": {
        "aweme_id": "7493974857235909910",
        "collect_count": 39530,
        "comment_count": 9277,
        "digg_count": 397200,
        "play_count": 9200000,
        "repost_count": 0,
        "share_count": 15700
      },
      "video": {
        "bit_rate": [
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 1787931,
            "dub_infos": null,
            "fps": 0,
            "gear_name": "normal_540_0",
            "is_bytevc1": 0,
            "play_addr": {
              "data_size": 15741394,
              "file_cs": "c:0-59289-8147",
              "file_hash": "a1129ab768aa24ecf76a0279f181d85d",
              "height": 1024,
              "uri": "v24044gl0000cvvv4mvog65pmo5dr5h0",
              "url_key": "v24044gl0000cvvv4mvog65pmo5dr5h0_h264_540p_1787931",
              "url_list": [
                "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oQ9eVGf8RBB32WAEmYeIH2S81gPZADLtffZCIe/?a=1988&bti=ODszNWYuMDE6&&bt=1746&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=M2c0Nzs7NjY8NTw8NzkzOEBpMzhncnM5cnB5eTMzbzczNUAwNi8uYi1iNV4xYDZiYjFgYSNlbzJqMmRzMXNgLS1kMTFzcw%3D%3D&expire=1793121109&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&sig…",
                "https://v19-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oQ9eVGf8RBB32WAEmYeIH2S81gPZADLtffZCIe/?a=1988&bti=ODszNWYuMDE6&&bt=1746&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=M2c0Nzs7NjY8NTw8NzkzOEBpMzhncnM5cnB5eTMzbzczNUAwNi8uYi1iNV4xYDZiYjFgYSNlbzJqMmRzMXNgLS1kMTFzcw%3D%3D&expire=1793121109&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&sig…"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 20,
            "video_extra": "{}"
          },
          {
            "HDR_bit": "",
            "HDR_type": "",
            "bit_rate": 982528,
            "dub_infos": null,
            "fps": 0,
            "gear_name": "lower_540_0",
            "is_bytevc1": 0,
            "play_addr": {
              "data_size": 8650423,
              "file_cs": "c:0-59289-f188",
              "file_hash": "be3be1169c74cedeb56af4bf4ca521cb",
              "height": 1024,
              "uri": "v24044gl0000cvvv4mvog65pmo5dr5h0",
              "url_key": "v24044gl0000cvvv4mvog65pmo5dr5h0_h264_540p_982528",
              "url_list": [
                "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/og4fgZZfEsYf3fogjeulvBf9YiDKEAZb8YCBYB/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=ZWhlaGQ2Z2RlNzU5Mzg6OUBpMzhncnM5cnB5eTMzbzczNUBgMS9gLTZiNjAxYWMzYWNgYSNlbzJqMmRzMXNgLS1kMTFzcw%3D%3D&expire=1793121109&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&sign…",
                "https://v19-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/og4fgZZfEsYf3fogjeulvBf9YiDKEAZb8YCBYB/?a=1988&bti=ODszNWYuMDE6&&bt=959&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=ZWhlaGQ2Z2RlNzU5Mzg6OUBpMzhncnM5cnB5eTMzbzczNUBgMS9gLTZiNjAxYWMzYWNgYSNlbzJqMmRzMXNgLS1kMTFzcw%3D%3D&expire=1793121109&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&sign…"
              ],
              "url_prefix": null,
              "width": 576
            },
            "quality_type": 24,
            "video_extra": "{}"
          }
        ],
        "cover": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-no1a-p-0037-no/o0Wf32SIgCZtHgCQNZLfB8fGAIBkuYDneefE2m",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/o0Wf32SIgCZtHgCQNZLfB8fGAIBkuYDneefE2m~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=bf0YorpsioAOn2mvvt2hCXPPsHc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "download_addr": {
          "height": 1024,
          "uri": "v24044gl0000cvvv4mvog65pmo5dr5h0",
          "url_list": [
            "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c811-euttp/oMZ9BtWfXLge2EeAgfIGmjeIRreXAStCYBA32Z/?a=1988&bti=ODszNWYuMDE6&&bt=1784&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=Njc5OGY4ZWk8NTNmNmRmZkBpMzhncnM5cnB5eTMzbzczNUAzYTEtNWMxXjQxXy4vMjU2YSNlbzJqMmRzMXNgLS1kMTFzcw%3D%3D&expire=1793121109&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&sig…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "duration": 70000,
        "dynamic_cover": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-no1a-p-0037-no/ocLS2nMffBf2YW3LImCevZ9ZBbfegvtXE2IAgG",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/ocLS2nMffBf2YW3LImCevZ9ZBbfegvtXE2IAgG~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=6zm%2BL49ZRiCmE4Q3jCFHe7Bbag8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "has_watermark": true,
        "height": 1024,
        "origin_cover": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-no1a-p-0037-no/oYfffNseAveRZssEB3IfLYBGPZX7BB8FcAbMSQ",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-no1a-p-0037-no/oYfffNseAveRZssEB3IfLYBGPZX7BB8FcAbMSQ~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=P76glohmXUFfU%2BDU%2Bb6dXtXSoCs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "play_addr": {
          "height": 1024,
          "uri": "v24044gl0000cvvv4mvog65pmo5dr5h0",
          "url_list": [
            "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-68c810-euttp/oQ9eVGf8RBB32WAEmYeIH2S81gPZADLtffZCIe/?a=1988&bti=ODszNWYuMDE6&&bt=1746&ft=-Csk_mXMPD12N7tyLn-Uxyv5SY9e3wv25dcAp&mime_type=video_mp4&rc=M2c0Nzs7NjY8NTw8NzkzOEBpMzhncnM5cnB5eTMzbzczNUAwNi8uYi1iNV4xYDZiYjFgYSNlbzJqMmRzMXNgLS1kMTFzcw%3D%3D&expire=1793121109&l=202610260110385A90F1B52BF493680B3D&ply_type=2&policy=2&sig…"
          ],
          "url_prefix": null,
          "width": 576
        },
        "ratio": "540p",
        "width": 576
      },
      "author": {
        "avatar_larger": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=14ae840f&x-expires=1793120400&x-signature=02jpEm9uRHnsFQMJ1ySV0MxTEF0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_medium": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=ddb3e033&x-expires=1793120400&x-signature=ZMXb1sI1XMopJNYXEGdgRoHzP7Y%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_thumb": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105",
          "url_list": [
            "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=714ed69c&x-expires=1793120400&x-signature=BsfzMj2QtjWyIei8XNgkqpnnwA4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
          ],
          "url_prefix": null,
          "width": 720
        },
        "avatar_uri": "tos-useast2a-avt-0068-euttp/f844a4722a4ba79e5e3dd8fc562c4105",
        "follower_count": 2400000,
        "following_count": 12,
        "nickname": "Team Funny",
        "sec_uid": "MS4wLjABAAAAMz3VIkUSYUEosUwioHwQHLaHqR067kG6I_GVXJzi9SJP9Qcx4NgdDvQHc-yi2fie",
        "secret": 0,
        "uid": "7420490082747991073",
        "unique_id": "team.funny25"
      },
      "music": {
        "author": "Team Funny",
        "duration": 70,
        "id": 7493974859471850000,
        "title": "original sound",
        "play_url": "https://v16-webapp-prime.tiktok.com/video/tos/no1a/tos-no1a-v-2370-no/oAJAEsSFjIAiHMAAY3hfpJIfbO89Df0MgnnfEf/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7ThLf4dGXq8Zmo&mime_type=audio_mpeg&rc=am5tM2s5cnl5eTMzbzU8NUBpam5tM2s5cnl5eTMzbzU8NUBnMGQzMmRjMXNgLS1kMTFzYSNnMGQzMmRjMXNgLS1kMTFzcw%3D%3D&expire=1792969909&l=202610260110385A90F1B52BF493680B3D&ply_type=3&policy=3&signature=dfa8d7d7d3981b246d36da…"
      },
      "is_eligible_for_commission": false,
      "is_paid_partnership": false,
      "is_ad": false,
      "url": "https://www.tiktok.com/@team.funny25/video/7493974857235909910",
      "shop_product_url": null
    }
  ],
  "cursor": 30
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

Videos are in `items` (id, caption, content type, ISO creation time, statistics, video, author, music, images for photo posts, URL). To page, send the response's `cursor` back as `cursor` (30, 60, ...); there is no `has_more`, so stop when `items` comes back empty (0 credits). Account cards from the Top tab are not included, and `region` is always null. The endpoint can answer a free 503 when it is temporarily unavailable; retry later. When nothing matches the query exactly, TikTok's Top tab shows loosely related videos instead; they come back as results (1 credit).

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.