Search videos by keyword

GET/v1/video/search2 Credits / video (min 10 Credits)($0.20 / 1K videos)

Search public TikTok videos by keyword with filters for region, sort order, and publish time window. Every video item includes direct no-watermark playback links and full engagement statistics. Paginated via cursor and hasMore.

Query Parameters

keywordsstringrequired
Search keywords, e.g. ai tools or skincare routine.
Example: ai tools
countinteger (1 to 30)
Number of videos to return per page (max 30).
Example: 20
cursorinteger
Pagination offset cursor (0 for first page, then pass data.cursor from the previous response).
Example: 0
regionstring
Two-letter ISO country code (US, GB, JP, DE, BR, etc.).
Example: US
sort_typeinteger
Sort order: 0 = Relevance, 1 = Most Liked, 3 = Newest.
Example: 0
publish_timeinteger
Publish window filter: 0 = All time, 1 = Yesterday, 7 = Past 7 days, 30 = Past 30 days, 90 = Past 3 months, 180 = Past 6 months.
Example: 0

Example Request (cURL / Python / JavaScript)

curl "https://api.shortvidapi.com/v1/video/search?keywords=ai+tools" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://shortvidapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "videos": [
      {
        "aweme_id": "v15044gf0000dbenid7og65iln63dbq0",
        "video_id": "7700444273329671455",
        "region": "US",
        "title": "The best AI tool for every job: Writing emails → ChatGPT Turning notes into a plan → Claude Making a study guide → NotebookLM Researching competitors → Perplexity Creating UGC ads → Higgsfield Building apps → Claude Code...",
        "content_desc": [
          "The best AI tool for every job:",
          ""
        ],
        "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/och60XA3fAImJkufBDRq5qBo8EEVFEJtWXwQGl~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=14577&idc=my2&ps=13740610&refresh_token=a035...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/owv1ptJIOzjDCgegeCLVA5NGAQqk2IzVevuIaK~tplv-tiktokx-origin.image?dr=1364&refresh_token=8b933c8b&x-expires=1793631600&x-signature=9rTw66cbmieGPDUWYbUDbVZUIm8%3D...",
        "origin_cover": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ogtgVMvzIGeuDqa6NQLeAJgIjAKdCupeIxCV6v~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=8482ff86&x-expires=1793631600&x-signature=NXAKWaM2F3y0lR1...",
        "duration": 25,
        "play": "https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6ae8a86c/video/tos/alisg/tos-alisg-ve-37c799-sg/okHzAevzGIeVLbDIp6IevIgWuCqRtQaAKpj4JA/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=590&ft=JS-FIDyjNl~VQQUnU~...",
        "wmplay": "https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6ae8a86c/video/tos/alisg/tos-alisg-ve-37c799-sg/okHzAevzGIeVLbDIp6IevIgWuCqRtQaAKpj4JA/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=590&ft=JS-FIDyjNl~VQQUnU~...",
        "size": 1948960,
        "wm_size": 0,
        "music": "https://v16-ies-music.tiktokcdn.com/214d094b27a74eebcda233b216b3d17f/6af091a8/video/tos/alisg/tos-alisg-ve-2370c799-sg/oMnYAEjMJl8QqC0ffb43uXBPRbjDUBFVVLFEAP/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=gk-H...",
        "music_info": {
          "id": "7700444318988847902",
          "title": "original sound - maverickgpt",
          "play": "https://v16-ies-music.tiktokcdn.com/214d094b27a74eebcda233b216b3d17f/6af091a8/video/tos/alisg/tos-alisg-ve-2370c799-sg/oMnYAEjMJl8QqC0ffb43uXBPRbjDUBFVVLFEAP/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=gk-H...",
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=10796&refresh_token=15dab5ec&x-expires=1793631600&x-signature=mIqR2NWERKttz%2FPcN...",
          "author": "Maverick Maltin | AI & ChatGPT",
          "original": true,
          "duration": 25,
          "album": "",
          "create_time": 1792899414
        },
        "play_count": 1137030,
        "digg_count": 62323,
        "comment_count": 318,
        "share_count": 18159,
        "download_count": 116,
        "collect_count": 63751,
        "create_time": 1792899412,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20261101231218F3ED520687EEF99D1732\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "6788812283432059910",
          "unique_id": "maverickgpt",
          "nickname": "Maverick Maltin | AI & ChatGPT",
          "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0f0244a6&x-expires=1793631600&x-signature=oiZg4%2BxgBNV1KRsWzm5..."
        },
        "is_nff_or_nr": false,
        "is_top": 0
      },
      {
        "aweme_id": "v15044gf0000d8f76gnog65v6007n3sg",
        "video_id": "7646676174059392286",
        "region": "US",
        "title": "Best Ai tools in 2026 ",
        "content_desc": [],
        "cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o8eFpH6IOUALQAIHcD3LYIrGCpayPQjeaeqAEI~tplv-tiktokx-cropcenter:500:800.jpeg?biz_tag=musically_video.video_cover&dr=14577&idc=my2&ps=13740610&refresh_token=0369...",
        "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/ogQTeU3IHCO3vAjAeDQAQLIIacGyHPBEYeyF6q~tplv-tiktokx-origin.image?dr=1364&refresh_token=41070638&x-expires=1793631600&x-signature=4kn4xQB5WSWW549uSoRqY1z88oQ%3D...",
        "origin_cover": "https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oID8aUAYIHeOALZg3BqQJAI5sFmPCyGeIQ0ejH~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=17995&refresh_token=67e5fdc0&x-expires=1793631600&x-signature=wmQCRBZwLu0yAK4...",
        "duration": 27,
        "play": "https://v19.tiktokcdn.com/c9910bff45751b91d14301fee0cfadea/6ae8a86e/video/tos/alisg/tos-alisg-ve-37c799-sg/osEgOIFF8eUAyfx5ANIBCLPIjI1GYAaqDQe43H/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=755&ft=JS-FIDyjNl~VQQUnU~...",
        "wmplay": "https://v19.tiktokcdn.com/c9910bff45751b91d14301fee0cfadea/6ae8a86e/video/tos/alisg/tos-alisg-ve-37c799-sg/osEgOIFF8eUAyfx5ANIBCLPIjI1GYAaqDQe43H/?a=1233&bti=NTY6QGo0QHM6OjZANDQuYCMucCMxNDNg&&bt=755&ft=JS-FIDyjNl~VQQUnU~...",
        "size": 2661547,
        "wm_size": 0,
        "music": "https://v16-ies-music.tiktokcdn.com/43e0b3431fe1dc4d53db2d437a7a022d/6af091aa/video/tos/maliva/tos-maliva-ve-27dcd7c799-us/okuIYcUeG6TCEfzoFOE4nIMDmARqPP4CK7fK6r/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=...",
        "music_info": {
          "id": "7646676246730541855",
          "title": "original sound - maverickgpt",
          "play": "https://v16-ies-music.tiktokcdn.com/43e0b3431fe1dc4d53db2d437a7a022d/6af091aa/video/tos/maliva/tos-maliva-ve-27dcd7c799-us/okuIYcUeG6TCEfzoFOE4nIMDmARqPP4CK7fK6r/?a=583965&bti=NEBzNTY6QGo6OjZALnAjNDQuYCMxNDNg&&bt=125&ft=...",
          "cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=10796&refresh_token=15dab5ec&x-expires=1793631600&x-signature=mIqR2NWERKttz%2FPcN...",
          "author": "Maverick Maltin | AI & ChatGPT",
          "original": true,
          "duration": 27,
          "album": "",
          "create_time": 1780380576
        },
        "play_count": 3656171,
        "digg_count": 204771,
        "comment_count": 9543,
        "share_count": 45213,
        "download_count": 1149,
        "collect_count": 196584,
        "create_time": 1780380574,
        "anchors": null,
        "anchors_extras": "",
        "is_ad": false,
        "commerce_info": {
          "adv_promotable": false,
          "auction_ad_invited": false,
          "branded_content_type": 0,
          "is_diversion_ad": 0,
          "organic_log_extra": "{\"req_id\":\"20261101231218F3ED520687EEF99D1732\"}",
          "with_comment_filter_words": false
        },
        "commercial_video_info": "",
        "item_comment_settings": 0,
        "mentioned_users": "",
        "author": {
          "id": "6788812283432059910",
          "unique_id": "maverickgpt",
          "nickname": "Maverick Maltin | AI & ChatGPT",
          "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/0c950557c61fb5495b379d40a84d859b~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=10793&refresh_token=0f0244a6&x-expires=1793631600&x-signature=oiZg4%2BxgBNV1KRsWzm5..."
        },
        "is_nff_or_nr": false,
        "is_top": 0
      }
    ],
    "cursor": 5,
    "hasMore": true
  }
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://shortvidapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`videos`	array of object
`aweme_id`	string	Example: v15044gf0000dbenid7og65iln63dbq0
`video_id`	string	Example: 7700444273329671455
`region`	string	Example: US
`title`	string	Example: The best AI tool for every job: Writing emails → ChatGPT Tur
`content_desc`	array of object
`cover`	string	Example: https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2
`ai_dynamic_cover`	string	Example: https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2
`origin_cover`	string	Example: https://p19-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2
`duration`	integer	Example: 25
`play`	string	Example: https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6
`wmplay`	string	Example: https://v19.tiktokcdn.com/444fe5e94f2cdae5cad74e5f5e53561d/6
`size`	integer	Example: 1948960
`wm_size`	integer	Example: 0
`music`	string	Example: https://v16-ies-music.tiktokcdn.com/214d094b27a74eebcda233b2
`music_info`	object
`play_count`	integer	Example: 1137030
`digg_count`	integer	Example: 62323
`comment_count`	integer	Example: 318
`share_count`	integer	Example: 18159
`download_count`	integer	Example: 116
`collect_count`	integer	Example: 63751
`create_time`	integer	Example: 1792899412
`anchors`	string
`anchors_extras`	string	Example:
`is_ad`	boolean	Example: false
`commerce_info`	object
`commercial_video_info`	string	Example:
`item_comment_settings`	integer	Example: 0
`mentioned_users`	string	Example:
`author`	object
`is_nff_or_nr`	boolean	Example: false
`is_top`	integer	Example: 0
`cursor`	integer	Example: 5
`hasMore`	boolean	Example: true

Status Codes

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.

Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.