Contract
input_schema.json
{
"type": "object",
"required": [
"kolId"
],
"properties": {
"kolId": {
"type": "string",
"examples": [
"7048929565493690398"
],
"description": "User kolId"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"base_resp": {
"type": "object",
"properties": {
"status_code": {
"type": "number",
"description": "0 observed; nonzero meaning unconfirmed."
},
"status_message": {
"type": "string",
"description": "Empty string observed on success; error text would land here."
}
},
"description": "The call's own response envelope. Observed as `{ status_code: 0, status_message: \"\" }` on the one real non-empty capture.",
"additionalProperties": true
},
"newest_videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Video page URL. Empty string on all six captured rows."
},
"like": {
"type": "number",
"description": "Like count; 0 on all six captured rows."
},
"play": {
"type": "number",
"description": "View/play count. The only non-zero engagement counter on the captured rows (observed 1,459 to 898,536)."
},
"repin": {
"type": "number",
"description": "Repost count; 0 on all six captured rows."
},
"share": {
"type": "number",
"description": "Share count; 0 on all six captured rows."
},
"width": {
"type": "string",
"description": "Video width returned as a numeric string; \"0\" on all captured rows."
},
"height": {
"type": "string",
"description": "Video height returned as a numeric string; \"0\" on all captured rows."
},
"is_hot": {
"type": "boolean",
"description": "Whether the video is flagged hot; false on all six captured rows."
},
"status": {
"type": "number",
"description": "Video status code; 0 on all six captured rows."
},
"barrage": {
"type": "number",
"description": "Danmaku (on-video comment) count; 0 on all six captured rows."
},
"comment": {
"type": "number",
"description": "Comment count; 0 on all six captured rows."
},
"item_id": {
"type": "string",
"description": "The video's canonical Douyin id -- a 19-digit numeric string (a video id, not a phone number despite the digit shape)."
},
"duration": {
"type": "number",
"description": "Video length in seconds; 0 on all six captured rows."
},
"favorite": {
"type": "string",
"description": "Favorite count returned as a numeric string; \"0\" on all captured rows."
},
"read_cnt": {
"type": "string",
"description": "Read count returned as a numeric string; \"0\" on all captured rows."
},
"item_title": {
"type": "string",
"description": "Empty string on all six captured rows."
},
"media_type": {
"type": "string",
"description": "Media type code returned as a numeric string; \"0\" on all captured rows."
},
"create_time": {
"type": "number",
"description": "Publish time in Unix seconds; populated on all six captured rows."
},
"interact_rate": {
"type": "number",
"description": "Engagement rate; 0 on all six captured rows."
},
"play_over_5min": {
"type": "number",
"description": "Plays for videos over five minutes; 0 on all six captured rows."
}
},
"additionalProperties": true
},
"description": "The KOL's newest uploads. Two entries on the one real capture; row count varies by KOL."
},
"order_hot_videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Video page URL. Empty string on all six captured rows."
},
"like": {
"type": "number",
"description": "Like count; 0 on all six captured rows."
},
"play": {
"type": "number",
"description": "View/play count. The only non-zero engagement counter on the captured rows (observed 1,459 to 898,536)."
},
"repin": {
"type": "number",
"description": "Repost count; 0 on all six captured rows."
},
"share": {
"type": "number",
"description": "Share count; 0 on all six captured rows."
},
"width": {
"type": "string",
"description": "Video width returned as a numeric string; \"0\" on all captured rows."
},
"height": {
"type": "string",
"description": "Video height returned as a numeric string; \"0\" on all captured rows."
},
"is_hot": {
"type": "boolean",
"description": "Whether the video is flagged hot; false on all six captured rows."
},
"status": {
"type": "number",
"description": "Video status code; 0 on all six captured rows."
},
"barrage": {
"type": "number",
"description": "Danmaku (on-video comment) count; 0 on all six captured rows."
},
"comment": {
"type": "number",
"description": "Comment count; 0 on all six captured rows."
},
"item_id": {
"type": "string",
"description": "The video's canonical Douyin id -- a 19-digit numeric string (a video id, not a phone number despite the digit shape)."
},
"duration": {
"type": "number",
"description": "Video length in seconds; 0 on all six captured rows."
},
"favorite": {
"type": "string",
"description": "Favorite count returned as a numeric string; \"0\" on all captured rows."
},
"read_cnt": {
"type": "string",
"description": "Read count returned as a numeric string; \"0\" on all captured rows."
},
"item_title": {
"type": "string",
"description": "Empty string on all six captured rows."
},
"media_type": {
"type": "string",
"description": "Media type code returned as a numeric string; \"0\" on all captured rows."
},
"create_time": {
"type": "number",
"description": "Publish time in Unix seconds; populated on all six captured rows."
},
"interact_rate": {
"type": "number",
"description": "Engagement rate; 0 on all six captured rows."
},
"play_over_5min": {
"type": "number",
"description": "Plays for videos over five minutes; 0 on all six captured rows."
}
},
"additionalProperties": true
},
"description": "Ordered hot/trending video picks for the KOL. Two entries on the one real capture; row count varies by KOL."
},
"masterpiece_videos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Video page URL. Empty string on all six captured rows."
},
"like": {
"type": "number",
"description": "Like count; 0 on all six captured rows."
},
"play": {
"type": "number",
"description": "View/play count. The only non-zero engagement counter on the captured rows (observed 1,459 to 898,536)."
},
"repin": {
"type": "number",
"description": "Repost count; 0 on all six captured rows."
},
"share": {
"type": "number",
"description": "Share count; 0 on all six captured rows."
},
"width": {
"type": "string",
"description": "Video width returned as a numeric string; \"0\" on all captured rows."
},
"height": {
"type": "string",
"description": "Video height returned as a numeric string; \"0\" on all captured rows."
},
"is_hot": {
"type": "boolean",
"description": "Whether the video is flagged hot; false on all six captured rows."
},
"status": {
"type": "number",
"description": "Video status code; 0 on all six captured rows."
},
"barrage": {
"type": "number",
"description": "Danmaku (on-video comment) count; 0 on all six captured rows."
},
"comment": {
"type": "number",
"description": "Comment count; 0 on all six captured rows."
},
"item_id": {
"type": "string",
"description": "The video's canonical Douyin id -- a 19-digit numeric string (a video id, not a phone number despite the digit shape)."
},
"duration": {
"type": "number",
"description": "Video length in seconds; 0 on all six captured rows."
},
"favorite": {
"type": "string",
"description": "Favorite count returned as a numeric string; \"0\" on all captured rows."
},
"read_cnt": {
"type": "string",
"description": "Read count returned as a numeric string; \"0\" on all captured rows."
},
"item_title": {
"type": "string",
"description": "Empty string on all six captured rows."
},
"media_type": {
"type": "string",
"description": "Media type code returned as a numeric string; \"0\" on all captured rows."
},
"create_time": {
"type": "number",
"description": "Publish time in Unix seconds; populated on all six captured rows."
},
"interact_rate": {
"type": "number",
"description": "Engagement rate; 0 on all six captured rows."
},
"play_over_5min": {
"type": "number",
"description": "Plays for videos over five minutes; 0 on all six captured rows."
}
},
"additionalProperties": true
},
"description": "Signature/masterpiece video picks for the KOL. Two entries on the one real capture; row count varies by KOL."
},
"personal_hot_videos": {
"type": "array",
"items": {},
"description": "Personal hot videos. Empty array on the one real capture; a populated item shape was never observed and is unconfirmed (each item would likely mirror the other three lists' per-video shape)."
}
},
"description": "The recommended-video lists, as returned at routing.responseResultPath ($.output). Observed as `{}` (completely empty) when the given account ID has no videos on record -- confirmed against the `kol-empty-no-videos` fixture, which still billed the normal per-call price. No top-level `required` fields on purpose, so that empty shape validates.",
"additionalProperties": true
}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.04095 |
- 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 30, 2026