Search APIs
Loading…
← API Store
Social

TikTok

TikTok

TikTok videos for a keyword (public hashtag feed)

GET /tiktok/v1/search
Test this endpoint

Every response includes credits_used: the credits this call cost.

The public hashtag feed for the keyword (spaces removed): the videos TikTok files under #<keyword>, 30 per page. For TikTok's own keyword search use /tiktok/v1/search/keyword.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: cooking
cursorstringValue of `next_cursor` from the previous page; `next_cursor` is null on the last page.

Every endpoint also takes: raw、fields、fresh、output、records

{
  "cached": false,
  "count": 30,
  "credits_used": 5,
  "pages": [
    {
      "cursor": "30",
      "extra": {
        "fatal_item_ids": [],
        "logid": "20261023194636D71FC7CD25EFF248E5B6",
        "now": 1792784797000
      },
      "hasMore": true,
      "log_pb": {
        "impr_id": "20261023194636D71FC7CD25EFF248E5B6"
      },
      "statusCode": 0,
      "status_code": 0,
      "status_msg": ""
    }
  ],
  "query": "cooking",
  "source": "hashtag #cooking",
  "videos": [
    {
      "ai_generated": null,
      "author": {
        "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/db81b659d4224bce4d93eb04ac625022~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=…",
        "id": "7521686775371842591",
        "nickname": "Shanye",
        "username": "tftk007",
        "verified": false
      },
      "author_info": {
        "avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/db81b659d4224bce4d93eb04ac625022~tplv-tiktokx-cropcenter:720:720.jpeg?dr=96…",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/db81b659d4224bce4d93eb04ac625022~tplv-tiktokx-cropcenter:100:100.jpeg?dr=96…",
        "private": false,
        "sec_uid": "MS4wLjABAAAARrAQ-DolrigX0zNo4UVvGyixVUhH7ZAEJs4dc-__utkItYr-_EuxA_4MYC45sxMl",
        "signature": "For business cooperation  email address:[email protected]",
        "url": "https://www.tiktok.com/@tftk007"
      },
      "author_stats": {
        "diggCount": "365",
        "followerCount": "3000000",
        "followingCount": "2",
        "friendCount": "0",
        "heart": "60900000",
        "heartCount": "60900000",
        "videoCount": "328"
      },
      "challenges": [
        {
          "desc": null,
          "id": "1689794738682881",
          "title": "cookingforest"
        },
        {
          "desc": null,
          "id": "76472060",
          "title": "outdoorcooking"
        },
        "… 7 more"
      ],
      "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0fdsvDljqYfIgEuirgFlEiDBcumuQR08vSAFD~tplv-tiktokx-origin.image?dr=9636&x-ex…",
      "create_time": "2026-09-28T10:40:31.000Z",
      "create_time_unix": 1790592031,
      "desc": "#cookingforest#outdoorcooking #cooking #Recipe #beef  #survivor#cookingasmr #leon#outdoorcooking #cookingnature",
      "diversification_labels": null,
      "duet_enabled": true,
      "duration": 363,
      "hashtags": [
        "cookingforest",
        "outdoorcooking",
        "… 8 more"
      ],
      "id": "7690533903756561678",
      "images": [],
      "is_ad": false,
      "location_created": null,
      "mentions": [],
      "music": {
        "author": "Dương Cường Camera",
        "id": "7061837257761639194",
        "title": "nhạc nền - Dương Cường Digital Camera"
      },
      "music_info": {
        "album": null,
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/feaa1c8c3939bb76e9c4c24029524ce9~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
        "duration": 428,
        "original": true,
        "play_url": "https://v16m.tiktokcdn-us.com/16c863a2886c3ff0dddaa3df42092b2e/6adc0fa9/video/tos/useast5/tos-useast5-v-27dcd7c799-tx/9e06825ae0384161adfde3…"
      },
      "pinned": null,
      "poi": null,
      "private_item": false,
      "share_enabled": true,
      "stats": {
        "collectCount": "1552",
        "commentCount": "353",
        "diggCount": "16400",
        "playCount": "155200",
        "repostCount": "0",
        "shareCount": "969"
      },
      "stitch_enabled": true,
      "suggested_words": null,
      "url": "https://www.tiktok.com/@tftk007/video/7690533903756561678",
      "video": {
        "bitrate": 3175707,
        "bitrates": [
          {
            "…": "8 fields"
          },
          {
            "…": "8 fields"
          },
          "… 2 more"
        ],
        "codec": "h264",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0fdsvDljqYfIgEuirgFlEiDBcumuQR08vSAFD~tplv-tiktokx-origin.image?dr=9636&x-ex…",
        "definition": "720p",
        "download_url": null,
        "dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/okysI5BqDgEI5KRzxi3DfDXA6O9Bui3ejSwRVE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
        "format": "mp4",
        "height": 1280,
        "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ogAC6iwOeuyDBRaSRfsBj2E3gSiYDu0IXqhVIz~tplv-tiktokx-origin.image?dr=9636&x-ex…",
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c001-tx/o4ROsDOVA3vEXSXqzjSiiewuIBsfoJm6EgBREy/?a=1988&bti=ODszN…",
        "quality": "normal",
        "ratio": "720p",
        "size": 144428807,
        "subtitles": [],
        "width": 720
      }
    },
    {
      "ai_generated": null,
      "author": {
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
        "id": "7303785690449314859",
        "nickname": "us_delicious_cooking",
        "username": "us_delicious_cooking",
        "verified": false
      },
      "author_info": {
        "avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
        "private": false,
        "sec_uid": "MS4wLjABAAAAYoV2_uqInLEaYr7zVS4HgJQU_HXX9wSodGsq_KvJJbGHxsEoNlPn3NUeT1ppx-sl",
        "signature": "",
        "url": "https://www.tiktok.com/@us_delicious_cooking"
      },
      "author_stats": {
        "diggCount": "1",
        "followerCount": "220500",
        "followingCount": "0",
        "friendCount": "0",
        "heart": "1600000",
        "heartCount": "1600000",
        "videoCount": "1186"
      },
      "challenges": [
        {
          "desc": "Share your favorite #Recipes.",
          "id": "4436280",
          "title": "recipes"
        },
        {
          "desc": "Share an #easyrecipe for Singapore's local food! 10 mouthwatering entries will stand to win $100 NTUC FairPrice vouchers each. 😋🎉\n\nFrom 7 to…",
          "id": "29431938",
          "title": "EasyRecipe"
        },
        "… 14 more"
      ],
      "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o0dgotFa1IDDenDJEGGAf6EEVqQlDmZIqkZveC~tplv-tiktokx-origin.image?dr=9636&x…",
      "create_time": "2026-09-24T19:23:10.000Z",
      "create_time_unix": 1790277790,
      "desc": "#recipes #easyrecipe #cooking #dinnerideas #yummyfood #dinnermadeeasy #foodtok #homecooking #quickrecipes #simplemeals #easycooking #foodide…",
      "diversification_labels": null,
      "duet_enabled": true,
      "duration": 1183,
      "hashtags": [
        "recipes",
        "easyrecipe",
        "… 14 more"
      ],
      "id": "7689185590528576799",
      "images": [],
      "is_ad": false,
      "location_created": null,
      "mentions": [],
      "music": {
        "author": "us_delicious_cooking",
        "id": "7689186070201715487",
        "title": "original sound"
      },
      "music_info": {
        "album": null,
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
        "duration": 1180,
        "original": true,
        "play_url": "https://v16m.tiktokcdn-us.com/5c93f087d7bfb25adcfae03753746f15/6adc1299/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oIASeIveVIATF8NLEGCO6xmaL…"
      },
      "pinned": null,
      "poi": null,
      "private_item": false,
      "share_enabled": true,
      "stats": {
        "collectCount": "2504",
        "commentCount": "43",
        "diggCount": "2407",
        "playCount": "262200",
        "repostCount": "0",
        "shareCount": "1192"
      },
      "stitch_enabled": true,
      "suggested_words": null,
      "url": "https://www.tiktok.com/@us_delicious_cooking/video/7689185590528576799",
      "video": {
        "bitrate": 1838382,
        "bitrates": [
          {
            "…": "8 fields"
          },
          {
            "…": "8 fields"
          },
          "… 2 more"
        ],
        "codec": "h264",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o0dgotFa1IDDenDJEGGAf6EEVqQlDmZIqkZveC~tplv-tiktokx-origin.image?dr=9636&x…",
        "definition": "720p",
        "download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-85c255-tx2/oYFDDEAZQEVnocg4ICq91qFk6aGOeIfvnAJXEe/?a=1988&bti=ODszNWY…",
        "dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o4FEaKFVaJsoI1eFEn6vVDeCqSqfQoZXgEGAQD~tplv-tiktokx-origin.image?dr=9636&x…",
        "format": "mp4",
        "height": 1280,
        "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o80oQGFvH6qeG1fqIDDJQEanDEVA8CdgZvEZfx~tplv-tiktokx-origin.image?dr=9636&x…",
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-85c255-tx2/ocfV0oDdgqDaZqIE9fFEeQ2oIGG6IACnv1oqEJ/?a=1988&bti=ODszNWY…",
        "quality": "normal",
        "ratio": "720p",
        "size": 272027050,
        "subtitles": [
          {
            "…": "4 fields"
          }
        ],
        "width": 720
      }
    },
    "… 28 more"
  ]
}
Response fields (107)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.pagesarray
$.pages[]object
$.pages[].cursorstring
$.pages[].extraobject
$.pages[].extra.fatal_item_idsarray
$.pages[].extra.logidstring
$.pages[].extra.nowinteger
$.pages[].hasMoreboolean
$.pages[].log_pbobject
$.pages[].log_pb.impr_idstring
$.pages[].statusCodeinteger
$.pages[].status_codeinteger
$.pages[].status_msgstring
$.querystring
$.sourcestring
$.videosarray
$.videos[]object | string
$.videos[].ai_generatednull
$.videos[].authorobject
$.videos[].author.avatarstring
$.videos[].author.idstring
$.videos[].author.nicknamestring
$.videos[].author.usernamestring
$.videos[].author.verifiedboolean
$.videos[].author_infoobject
$.videos[].author_info.avatar_mediumstring
$.videos[].author_info.avatar_thumbstring
$.videos[].author_info.privateboolean
$.videos[].author_info.sec_uidstring
$.videos[].author_info.signaturestring
$.videos[].author_info.urlstring
$.videos[].author_statsobject
$.videos[].author_stats.diggCountstring
$.videos[].author_stats.followerCountstring
$.videos[].author_stats.followingCountstring
$.videos[].author_stats.friendCountstring
$.videos[].author_stats.heartstring
$.videos[].author_stats.heartCountstring
$.videos[].author_stats.videoCountstring
$.videos[].challengesarray
$.videos[].challenges[]object | string
$.videos[].challenges[].descnull | string
$.videos[].challenges[].idstring
$.videos[].challenges[].titlestring
$.videos[].coverstring
$.videos[].create_timestring
$.videos[].create_time_unixinteger
$.videos[].descstring
$.videos[].diversification_labelsnull
$.videos[].duet_enabledboolean
$.videos[].durationinteger
$.videos[].hashtagsarray
$.videos[].hashtags[]string
$.videos[].idstring
$.videos[].imagesarray
$.videos[].is_adboolean
$.videos[].location_creatednull
$.videos[].mentionsarray
$.videos[].musicobject
$.videos[].music.authorstring
$.videos[].music.idstring
$.videos[].music.titlestring
$.videos[].music_infoobject
$.videos[].music_info.albumnull
$.videos[].music_info.coverstring
$.videos[].music_info.durationinteger
$.videos[].music_info.originalboolean
$.videos[].music_info.play_urlstring
$.videos[].pinnednull
$.videos[].poinull
$.videos[].private_itemboolean
$.videos[].share_enabledboolean
$.videos[].statsobject
$.videos[].stats.collectCountstring
$.videos[].stats.commentCountstring
$.videos[].stats.diggCountstring
$.videos[].stats.playCountstring
$.videos[].stats.repostCountstring
$.videos[].stats.shareCountstring
$.videos[].stitch_enabledboolean
$.videos[].suggested_wordsnull
$.videos[].urlstring
$.videos[].videoobject
$.videos[].video.bitrateinteger
$.videos[].video.bitratesarray
$.videos[].video.bitrates[]object | string
$.videos[].video.bitrates[].…string
$.videos[].video.codecstring
$.videos[].video.coverstring
$.videos[].video.definitionstring
$.videos[].video.download_urlnull | string
$.videos[].video.dynamic_coverstring
$.videos[].video.formatstring
$.videos[].video.heightinteger
$.videos[].video.origin_coverstring
$.videos[].video.play_urlstring
$.videos[].video.qualitystring
$.videos[].video.ratiostring
$.videos[].video.sizeinteger
$.videos[].video.subtitlesarray
$.videos[].video.subtitles[]object
$.videos[].video.subtitles[].…string
$.videos[].video.widthinteger