Video Search - Real-time Interface

GET

https://open.echotik.live/api/v3/realtime/video/search

API Overview
This realtime video search endpoint returns videos matched to a keyword under a chosen sort and publish-time filter. It is designed for intent-based content retrieval rather than feed-based sampling, so it is ideal when you want examples tied to a topic rather than to recommendation logic.

Recommended Use Cases

Search for videos tied to a keyword

Collect topical content samples

Review keyword competition in video content

Support niche and competitor content research

Notes

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

Request

Authorization

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 *****************

Query Params

Responses

🟢200成功

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://open.echotik.live/api/v3/realtime/video/search?keyword=baby&region=US&publish_time=0&sort_type=1&offset=0' \
--header 'Authorization: Basic <encoded-value>'

Response Example

{
    "msg": "success",
    "code": 0,
    "data": {
        "aweme_list": [],
        "backtrace": "",
        "components": null,
        "cursor": 10,
        "extra": {
            "api_debug_info": null,
            "fatal_item_ids": [],
            "logid": "202511120320525BFEE892C7343F0026C7",
            "now": 1762917653000,
            "search_request_id": "",
            "server_stream_time": 936
        },
        "feedback_type": "video",
        "global_doodle_config": {
            "display_filter_bar": 1,
            "feedback_survey": [
                {
                    "feedback_type": "video",
                    "long_stress_info": null,
                    "multiple_choices": [
                        {
                            "key": "Dislike",
                            "value": "Dislike"
                        },
                        {
                            "key": "Unrelated content",
                            "value": "Unrelated content"
                        },
                        {
                            "key": "Not my language",
                            "value": "Not my language"
                        },
                        {
                            "key": "Outdated content",
                            "value": "Outdated content"
                        },
                        {
                            "key": "Culturally insensitive",
                            "value": "Culturally insensitive"
                        },
                        {
                            "key": "Inappropriate content",
                            "value": "Inappropriate content"
                        },
                        {
                            "key": "Misinformation",
                            "value": "Misinformation"
                        },
                        {
                            "key": "Others",
                            "value": "Others"
                        }
                    ],
                    "send_us_multiple_choices": null
                }
            ],
            "hide_results": false,
            "hit_dolphin": false,
            "hit_shark": false,
            "keyword": "baby",
            "new_source": "switch_tab",
            "search_channel": "musically_video",
            "search_intent": {},
            "tns_search_result": "Pass"
        },
        "has_more": 1,
        "log_pb": {
            "impr_id": "202511120320525BFEE892C7343F0026C7"
        },
        "search_item_list": [
            {
                "aweme_info": {
                    "added_sound_music_info": {
                        "album": "",
                        "allow_offline_music_to_detail_page": false,
                        "artists": [],
                        "audition_duration": 10,
                        "author": "Neep Fam",
                        "author_deleted": false,
                        "author_position": null,
                        "avatar_medium": {
                            "height": 720,
                            "uri": "tos-useast5-avt-0068-tx/04245319054c9bfa2fa8703f0dab0132",
                            "url_list": [
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/04245319054c9bfa2fa8703f0dab0132~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=b0560b16&x-expires=1763002800&x-signature=whvWoprnyS3oYAKoR7H91efrt9k%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                                "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/04245319054c9bfa2fa8703f0dab0132~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=ffa9e80b&x-expires=1763002800&x-signature=Zx3lfkPb1GH13MMjYhSLOHTgdwQ%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/04245319054c9bfa2fa8703f0dab0132~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=41b0d6b6&x-expires=1763002800&x-signature=O%2BdDR7fQQWgOi2lelfoNx%2B4GSZw%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"
                            ],
                            "url_prefix": null,
                            "width": 720
                        },
                        "avatar_thumb": {
                            "height": 720,
                            "uri": "tos-useast5-avt-0068-tx/04245319054c9bfa2fa8703f0dab0132",
                            "url_list": [
                                "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/04245319054c9bfa2fa8703f0dab0132~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=9c79cdd6&x-expires=1763002800&x-signature=0Jo9J%2BwZ%2B4kCMDv%2B08Ztl%2BzR77I%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                                "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-t

Music Search - Real-time Interface

Live Stream Search - Real-time Interface