Contract
input_schema.json
{
"type": "object",
"required": [
"room_id",
"anchor_id"
],
"properties": {
"cookie": {
"type": "string",
"description": "User's own cookie"
},
"room_id": {
"type": "string",
"description": "Live room id"
},
"anchor_id": {
"type": "string",
"description": "Anchor id"
},
"rank_type": {
"type": "integer",
"default": 8,
"description": "Rank type"
},
"region_type": {
"type": "integer",
"default": 1,
"description": "Region type"
},
"gap_interval": {
"type": "integer",
"default": 0,
"description": "Time interval"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"rank_view": {
"type": "object",
"properties": {
"ranks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "number"
},
"score": {
"type": "number"
},
"rank_str": {
"type": "string"
},
"rank_user": {
"type": "object",
"properties": {
"id_str": {
"type": "string",
"description": "This creator's public TikTok user id."
},
"nickname": {
"type": "string",
"description": "This creator's public TikTok display name."
},
"display_id": {
"type": "string",
"description": "This creator's public TikTok handle."
},
"follow_info": {
"type": "object",
"properties": {
"follower_count": {
"type": "number"
},
"following_count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"score_description": {
"type": "string",
"description": "Human-readable score, e.g. '1.2M'."
}
},
"additionalProperties": false
},
"description": "The ranked leaderboard entries, best rank first."
},
"title": {
"type": "string"
},
"countdown": {
"type": "number",
"description": "Seconds remaining until the current ranking period ends."
},
"rank_type": {
"type": "number",
"description": "Echoes the input rank_type."
},
"owner_rank": {
"type": "object",
"properties": {
"rank": {
"type": "number",
"description": "0 observed when outside the ranked top (see rank_str)."
},
"score": {
"type": "number"
},
"rank_str": {
"type": "string",
"description": "Display rank, e.g. '99+' when the anchor is unranked/outside the visible list."
},
"rank_user": {
"type": "object",
"properties": {
"id_str": {
"type": "string",
"description": "The anchor's public TikTok user id."
},
"nickname": {
"type": "string",
"description": "The anchor's public TikTok display name."
},
"display_id": {
"type": "string",
"description": "The anchor's public TikTok handle."
},
"follow_info": {
"type": "object",
"properties": {
"follower_count": {
"type": "number"
},
"following_count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"score_description": {
"type": "string",
"description": "Human-readable score, e.g. '844.5K'."
}
},
"description": "The requested anchor's own placement on this leaderboard.",
"additionalProperties": false
},
"next_period_time_stamp": {
"type": "number",
"description": "Unix timestamp (seconds) for when the next ranking period begins."
}
},
"description": "Absent when the room has no leaderboard for the requested rank/region type.",
"additionalProperties": false
}
},
"description": "Empty object `{}` observed for one real rank_type/region_type combination.",
"additionalProperties": false
},
"extra": {
"type": "object",
"properties": {
"now": {
"type": "number",
"description": "Server timestamp (unix milliseconds) of this response."
}
},
"additionalProperties": false
},
"status_code": {
"type": "number",
"description": "0 observed on every successful call, including the empty-data case."
}
},
"description": "The leaderboard record. `data` and `data.rank_view` are both absent/empty for some rank_type/region_type combinations even on a valid room -- see alt-rank-type fixture.",
"additionalProperties": false
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 23, 2026