WellbyteWellbyte

GET /v1/tiktok/web/fetch_live_gift_list

Get live room gift list

stable · 33 credits per success

Get live room gift list;room_id is optional parameter, if not provided, will get general gift list (as of August 15, 2025, there are 256 types of gifts);room_id: Live room ID (optional);Live room gift list data;Note;The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned.;When accessing a direct video CDN link…

Sign up for 500 credits and run with your own API key. Sign up free

Request

curl -s 'https://api.wellbyte.net/v1/tiktok/web/fetch_live_gift_list?room_id=7381444193462078214' \
  -H "Authorization: Bearer dg_live_…"

Response

Sample captured 2026-08-27

data{
code:0
data{
hash:""
tags[ 0 items ]
gifts[ 2 items ]
pages[ 2 items ]
gifts_info{ 39 items }
hot_fields[ 0 items ]
gift_configs{ 1 item }
strategy_data{ 2 items }
cold_gift_hash:""
pannel_refresh:0
strategy_token:""
doodle_templates[ 0 items ]
is_full_gift_data:false
panel_refresh_data{ 5 items }
dynamic_restriction{ 1 item }
gift_name_group_map{ 0 items }
gift_label_priorities{ 18 items }
gift_resource_group_map{ 0 items }
beacon_bubble_priorities{ 8 items }
exclusive_recommend_infos{ 0 items }
realtime_server_passthrough:
"{"vault_gifts":null,"recent_gift_id_filter_list":[6834,6835,7934],"gift_force_da..."
}
meta{
endpoint:"tiktok.web.fetch_live_gift_list"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

No calls yet. Get one green run first, then switch to your own data.

    Request parameters

    NameTypeInRequiredDescriptionExample
    room_idstringqueryno直播间ID,可选参数7381444193462078214

    Response fields

    Field dictionary coming soon — the executable panel shows the live shape.

    Errors

    codeHTTPMeaningBilled
    40001400Invalid parametersno
    40102401Invalid or revoked API Keyno
    40201402Insufficient creditsno
    40402404Resource not foundno
    42201422Quality gate failedno
    42901429Rate limit exceededno
    50401504Upstream timeoutno
    50201502Upstream errorno

    Billing

    Success costs 33 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.

    Search

    Search endpoints and docs