Top Search - Real-time interface

API Overview
This realtime top-search endpoint returns high-priority results from TikTok's search context for a keyword. It is useful when you want to understand what users are most likely to encounter at the top of search rather than what the recommendation feed is pushing.

Recommended Use Cases

Study keyword behavior in TikTok search

Understand search-surface competition around a term

Identify what content direction dominates top search results

Support SEO or search-oriented content planning

Notes

Realtime endpoints may hit risk control; if the API returns code=500, keep retrying (code=500 does not consume your current usage quota)

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Responses

🟢200成功

application/json

Bodyapplication/json

Example

{
    "code": 0,
    "message": "ok",
    "data": {
        "ad_info": {},
        "backtrace": "ad_cursor%3D1%3Bcurrent_page%3D1",
        "components": null,
        "cursor": 1,
        "data": [
            {
                "aweme_info": {
                    "added_sound_music_info": {
                        "album": "",
                        "allow_offline_music_to_detail_page": false,
                        "artists": [],
                        "audition_duration": 10,
                        "author": "jam🍉",
                        "author_deleted": false,
                        "author_position": null,
                        "avatar_medium": {
                            "data_size": 0,
                            "height": 720,
                            "uri": "tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540",
                            "url_list": [
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=7b9c54b5&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=UQyHc3124VqhXLbHTA3HTw4IJbw%3D",
                                "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=cf228296&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=e7AwYkaRNu64q4aKnPw0N5lj0t0%3D",
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:720:720:q70.jpeg?dr=8836&idc=useast5&ps=87d6e48a&refresh_token=b840a197&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=3XVqlGVq4whVa5kLQtSvjVOox20%3D"
                            ],
                            "url_prefix": null,
                            "width": 720
                        },
                        "avatar_thumb": {
                            "data_size": 0,
                            "height": 720,
                            "uri": "tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540",
                            "url_list": [
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=1988e99e&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=rUECdLL6IQiRxrQrXI6MYhGV3k4%3D",
                                "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=30b5c97e&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=Ca9iub5c0KVF90fP1H3gztKT7HU%3D",
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:100:100:q70.jpeg?dr=8835&idc=useast5&ps=87d6e48a&refresh_token=4d5aa6cc&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=ki4IpREjW%2FDTxJ2yCziPO7Gj0Vk%3D"
                            ],
                            "url_prefix": null,
                            "width": 720
                        },
                        "binded_challenge_id": 0,
                        "can_be_stitched": true,
                        "can_not_reuse": false,
                        "collect_stat": 0,
                        "commercial_right_type": 2,
                        "cover_large": {
                            "data_size": 0,
                            "height": 720,
                            "uri": "tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540",
                            "url_list": [
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=d753c8fc&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=qWhO4OAdg%2BqCjThRWIr7Znaqle8%3D",
                                "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=8837&idc=useast5&ps=87d6e48a&refresh_token=f4f7f54c&s=SEARCH&sc=avatar&shcp=0e6dc556&shp=d05b14bd&t=223449c4&x-expires=1783674000&x-signature=snvOP81gOwyaXUPjvRKJE20bVT0%3D",
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/cbdf077753e240cba3798cda4d508540~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&idc=useast5&ps=87d6e48a&refresh_

Top Search - Real-time interface

Request

Responses