Search Videos

GET/v1/tiktok/search/keyword1 credit

Searches TikTok videos by keyword, 30 per page, with optional date and sort filters.

01Query parameters

Name	Type	Description
queryrequired	string	The search term.
date_postedoptional	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.
trimoptional	boolean	Accepted for compatibility; this endpoint always returns full video objects.Default: `false`

02Request

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

03Responses

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

GET /v1/tiktok/search/keyword?query=funny%20dogs

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "search_item_list": [
    {
      "aweme_info": {
        "added_sound_music_info": {
          "author": "FurryHouseFinds",
          "cover_large": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=bf4f3b49&x-expires=1793120400&x-signature=KzKEkKpd9Jq03q286DIXmXR8kck%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_medium": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e9a73910&x-expires=1793120400&x-signature=0usk0hmnpzNw88CBVuEMEBXvW5A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_thumb": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e4358468&x-expires=1793120400&x-signature=QfYoqVGIM1ykusuOnNNzKUaaEGQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "duration": 9,
          "duration_high_precision": {
            "audition_duration_precision": 9,
            "duration_precision": 9,
            "shoot_duration_precision": 9,
            "video_duration_precision": 9
          },
          "id": "7681695281779460877",
          "id_str": "7681695281779460877",
          "is_original_sound": true,
          "mid": "7681695281779460877",
          "play_url": {
            "height": 720,
            "uri": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-2370c799-sg/oUOg3Mp8v2MWACi6iSEIRo9r4ClaBUdY7xMtP/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=ZWhoN2g6Nmk5OTc4aWUzNUBpanE4eXY5cmZnZDMzZzU8NEBfYTUvMzIyNi8xMmAwYGBfYSNqMmI1MmRrbmFhLS1kMS9zcw%3D%3D&expire=1792969845&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=c6e8f9892e81ca71…",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-2370c799-sg/oUOg3Mp8v2MWACi6iSEIRo9r4ClaBUdY7xMtP/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=ZWhoN2g6Nmk5OTc4aWUzNUBpanE4eXY5cmZnZDMzZzU8NEBfYTUvMzIyNi8xMmAwYGBfYSNqMmI1MmRrbmFhLS1kMS9zcw%3D%3D&expire=1792969845&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=c6e8f9892e81ca71…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "title": "original sound"
        },
        "author": {
          "avatar_larger": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=bf4f3b49&x-expires=1793120400&x-signature=KzKEkKpd9Jq03q286DIXmXR8kck%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-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e9a73910&x-expires=1793120400&x-signature=0usk0hmnpzNw88CBVuEMEBXvW5A%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-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e4358468&x-expires=1793120400&x-signature=QfYoqVGIM1ykusuOnNNzKUaaEGQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "avatar_uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
          "follower_count": 166300,
          "following_count": 7,
          "nickname": "FurryHouseFinds",
          "sec_uid": "MS4wLjABAAAA4jwNkrZ9ffHOXKDmEplJVbmu0ddReo0lGwxk1tUbJQe6b6z69zoddYCQM-CV0kdq",
          "secret": 0,
          "uid": "7672331168062751758",
          "unique_id": "furryhousefinds"
        },
        "author_user_id": 7672331168062752000,
        "aweme_id": "7681695185318792462",
        "aweme_type": 0,
        "content_type": "video",
        "create_time": 1788534052,
        "desc": "He had a lot to say until... 😭 #chihuahua #americanbully #instantkarma #funnydogs #dogsoftiktok",
        "desc_language": "en",
        "group_id": "7681695185318792462",
        "is_ads": false,
        "is_top": 0,
        "item_comment_settings": 0,
        "music": {
          "author": "FurryHouseFinds",
          "cover_large": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=bf4f3b49&x-expires=1793120400&x-signature=KzKEkKpd9Jq03q286DIXmXR8kck%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_medium": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e9a73910&x-expires=1793120400&x-signature=0usk0hmnpzNw88CBVuEMEBXvW5A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_thumb": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0d8db8f01976f04d27e0fe1656d3abad~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=e4358468&x-expires=1793120400&x-signature=QfYoqVGIM1ykusuOnNNzKUaaEGQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "duration": 9,
          "duration_high_precision": {
            "audition_duration_precision": 9,
            "duration_precision": 9,
            "shoot_duration_precision": 9,
            "video_duration_precision": 9
          },
          "id": "7681695281779460877",
          "id_str": "7681695281779460877",
          "is_original_sound": true,
          "mid": "7681695281779460877",
          "play_url": {
            "height": 720,
            "uri": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-2370c799-sg/oUOg3Mp8v2MWACi6iSEIRo9r4ClaBUdY7xMtP/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=ZWhoN2g6Nmk5OTc4aWUzNUBpanE4eXY5cmZnZDMzZzU8NEBfYTUvMzIyNi8xMmAwYGBfYSNqMmI1MmRrbmFhLS1kMS9zcw%3D%3D&expire=1792969845&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=c6e8f9892e81ca71…",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-2370c799-sg/oUOg3Mp8v2MWACi6iSEIRo9r4ClaBUdY7xMtP/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=ZWhoN2g6Nmk5OTc4aWUzNUBpanE4eXY5cmZnZDMzZzU8NEBfYTUvMzIyNi8xMmAwYGBfYSNqMmI1MmRrbmFhLS1kMS9zcw%3D%3D&expire=1792969845&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=c6e8f9892e81ca71…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "title": "original sound"
        },
        "share_url": "https://www.tiktok.com/@furryhousefinds/video/7681695185318792462",
        "statistics": {
          "aweme_id": "7681695185318792462",
          "collect_count": 332124,
          "comment_count": 50200,
          "digg_count": 3600000,
          "play_count": 74400000,
          "repost_count": 0,
          "share_count": 2000000
        },
        "status": {
          "allow_comment": true,
          "allow_share": true,
          "aweme_id": "7681695185318792462",
          "in_reviewing": false,
          "private_status": 0,
          "self_see": false
        },
        "text_extra": [
          {
            "end": 42,
            "hashtag_name": "chihuahua",
            "is_commerce": false,
            "start": 32,
            "type": 1
          },
          {
            "end": 57,
            "hashtag_name": "americanbully",
            "is_commerce": false,
            "start": 43,
            "type": 1
          }
        ],
        "video": {
          "bit_rate": [
            {
              "HDR_bit": "",
              "HDR_type": "",
              "bit_rate": 890261,
              "dub_infos": null,
              "fps": 0,
              "gear_name": "normal_720_0",
              "is_bytevc1": 0,
              "play_addr": {
                "data_size": 1058855,
                "file_cs": "c:0-9514-8587",
                "file_hash": "3cbb877703654e066598c5bd28dec2ad",
                "height": 1282,
                "uri": "v12300gd0001daddqavog65lbfmk3350",
                "url_key": "v12300gd0001daddqavog65lbfmk3350_h264_720p_890261",
                "url_list": [
                  "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-4864c799-sg/oABEgImIt1A3DGqKeFtrw0EBaDqTfpEjBQB0qS/?a=1988&bti=ODszNWYuMDE6&&bt=869&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=Nzc4NDo0OTU1NGhpPGdpaEBpMzZuaW85cmRnZDQzZzM2NEA0MDNgNDBgXzAxYjJgMGMxYSMyMGpfMmRzbmFhLS1kLS9zcw%3D%3D&expire=1793121045&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=b…",
                  "https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-4864c799-sg/oABEgImIt1A3DGqKeFtrw0EBaDqTfpEjBQB0qS/?a=1988&bti=ODszNWYuMDE6&&bt=869&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=Nzc4NDo0OTU1NGhpPGdpaEBpMzZuaW85cmRnZDQzZzM2NEA0MDNgNDBgXzAxYjJgMGMxYSMyMGpfMmRzbmFhLS1kLS9zcw%3D%3D&expire=1793121045&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=b…"
                ],
                "url_prefix": null,
                "width": 720
              },
              "quality_type": 10,
              "video_extra": "{}"
            },
            {
              "HDR_bit": "",
              "HDR_type": "",
              "bit_rate": 580141,
              "dub_infos": null,
              "fps": 0,
              "gear_name": "adapt_lower_720_1",
              "is_bytevc1": 1,
              "play_addr": {
                "data_size": 690006,
                "file_cs": "c:0-9694-583e",
                "file_hash": "a42fee3c365bfb6dcd74bfd0d20c1d9d",
                "height": 1282,
                "uri": "v12300gd0001daddqavog65lbfmk3350",
                "url_key": "v12300gd0001daddqavog65lbfmk3350_bytevc1_720p_580141",
                "url_list": [
                  "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-4864c799-sg/ootBn6DrIFE0EDBmKKES19whDqt7fB1bqe8agj/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=ZTo0aTQ0NTs4ZGg4Mzg0OUBpMzZuaW85cmRnZDQzZzM2NEA1MjZfMDZgNV8xL142YS4tYSMyMGpfMmRzbmFhLS1kLS9zcw%3D%3D&expire=1793121045&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=4…",
                  "https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-4864c799-sg/ootBn6DrIFE0EDBmKKES19whDqt7fB1bqe8agj/?a=1988&bti=ODszNWYuMDE6&&bt=566&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=ZTo0aTQ0NTs4ZGg4Mzg0OUBpMzZuaW85cmRnZDQzZzM2NEA1MjZfMDZgNV8xL142YS4tYSMyMGpfMmRzbmFhLS1kLS9zcw%3D%3D&expire=1793121045&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=4…"
                ],
                "url_prefix": null,
                "width": 720
              },
              "quality_type": 14,
              "video_extra": "{}"
            }
          ],
          "cover": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-useast5-p-85c255-tx/oc1DIKSBrwzttuDBDqgFjmSaEf31qrEBeA0qaE",
            "url_list": [
              "https://p19-common-sign.tiktokcdn.com/tos-useast5-p-85c255-tx/oc1DIKSBrwzttuDBDqgFjmSaEf31qrEBeA0qaE~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=a48YlE2RM37jkapc4zWQ4XGJHJk%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "download_addr": {
            "height": 1282,
            "uri": "v12300gd0001daddqavog65lbfmk3350",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-4864c799-sg/oEeM7XoeDVIhekHYCUGaGpLbRYRNAJVgbO3HQg/?a=1988&bti=ODszNWYuMDE6&&bt=810&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=O2czNztnZzc8NGZoO2dmZEBpMzZuaW85cmRnZDQzZzM2NEBgMTVeNjNjXjMxLmBiNTVhYSMyMGpfMmRzbmFhLS1kLS9zcw%3D%3D&expire=1793121045&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=7…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "duration": 9000,
          "dynamic_cover": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-useast5-p-85c255-tx/oAKBqmE61YtBJaSTwe0r3zgIDfE5FDBjBBOqtI",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-85c255-tx/oAKBqmE61YtBJaSTwe0r3zgIDfE5FDBjBBOqtI~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=2zTGjh09QNxyRZfYNaMHUx7F5R0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "has_watermark": true,
          "height": 1282,
          "origin_cover": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-useast5-p-85c255-tx/oEAjerKfBqEUySDzB1DaB0FtUTNmgEqItL38Iw",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-useast5-p-85c255-tx/oEAjerKfBqEUySDzB1DaB0FtUTNmgEqItL38Iw~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=aaWDsPIKpc4GRCDHtPxe5Azfr0s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "play_addr": {
            "height": 1282,
            "uri": "v12300gd0001daddqavog65lbfmk3350",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-4864c799-sg/oABEgImIt1A3DGqKeFtrw0EBaDqTfpEjBQB0qS/?a=1988&bti=ODszNWYuMDE6&&bt=869&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=Nzc4NDo0OTU1NGhpPGdpaEBpMzZuaW85cmRnZDQzZzM2NEA0MDNgNDBgXzAxYjJgMGMxYSMyMGpfMmRzbmFhLS1kLS9zcw%3D%3D&expire=1793121045&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=b…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "ratio": "720p",
          "width": 720
        },
        "is_eligible_for_commission": false,
        "is_paid_partnership": false,
        "is_ad": false,
        "create_time_utc": "2026-09-04T15:00:52.000Z",
        "url": "https://www.tiktok.com/@furryhousefinds/video/7681695185318792462",
        "shop_product_url": null
      }
    },
    {
      "aweme_info": {
        "added_sound_music_info": {
          "author": "TailBitPets",
          "cover_large": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=eb5a039c&x-expires=1793120400&x-signature=r3G%2FNwIJJmQER6xzebETIBErTu4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_medium": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=33672195&x-expires=1793120400&x-signature=a6uzePg%2BNrU8jDtrB3mUJ8RyaDk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_thumb": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6d690e2d&x-expires=1793120400&x-signature=c1URiwrskO3Fb7bViHyvjhgTFTk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "duration": 15,
          "duration_high_precision": {
            "audition_duration_precision": 15,
            "duration_precision": 15,
            "shoot_duration_precision": 15,
            "video_duration_precision": 15
          },
          "id": "7671001957293984542",
          "id_str": "7671001957293984542",
          "is_original_sound": true,
          "mid": "7671001957293984542",
          "play_url": {
            "height": 720,
            "uri": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oUEo0FUbbCAYIrD5Ef0sAqAAEE3f16ie5B9ET7/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=anJpeWs5cmlnPDMzaTU8NEBpanJpeWs5cmlnPDMzaTU8NEBuZnEzMmRrc25hLS1kMTJzYSNuZnEzMmRrc25hLS1kMTJzcw%3D%3D&expire=1792969851&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=86f1876dfe6e62af…",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oUEo0FUbbCAYIrD5Ef0sAqAAEE3f16ie5B9ET7/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=anJpeWs5cmlnPDMzaTU8NEBpanJpeWs5cmlnPDMzaTU8NEBuZnEzMmRrc25hLS1kMTJzYSNuZnEzMmRrc25hLS1kMTJzcw%3D%3D&expire=1792969851&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=86f1876dfe6e62af…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "title": "original sound"
        },
        "author": {
          "avatar_larger": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=eb5a039c&x-expires=1793120400&x-signature=r3G%2FNwIJJmQER6xzebETIBErTu4%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-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=33672195&x-expires=1793120400&x-signature=a6uzePg%2BNrU8jDtrB3mUJ8RyaDk%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-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6d690e2d&x-expires=1793120400&x-signature=c1URiwrskO3Fb7bViHyvjhgTFTk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "avatar_uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
          "follower_count": 839500,
          "following_count": 7,
          "nickname": "TailBitPets",
          "sec_uid": "MS4wLjABAAAAEns3RcyprP4w9gfr9dfCdKQXyEyjxS3VTC78_9nq1fY_-TDGZQwYZmlZ5M4haUK3",
          "secret": 0,
          "uid": "7529381395215746061",
          "unique_id": "tailbitpets"
        },
        "author_user_id": 7529381395215746000,
        "aweme_id": "7671002018269465887",
        "aweme_type": 0,
        "content_type": "video",
        "create_time": 1786044349,
        "desc": "That face says, \"Maybe if I freeze, they'll forget I'm here.\" 🤣 #funny #funnyanimals #funnydogs #funnypets #pets ",
        "desc_language": "en",
        "group_id": "7671002018269465887",
        "is_ads": false,
        "is_top": 0,
        "item_comment_settings": 0,
        "music": {
          "author": "TailBitPets",
          "cover_large": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=eb5a039c&x-expires=1793120400&x-signature=r3G%2FNwIJJmQER6xzebETIBErTu4%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_medium": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=33672195&x-expires=1793120400&x-signature=a6uzePg%2BNrU8jDtrB3mUJ8RyaDk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "cover_thumb": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/c882641bd30e1ab8f7c6dc5348520eed~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=6d690e2d&x-expires=1793120400&x-signature=c1URiwrskO3Fb7bViHyvjhgTFTk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "duration": 15,
          "duration_high_precision": {
            "audition_duration_precision": 15,
            "duration_precision": 15,
            "shoot_duration_precision": 15,
            "video_duration_precision": 15
          },
          "id": "7671001957293984542",
          "id_str": "7671001957293984542",
          "is_original_sound": true,
          "mid": "7671001957293984542",
          "play_url": {
            "height": 720,
            "uri": "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oUEo0FUbbCAYIrD5Ef0sAqAAEE3f16ie5B9ET7/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=anJpeWs5cmlnPDMzaTU8NEBpanJpeWs5cmlnPDMzaTU8NEBuZnEzMmRrc25hLS1kMTJzYSNuZnEzMmRrc25hLS1kMTJzcw%3D%3D&expire=1792969851&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=86f1876dfe6e62af…",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-v-2370c799-sg/oUEo0FUbbCAYIrD5Ef0sAqAAEE3f16ie5B9ET7/?a=1988&bti=ODszNWYuMDE6&&bt=125&ft=GNDpcInz7Thcf4dGXq8Zmo&mime_type=audio_mpeg&rc=anJpeWs5cmlnPDMzaTU8NEBpanJpeWs5cmlnPDMzaTU8NEBuZnEzMmRrc25hLS1kMTJzYSNuZnEzMmRrc25hLS1kMTJzcw%3D%3D&expire=1792969851&l=20261026011035B2F2506F6C26BE3055EB&ply_type=3&policy=3&signature=86f1876dfe6e62af…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "title": "original sound"
        },
        "share_url": "https://www.tiktok.com/@tailbitpets/video/7671002018269465887",
        "statistics": {
          "aweme_id": "7671002018269465887",
          "collect_count": 401074,
          "comment_count": 80800,
          "digg_count": 6100000,
          "play_count": 48600000,
          "repost_count": 0,
          "share_count": 2500000
        },
        "status": {
          "allow_comment": true,
          "allow_share": true,
          "aweme_id": "7671002018269465887",
          "in_reviewing": false,
          "private_status": 0,
          "self_see": false
        },
        "text_extra": [
          {
            "end": 71,
            "hashtag_name": "funny",
            "is_commerce": false,
            "start": 65,
            "type": 1
          },
          {
            "end": 85,
            "hashtag_name": "funnyanimals",
            "is_commerce": false,
            "start": 72,
            "type": 1
          }
        ],
        "video": {
          "bit_rate": [
            {
              "HDR_bit": "",
              "HDR_type": "",
              "bit_rate": 1509114,
              "dub_infos": null,
              "fps": 0,
              "gear_name": "normal_720_0",
              "is_bytevc1": 0,
              "play_addr": {
                "data_size": 2842794,
                "file_cs": "c:0-13994-4dd7",
                "file_hash": "20b2f2d644e366360ccfa68f0f906258",
                "height": 1280,
                "uri": "v15044gf0000d9qdvc7og65p8fi046gg",
                "url_key": "v15044gf0000d9qdvc7og65p8fi046gg_h264_720p_1509114",
                "url_list": [
                  "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oQEjeqUAbpOhgwh0DIICG6FhCCQCQAfyE3Ite8/?a=1988&bti=ODszNWYuMDE6&&bt=1473&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=MzhoOmQzaDxnaDQ5NTc7O0BpajkzaXM5cmZnPDMzaTczNEAyYTYvYDNeXmExYDMtMTJhYSNkMWY1MmQ0c25hLS1kMTJzcw%3D%3D&expire=1793121051&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=ee…",
                  "https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oQEjeqUAbpOhgwh0DIICG6FhCCQCQAfyE3Ite8/?a=1988&bti=ODszNWYuMDE6&&bt=1473&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=MzhoOmQzaDxnaDQ5NTc7O0BpajkzaXM5cmZnPDMzaTczNEAyYTYvYDNeXmExYDMtMTJhYSNkMWY1MmQ0c25hLS1kMTJzcw%3D%3D&expire=1793121051&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=ee…"
                ],
                "url_prefix": null,
                "width": 720
              },
              "quality_type": 10,
              "video_extra": "{}"
            },
            {
              "HDR_bit": "",
              "HDR_type": "",
              "bit_rate": 1289407,
              "dub_infos": null,
              "fps": 0,
              "gear_name": "adapt_lowest_1080_1",
              "is_bytevc1": 1,
              "play_addr": {
                "data_size": 2428921,
                "file_cs": "c:0-14232-44a6",
                "file_hash": "5b9d67201385e350d7ab483f471316da",
                "height": 1920,
                "uri": "v15044gf0000d9qdvc7og65p8fi046gg",
                "url_key": "v15044gf0000d9qdvc7og65p8fi046gg_bytevc1_1080p_1289407",
                "url_list": [
                  "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oohUoMeQCAUyQjUrAIFh64qDwfeGCPbEIICN0E/?a=1988&bti=ODszNWYuMDE6&&bt=1259&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=N2Y3NjVkN2k5MzQ2Zmc0PEBpajkzaXM5cmZnPDMzaTczNEAvNjEtYmAuNl8xNDJeNV5gYSNkMWY1MmQ0c25hLS1kMTJzcw%3D%3D&expire=1793121051&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=42…",
                  "https://v19-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oohUoMeQCAUyQjUrAIFh64qDwfeGCPbEIICN0E/?a=1988&bti=ODszNWYuMDE6&&bt=1259&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=N2Y3NjVkN2k5MzQ2Zmc0PEBpajkzaXM5cmZnPDMzaTczNEAvNjEtYmAuNl8xNDJeNV5gYSNkMWY1MmQ0c25hLS1kMTJzcw%3D%3D&expire=1793121051&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=42…"
                ],
                "url_prefix": null,
                "width": 1080
              },
              "quality_type": 2,
              "video_extra": "{}"
            }
          ],
          "cover": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-useast8-p-0068-tx2/o0D0Imz51EKACAiy3BOi3BfiITBAdBAHsAPO7N",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o0D0Imz51EKACAiy3BOi3BfiITBAdBAHsAPO7N~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=M70U4lFFpVHXvi4%2BeZXtgn0AWsU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "duration": 15000,
          "dynamic_cover": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-useast8-p-0068-tx2/o0D0Imz51EKACAiy3BOi3BfiITBAdBAHsAPO7N",
            "url_list": [
              "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o0D0Imz51EKACAiy3BOi3BfiITBAdBAHsAPO7N~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=LXqU5s%2BKWyeyTzNCvLpXTy8ayxE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "has_watermark": true,
          "height": 1280,
          "origin_cover": {
            "data_size": 0,
            "height": 720,
            "uri": "tos-useast8-p-0068-tx2/o8CIA86IhQZ3IRUheFbwIGE50Dy7f8AGjBCeJq",
            "url_list": [
              "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o8CIA86IhQZ3IRUheFbwIGE50Dy7f8AGjBCeJq~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=yRo00gZR86pVoY3TJCTdC5ZCX3s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my3"
            ],
            "url_prefix": null,
            "width": 720
          },
          "play_addr": {
            "height": 1280,
            "uri": "v15044gf0000d9qdvc7og65p8fi046gg",
            "url_list": [
              "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oQEjeqUAbpOhgwh0DIICG6FhCCQCQAfyE3Ite8/?a=1988&bti=ODszNWYuMDE6&&bt=1473&ft=-Csk_mXMPD12NktyLn-Ux2~FmY9e3wv25VcAp&mime_type=video_mp4&rc=MzhoOmQzaDxnaDQ5NTc7O0BpajkzaXM5cmZnPDMzaTczNEAyYTYvYDNeXmExYDMtMTJhYSNkMWY1MmQ0c25hLS1kMTJzcw%3D%3D&expire=1793121051&l=20261026011035B2F2506F6C26BE3055EB&ply_type=2&policy=2&signature=ee…"
            ],
            "url_prefix": null,
            "width": 720
          },
          "ratio": "720p",
          "width": 720
        },
        "is_eligible_for_commission": false,
        "is_paid_partnership": false,
        "is_ad": false,
        "create_time_utc": "2026-08-06T19:25:49.000Z",
        "url": "https://www.tiktok.com/@tailbitpets/video/7671002018269465887",
        "shop_product_url": null
      }
    }
  ],
  "cursor": 30,
  "has_more": 1
}

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

Results are in `search_item_list`, each video in `aweme_info`. To page, send the response's `cursor` back as `cursor` (30, 60, ...) while `has_more` is 1. No results is an empty list for 0 credits. The video objects do not include `region`. The endpoint can answer a free 503 when it is temporarily unavailable; retry later.

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.