Skip to main content

​
GET /webcast/user_earnings

Retrieve TikTok LIVE earnings data for a creator including diamonds received, coin equivalent, and period breakdowns. This is an authenticated endpoint that proxies TikTok’s creator earnings API. Authentication required: You must include TikTok session cookies via x-cookie-header. Only works when the session belongs to the creator whose earnings are being requested (you can’t view other people’s earnings). Response data: Returns diamonds (total received), coins (equivalent coin value), and period breakdown. Diamond-to-USD conversion: 1 diamond ≈ $0.005 USD. Use cases: Creator dashboards showing real-time earnings, financial analytics for agency talent management, or automated earnings reports for multi-stream operations.

​
Parameters

ParameterTypeRequiredDescription
unique_idstringYesTikTok username
periodstringNoPeriod filter: “daily” (default)

​
Response

{ "status_code": 0, "data": { "diamonds": 1500, "coins": 75000, "period": "daily" } }

​
Examples

const res = await fetch('https://api.tik.tools/webcast/user_earnings?unique_id=creator&apiKey=YOUR_KEY', {
  headers: { 'x-cookie-header': 'sessionid=YOUR_TIKTOK_COOKIES' }
});
const { data } = await res.json();
console.log(`Diamonds: ${data.diamonds}`);