TikTok API: Search videos (v3)

Search videos by keyword. Each result has the caption, author, counts, cover, sound and hashtags. Paginate with cursor and has_more; a page can hold fewer than count.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

keyword*string

Search text. Returns videos that match it.

Length1 <= length <= 200

count?integer

Items to request per page, 1 to 50. A page can hold fewer.

Range1 <= value <= 50

Default30

cursor?string

cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Length1 <= length <= 1000

curl -X GET "https://example.com/v3/tiktok/search?keyword=space+launch" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "items": [      {        "id": "7696226653374139678",        "url": "https://www.tiktok.com/@espn/video/7696226653374139678",        "description": "🔥🔥🔥 (via @Will Nye The Turf grass guy) #espnsocial #rocket #space #spacex  ",        "created_at": "2026-10-13T18:50:17.000Z",        "author": {          "id": "6663294979903422470",          "sec_uid": "MS4wLjABAAAAbq-1Yqpp1a6u5KbV_sMg93_FK7AN3d6MJeZ3H0Yj3vZXOtqFXXjc2TIkMW7flCxX",          "username": "espn",          "nickname": "ESPN",          "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7310257743653240837~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=9608&refresh_token=6d51737e&x-expires=1792249200&x-signature=Aw6bqAtC%2Fimh0OlciUdKGdwHVAw%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=avatar&s=SEARCH",          "verified": true        },        "stats": {          "plays": 2698830,          "likes": 214227,          "comments": 3135,          "shares": 16299,          "saves": 15273        },        "video": {          "duration": 24.5,          "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/ooGiQIhHqgen7LCIUqbecNUtf9B4CjAv5VgPAI~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=10397&idc=no1a&ps=13740610&refresh_token=1b882d10&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1792184400&x-signature=%2BbrDe5VFGlj%2FOWnB28mLK1NIhd4%3D",          "width": 720,          "height": 900        },        "music": {          "id": "7586898985509799937",          "title": "Thanos The Mad Titan",          "author": "The Hyphenate & Judo Keys"        },        "hashtags": [          "espnsocial",          "rocket",          "space",          "spacex"        ]      },      {        "id": "7696173198886325535",        "url": "https://www.tiktok.com/@kellydeal2/video/7696173198886325535",        "description": "The most stunning launch 🚀 😍 #fyp #spacex #rocketlaunch #falcon #NASA",        "created_at": "2026-10-13T15:22:51.000Z",        "author": {          "id": "6806488877773587462",          "sec_uid": "MS4wLjABAAAAhow2W2qLSDYRojdjUyv2aTlUjDjCSB2p-7bthEWNFblgR9K03B0jz5_-yAfH_J9g",          "username": "kellydeal2",          "nickname": "Kelly Deal",          "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7330295555543400453~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=9608&refresh_token=57e57a59&x-expires=1792249200&x-signature=rn8nsSxV9JPlSyg5sVQ9CUkrhc0%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=c1333099&idc=no1a&sc=avatar&s=SEARCH",          "verified": false        },        "stats": {          "plays": 2590278,          "likes": 541208,          "comments": 2350,          "shares": 66808,          "saves": 39961        },        "video": {          "duration": 18.4,          "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oMFzZAYqzAeJETKAE0rkGRmCVRcfQcXAEa2AID~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=10397&idc=no1a&ps=13740610&refresh_token=367da085&shcp=9b759fb9&shp=c1333099&t=4d5b0474&x-expires=1792184400&x-signature=xpydymRVylW4jzQE%2FohIWKnbe6A%3D",          "width": 720,          "height": 1280        },        "music": {          "id": "7085461187713828866",          "title": "Interstellar on Piano",          "author": "Andy Morris"        },        "hashtags": [          "fyp",          "spacex",          "rocketlaunch",          "falcon",          "NASA"        ]      }    ],    "count": 2,    "cursor": "eyJwIjoiZXlKdlptWnpaWFFpT2pNd0xDSnpaV0Z5WTJoZmFXUWlPaUl5TURJMk1UQXhOakUxTWpjME9ESTFORGM0Tmpjek16TkRRMEUxUmtKR05UQkVJbjAiLCJvIjoiMzAifQ",    "has_more": true  }}