API reference · TikTok
tiktok/app-v3/live-daily-rank
Integrate this model through SandBase's unified API, with production-ready schemas and examples.
Production endpoint
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
POST
https://api.sandbase.ai/v1/api/tiktok/app-v3/live-daily-rankModel ID
tiktok/app-v3/live-daily-rank01
Input Schema
5 parameters · 0 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
room_id | string | Optional | Live room id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different room ids of different live rooms. |
anchor_id | string | Optional | Anchor id, which can be obtained from the live room information interface, use the default value, this parameter will affect the returned data, you can try different anchor ids of different live rooms. |
rank_type | integer | Optional | Rank type: 0: hourly_rank (Hourly Rank); 1: weekly_rank (Weekly Rank); 5: rookie_star_rank (Rookie Star Rank); 6: sale_rank (Sale Rank); 8: daily_rank (Daily Rank); 10: weekly_game_rank (Weekly Game Rank); 11: daily_game_rank (Daily Game Rank); 12: hall_of_fame_rank (Hall of Fame Rank); 13: champion_tournament (Champion Tournament (includes phase_one/two/three)); 14: daily_rookie_star_rank (Daily Rookie Star Rank); 15: fans_team_rank (Fans Team Rank); 16: ranking_league (Ranking League (App display: D5 Level Rank)); 20: pubg (PUBG Rank); 21: mlbb (MLBB Rank (Mobile Legends: Bang Bang)); 22: free_fire (Free Fire Rank); 23: sub_weekly_game_rank1 (Sub Weekly Game Rank 1); 24: sub_weekly_game_rank2 (Sub Weekly Game Rank 2); 25: sub_weekly_game_rank3 (Sub Weekly Game Rank 3); 26: collectibles (Collectibles Rank); 27: beauty (Beauty Rank); 28: women_wear (Women Wear Rank); 29: sale_rank_daily (Daily Sale Rank); 1001: league_campaign_rank (League Campaign Rank) |
region_type | integer | Optional | Region type, use the default value, the specific meaning is unknown. |
gap_interval | integer | Optional | Time interval, use the default value to represent the current day, use -1 to represent the ranking record. |
02
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
03
Code Examples
Ready-to-run snippets
const apiKey = process.env.SANDBASE_API_KEY;
const response = await fetch("https://api.sandbase.ai/v1/api/tiktok/app-v3/live-daily-rank", {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());