Recommended Video Stream - Real-time Interface

API Overview
This realtime endpoint samples videos from the recommendation surface rather than from search. It is useful for observing what TikTok appears to be pushing in-feed right now, making it better for recommendation-surface monitoring than for precise intent-based discovery.

Recommended Use Cases

Monitor recommendation-feed patterns

Collect breakout content samples from the feed

Study what kinds of videos TikTok is distributing right now

Support creative benchmarking against current recommendation behavior

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": {
        "status_code": 0,
        "min_cursor": 0,
        "max_cursor": 5,
        "has_more": 1,
        "aweme_list": [
            {
                "aweme_id": "7639902004717931789",
                "desc": "hehe i love it! edit: tutorial is posted on my page!! #fyp #hatsunemiku #ipad ",
                "create_time": 1778803331,
                "author": {
                    "uid": "7069164460333990958",
                    "short_id": "0",
                    "nickname": "reese (meiko’s version)",
                    "signature": "⊹ ﹏𓊝﹏𓂁﹏⊹ ˖",
                    "avatar_thumb": {
                        "uri": "tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689",
                        "url_list": [
                            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=07f23cdb&x-expires=1783674000&x-signature=568JN%2F8nBO%2BAv2eSwrcbUNPVres%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                            "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=bc40a6fb&x-expires=1783674000&x-signature=NDh5wVdhgm%2FdDIoKYeeQDFTgK7c%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=7ce5f94e&x-expires=1783674000&x-signature=PdUZy9nTUomEJV8w1QHhp8TN%2B%2FU%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"
                        ],
                        "width": 720,
                        "height": 720,
                        "url_prefix": null
                    },
                    "avatar_medium": {
                        "uri": "tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689",
                        "url_list": [
                            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=fb75b481&x-expires=1783674000&x-signature=88DIxJep%2BQ110BBxAYCzacRRD18%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                            "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=720c5e62&x-expires=1783674000&x-signature=Ew0ARjGEacDRBb2kWk7Nnz1Na80%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8",
                            "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ebe0af8aaa3ef98ef59582fa7a7c3689~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=378b8433&x-expires=1783674000&x-signature=jV6fM4D6RtqvVHfPD6XFTPnO0Jg%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=useast8"
                        ],
                        "width": 720,
                        "height": 720,
                        "url_prefix": null
                    },
                    "follow_status": 0,
                    "is_block": false,
                    "custom_verify": "",
                    "unique_id": "myilomiloo",
                    "room_id": 0,
                    "authority_status": 0,
                    "verify_info": "",
                    "share_info": {
                        "share_url": "",
                        "share_desc": "",
                        "share_title": "",
                        "share_qrcode_url": {
                            "uri": "",
                            "url_list": [],
                            "width": 720,
                            "height": 720,
                            "url_prefix": null
                        },
                        "share_title_myself": "",
                        "share_title_other": "",
                        "share_desc_info": "",
                        "now_invitation_card_image_urls": null
                    },
                    "with_commerce_entry": false,
                    "verification_type": 0,
                    "enterprise_verify_reason": "",
                    "is_ad_fake": false,
                    "followers_detail": null,
                    "region": "US",
                    "commerce_user_level": 0,
                    "platform_sync_info": null,
                    "is_discipline_member": false,
                    "secret": 0,
                    "prevent_download": false,
                    "geofencing": null,
                    "video_icon": {
                        "uri": "",
                        "url_list": [],
                        "width": 720,
                        "height": 720,
                        "url_prefix": null
                    },

Recommended Video Stream - Real-time Interface

Request

Responses