Search APIs
Loading…
← API Store
Social

TikTok

TikTok

Search TikTok videos

GET /tiktok/v1/search/keyword
Test this endpoint

Every response includes credits_used: the credits this call cost.

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.
dateall | day | week | month | 3months | 6monthsDate posted: all (default), day, week, month, 3months, 6months.
sortrelevance | likesrelevance (default) or likes.

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

{
  "cached": false,
  "count": 19,
  "credits_used": 1,
  "next_cursor": "20|2026102319462506A27FBE5343885A3772",
  "query": "cooking",
  "videos": [
    {
      "ai_generated": null,
      "author": {
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
        "id": "7659299286202729485",
        "nickname": "boieqmdk8rc",
        "username": "boieqmdk8rc",
        "verified": false
      },
      "author_info": {
        "avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
        "private": false,
        "sec_uid": "MS4wLjABAAAAz96wnaw0Rqe5nl_CInRMfmeDtaDa3LXxTQ7ZOIfZ7HrfBQaewFQtDUWmqWRLZ49Q",
        "signature": "",
        "url": "https://www.tiktok.com/@boieqmdk8rc"
      },
      "author_stats": {
        "diggCount": "0",
        "followerCount": "15300",
        "followingCount": "0",
        "friendCount": "0",
        "heart": "133100",
        "heartCount": "133100",
        "videoCount": "38"
      },
      "challenges": [
        {
          "desc": null,
          "id": "18973",
          "title": "cooking"
        },
        {
          "desc": "Whether you're baking a cake or perfecting a recipe, we're here for all things #CookingTikTok.",
          "id": "1607060250419201",
          "title": "cookingtiktok"
        },
        "… 3 more"
      ],
      "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osfRIE3R6tYmTPzC2eB3QnyHABFDEqAQYiDV2E~tplv-tiktokx-origin.image?dr=9636&x-e…",
      "create_time": "2026-07-22T18:38:23.000Z",
      "create_time_unix": 1784745503,
      "desc": "#cooking #cookingtiktok #cookingvideos #food #fyp ",
      "diversification_labels": null,
      "duet_enabled": true,
      "duration": 153,
      "hashtags": [
        "cooking",
        "cookingtiktok",
        "… 3 more"
      ],
      "id": "7665423468699094303",
      "images": [],
      "is_ad": false,
      "location_created": null,
      "mentions": [],
      "music": {
        "author": "boieqmdk8rc",
        "id": "7665423485962930974",
        "title": "original sound - boieqmdk8rc"
      },
      "music_info": {
        "album": null,
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
        "duration": 153,
        "original": true,
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-27dcd7-tx2/owBE4iDOFA9jYDh4AJlnCBTUQuoEEVAfAqQfEE/?a=1988&bti=ODszNWY…"
      },
      "pinned": null,
      "poi": null,
      "private_item": false,
      "share_enabled": true,
      "stats": {
        "collectCount": "93",
        "commentCount": "6",
        "diggCount": "170",
        "playCount": "15300",
        "repostCount": "0",
        "shareCount": "41"
      },
      "stitch_enabled": true,
      "suggested_words": null,
      "url": "https://www.tiktok.com/@boieqmdk8rc/video/7665423468699094303",
      "video": {
        "bitrate": 563852,
        "bitrates": [
          {
            "…": "8 fields"
          },
          {
            "…": "8 fields"
          },
          "… 1 more"
        ],
        "codec": "h264",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osfRIE3R6tYmTPzC2eB3QnyHABFDEqAQYiDV2E~tplv-tiktokx-origin.image?dr=9636&x-e…",
        "definition": "540p",
        "download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oklyIQiRDIjD6Ct3AiFgVFRY2BfeqwEQEWAzEY/?a=1988&bti=ODszNWY…",
        "dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/okAABDIaQoERmIihbo5dNPEZ5Bis2B5zERV2o~tplv-tiktokx-origin.image?dr=9636&x-ex…",
        "format": "mp4",
        "height": 1024,
        "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oA0RbIm2PR2GABiDiR2Ioh5EAEBaBVNCo5pd7~tplv-tiktokx-origin.image?dr=9636&x-ex…",
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oAo5ApViaPDEVB5RK2NrxAEbh2mQIREgBDidP/?a=1988&bti=ODszNWYu…",
        "quality": "lowest",
        "ratio": "540p",
        "size": 10840066,
        "subtitles": [
          {
            "…": "4 fields"
          }
        ],
        "width": 576
      }
    },
    {
      "ai_generated": null,
      "author": {
        "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
        "id": "7530266134588425232",
        "nickname": "Food Partners",
        "username": "foodpartners",
        "verified": false
      },
      "author_info": {
        "avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&re…",
        "avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&re…",
        "private": false,
        "sec_uid": "MS4wLjABAAAAfeS8vYCa27jZCGYn7P18p92ZUNCYi9Am--ntYEz6TSXYW5OHErB6ITYElmY-nIf7",
        "signature": "",
        "url": "https://www.tiktok.com/@foodpartners"
      },
      "author_stats": {
        "diggCount": "7",
        "followerCount": "89900",
        "followingCount": "0",
        "friendCount": "0",
        "heart": "618700",
        "heartCount": "618700",
        "videoCount": "117"
      },
      "challenges": [],
      "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o4AAAFRY2O1IfBGA8DBCvEuEKbXKi4iwASyBxv~tplv-tiktokx-origin.image?dr=9636&x-expires…",
      "create_time": "2026-10-21T06:38:51.000Z",
      "create_time_unix": 1792564731,
      "desc": "How to cook braosed pork and soup recipe",
      "diversification_labels": null,
      "duet_enabled": null,
      "duration": 905,
      "hashtags": [],
      "id": "7699006867812388114",
      "images": [],
      "is_ad": false,
      "location_created": null,
      "mentions": [],
      "music": {
        "author": "Food Partners",
        "id": "7699007208801766165",
        "title": "original sound - Food Partners"
      },
      "music_info": {
        "album": null,
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
        "duration": 905,
        "original": true,
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/oAENMQKfFlbIGjUJUd2qeQF4U0kDSXgBCG7JaB/?a=1988&bti=ODszNWYuMDE6&&b…"
      },
      "pinned": null,
      "poi": null,
      "private_item": false,
      "share_enabled": true,
      "stats": {
        "collectCount": "3364",
        "commentCount": "338",
        "diggCount": "21400",
        "playCount": "1900000",
        "repostCount": "0",
        "shareCount": "670"
      },
      "stitch_enabled": null,
      "suggested_words": null,
      "url": "https://www.tiktok.com/@foodpartners/video/7699006867812388114",
      "video": {
        "bitrate": 3516272,
        "bitrates": [
          {
            "…": "8 fields"
          },
          {
            "…": "8 fields"
          },
          "… 2 more"
        ],
        "codec": "h264",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o4AAAFRY2O1IfBGA8DBCvEuEKbXKi4iwASyBxv~tplv-tiktokx-origin.image?dr=9636&x-expires…",
        "definition": "1080p",
        "download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/osB4b6V07Vli9iYhiSvYqIAAtEaEVliyiATWY/?a=1988&bti=ODszNWYuMDE6&&bt…",
        "dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o4AAAFRY2O1IfBGA8DBCvEuEKbXKi4iwASyBxv~tplv-tiktokx-origin.image?dr=9636&x-expires…",
        "format": "mp4",
        "height": 1920,
        "origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/owDLkVLCS2dIEeLrpVgL4LAojvAeYVLwhesgAG~tplv-tiktokx-origin.image?dr=9636&x-expires…",
        "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/osB4b6V07Vli9iYhiSvYqIAAtEaEVliyiATWY/?a=1988&bti=ODszNWYuMDE6&&bt…",
        "quality": "normal",
        "ratio": "1080p",
        "size": 397972193,
        "subtitles": [],
        "width": 1080
      }
    },
    "… 17 more"
  ]
}
Response fields (94)

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

$object
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.querystring
$.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 | null
$.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 | null
$.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_urlstring
$.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