Search TikTok (Top Results)

Run the Top tab of TikTok search from your own code. A single keyword returns the platform's blended result set, mixing videos with the accounts, challenges and sounds that match, in the order TikTok itself ranks them. Cursor and search_id are echoed back with every response and passed into the next call, which keeps deep result pages consistent instead of restarting the query.

Try on Playground

PrimeApi Endpoints > Search Endpoints > Search General(Top)

Endpoint Info

Request Method

GET

Request URL

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

Required Parameters

keyword

Optional Parameters

cursor, search_id

Request Examples

Request Flow

Search General(Top) is a single GET call to /search-general, 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 General(Top) 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-general?keyword=cat&cursor=0&search_id=0" \
  -H "X-PrimeAPI-Key: YOUR_API_KEY"

Python - Requests

import requests

url = "https://api.primeapi.co/search-general?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-general?keyword=cat&cursor=0&search_id=0

Content Type

JSON

Example Response

{
    "status_code": 0,
    "data": [
        {
            "type": 1,
            "item": {
                "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=-Csk_mgdPD12NOcMdE-Ux7J5XY6e3wv25rcAp&mime_type=video_mp4&qs=0&rc=ODlpOmZoMzo8ODM0Mzo8ZkBpMzN4OXY5cmpodTMzZjczM0BfLjExMy41XzQxYWM1XzI1YSNpay5gMmRraWdgLS1kMWNzcw%3D%3D&btag=e00090000&expire=1737331946&l=202501180009458AE08D62AFCEE637356D&ply_type=2&policy=2&signature=51ce0dbc7baee3ed4a3a48ea9e537879&tk=tt_chain_token",
                    "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068-euttp/o40TvgYEwHOidqb8ES2wugZqiUEryYA1BIPQB/?a=1988&bti=NDU3ZjAwOg%3D%3D&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=2036&bt=1018&cs=0&ds=3&ft=-Csk_mgdPD12NOcMdE-Ux7J5XY6e3wv25rcAp&mime_type=video_mp4&qs=0&rc=O2VpOzlpPDdnPDMzOGc1OUBpMzN4OXY5cmpodTMzZjczM0BfYl80Xy9gXjQxXzMtMy4vYSNpay5gMmRraWdgLS1kMWNzcw%3D%3D&btag=e00090000&expire=1737331946&l=202501180009458AE08D62AFCEE637356D&ply_type=2&policy=2&signature=b71bdea154e29c0dece1b3db79bc1adf&tk=tt_chain_token",
                    "shareCover": [
                        "",
  ... (truncated)

Show full response

Related Endpoints

More TikTok Search Endpoints

Search TikTok Videos 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