Search TikTok Videos

Narrow TikTok search to video results only. The endpoint returns an item list for your keyword, each entry holding its caption, author, sound and play, like, comment and share counts, so results can be ranked or filtered on your own side. Cursor and search_id carry paging state between calls, letting you collect far more than a single page of matches.

Try on Playground

PrimeApi Endpoints > Search Endpoints > Search Video

Endpoint Info

Request Method

GET

Request URL

https://api.primeapi.co/search-video?keyword={keyword}&cursor={cursor}&search_id={search_id}

Required Parameters

keyword

Optional Parameters

cursor, search_id

Request Examples

Request Flow

Search Video is a single GET call to /search-video, and keyword has to travel with it in the query string. cursor, search_id then shape what comes back. Swap YOUR_API_KEY for your own key and both snippets below run as they are.

Authentication

Header based. Send X-PrimeAPI-Key with every request — there is no OAuth handshake and no token to refresh.

Credits

One Search Video call costs 1 credit. Your remaining balance comes back on every response in the X-PrimeAPI-Balance header, so you can watch usage without a second lookup.

cURL

curl -X GET "https://api.primeapi.co/search-video?keyword=cat&cursor=0&search_id=0" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/search-video?keyword=cat&cursor=0&search_id=0"
headers = {"X-PrimeAPI-Key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)

print(response.json())
print("Credits left:", response.headers.get("X-PrimeAPI-Balance"))

Endpoint Response

Example URL

https://api.primeapi.co/search-video?keyword=cat&cursor=0&search_id=0

Content Type

JSON

Example Response

{
    "status_code": 0,
    "item_list": [
        {
            "id": "7414872052433194273",
            "desc": "Man takes in cats #hopecore #hope #fun ",
            "createTime": 1726409446,
            "video": {
                "id": "7414872052433194273",
                "height": 576,
                "width": 1024,
                "duration": 160,
                "ratio": "540p",
                "cover": "https://p16-sign-useast2a.tiktokcdn.com/obj/tos-useast2a-p-0037-euttp/396df3849f404d1dad556d876d80d416_1726409469?lk3s=b59d6b55&x-expires=1737331200&x-signature=6nqDxhAYHxKhIAk87FFdIrWoxrU%3D&shp=b59d6b55&shcp=-",
                "originCover": "https://p16-sign-useast2a.tiktokcdn.com/obj/tos-useast2a-p-0037-euttp/534dda66b47443309958c5325bca2875_1726409470?lk3s=b59d6b55&x-expires=1737331200&x-signature=2emP3JXx3GJwYPKLXxNpPajDP8Y%3D&shp=b59d6b55&shcp=-",
                "dynamicCover": "https://p16-sign-useast2a.tiktokcdn.com/obj/tos-useast2a-p-0037-euttp/9edf8a22b85040199f6a22e11822e64b_1726409470?lk3s=b59d6b55&x-expires=1737331200&x-signature=NTMotVTfTxCzDJ0cRaSoSiqSpTI%3D&shp=b59d6b55&shcp=-",
                "playAddr": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/osAVMq6WwiEyrxYmwZBY0TvqTE8uQbrVBigIP/?a=1988&bti=NDU3ZjAwOg%3D%3D&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2274&bt=1137&cs=0&ds=6&ft=4fUEKMFx8Zmo0KRhxb4jVUGb-pWrKsd.&mime_type=video_mp4&qs=0&rc=ODlpOmZoMzo8ODM0Mzo8ZkBpMzN4OXY5cmpodTMzZjczM0BfLjExMy41XzQxYWM1XzI1YSNpay5gMmRraWdgLS1kMWNzcw%3D%3D&btag=e00090000&expire=1737332058&l=20250118001136D2B1A8847D9F6D369DA0&ply_type=2&policy=2&signature=cb8712a0bac1d211995864e797cadf6f&tk=tt_chain_token",
                "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068-euttp/oEIZnukWiv8ibABEA8PqwEBXq0gYQw1YxiryT/?a=1988&bti=NDU3ZjAwOg%3D%3D&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2320&bt=1160&cs=0&ds=3&ft=4fUEKMFx8Zmo0KRhxb4jVUGb-pWrKsd.&mime_type=video_mp4&qs=0&rc=NGQ2OjZpaTs7ZjtpPDdoOEBpMzN4OXY5cmpodTMzZjczM0AwYTBiNDVgNjIxXi8zNmNgYSNpay5gMmRraWdgLS1kMWNzcw%3D%3D&btag=e00090000&expire=1737332058&l=20250118001136D2B1A8847D9F6D369DA0&ply_type=2&policy=2&signature=1b8c635a87d43b293f7a3fecb54757e0&tk=tt_chain_token",
                "shareCover": [
                    "",
  ... (truncated)

Show full response

Related Endpoints

More TikTok Search Endpoints

Search TikTok (Top Results) Search TikTok Users Search TikTok Live Get TikTok Searched Suggest

View all Search Endpoints

Contact

You can contact us via Telegram or Gmail

@primeapi_co

Gmail

primeapico@gmail