Gift Info

Get the complete list of gifts available in a live room, including gift names, diamond costs, animated thumbnails, and gift types. Uses the ‘sign-and-return’ pattern.

GET /webcast/gift_info

Get the complete list of gifts available in a live room, including gift names, diamond costs, animated thumbnails, and gift types. Uses the “sign-and-return” pattern.

Response data: Each gift entry includes id, name, diamond_count (cost in diamonds), icon (thumbnail URL), type (1=standard, 2=animated, etc.), and combo/repeat information.

Use cases: Build gift catalogs for your application, calculate the real-money value of gifts (1 diamond ≈ $0.005 USD), display gift icons in chat overlays, or track which gifts are available in different regions.

Note: Gift availability varies by region and room. Some gifts are event-exclusive or require specific room configurations. The response returns all currently available gifts for the specified room.

Parameters

Parameter	Type	Required	Description
room_id	string	No	TikTok room ID
unique_id	string	No	TikTok username

Response

{ "status_code": 0, "data": { "room_id": "...", "gifts": [{ "id": 1, "name": "Rose", "diamond_count": 1 }, ...] } }

Examples

Node.js

const res = await fetch('https://api.tik.tools/webcast/gift_info?unique_id=username&apiKey=YOUR_KEY');
const { data } = await res.json();
data.gifts.forEach(g => console.log(`${g.name}: ${g.diamond_count} diamonds`));