Identify the number you were given

If a colleague provides a live-entry identifier, confirm that it is a webcast_id before using this operation. A user identifier, room_id, and webcast_id are not interchangeable merely because they resemble strings. Keep the task concrete: check the intended room before an event rather than inferring the broadcaster’s entire history from one identifier.

Interpret the result at the time of observation

The operation returns live-stream data, with usable details determined by the actual response. A session may not have begun, may have ended, or may change state after retrieval. One observation cannot guarantee availability a few minutes later. If expected material is absent, verify the target and schedule against the confirmed event source before declaring cancellation or concluding that the account does not exist.

Leave a clear operational note

For a hypothetical event handoff, record the target webcast_id, check time, observed condition, and questions requiring follow-up. That worksheet is your operational record, not an event schedule returned by the lookup. Media information does not grant permission to record or redistribute a broadcast, and temporary information should not become a permanent player configuration without checking. The handoff should identify what was checked, when, and what remains uncertain rather than promising uninterrupted availability.

Request URL and parameters

GET https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_user_live_videos

Parameter Type Required Meaning
webcast_id string Yes Room webcast_id

Run the Python example

Install requests and set TRMESH_API_TOKEN in your environment. Replace the sample identifiers with the public object you intend to inspect. Example IDs may no longer be available.

import os
import requests

# Read your own developer key from the server environment.
url = "https://api.trmesh.com/openapi/api/v1/douyin/web/fetch_user_live_videos"
params = {
    "webcast_id": "376034101029"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # Inspect the actual response before mapping fields

Endpoint documentation · Free profile tool

API calls use your TRMesh account allowance. Check the endpoint price before running a script.