Contract
input_schema.json
{
"type": "object",
"required": [
"share_url"
],
"properties": {
"share_url": {
"type": "string",
"examples": [
"https://v.douyin.com/e3x2fjE/"
],
"description": "Share link"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"aweme_detail": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "The video's caption text, hashtags inline."
},
"rate": {
"type": "number",
"description": "Playback quality/rate code."
},
"music": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "The soundtrack's public title."
},
"duration": {
"type": "number",
"description": "Soundtrack length in seconds (16 in testing)."
},
"is_original": {
"type": "boolean"
},
"is_original_sound": {
"type": "boolean"
}
},
"description": "The soundtrack this video uses. Its creator's handle is not included.",
"additionalProperties": true
},
"video": {
"type": "object",
"properties": {
"cover": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Cover image URLs. Value withheld (stripped to `null`) -- only that a cover exists is observable."
}
},
"additionalProperties": true
},
"ratio": {
"type": "string",
"description": "Aspect label, e.g. '720p' in testing."
},
"width": {
"type": "number"
},
"format": {
"type": "string",
"description": "Container, e.g. 'mp4' in testing."
},
"height": {
"type": "number"
},
"bit_rate": {
"type": "array",
"items": {
"type": "object",
"properties": {
"FPS": {
"type": "number"
},
"format": {
"type": "string"
},
"bit_rate": {
"type": "number"
},
"gear_name": {
"type": "string",
"description": "The encoding tier's label (e.g. 'normal_720_0') -- a quality tag, not a person."
},
"play_addr": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Playback URLs for this tier. Always null (URLs not returned)."
}
},
"additionalProperties": true
},
"quality_type": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "One entry per encoding quality tier; a single 720p tier in testing."
},
"duration": {
"type": "number",
"description": "Milliseconds, mirrors aweme_detail.duration."
},
"play_addr": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Direct playback URLs. Value withheld (stripped to `null`) -- only that a playable address exists is observable."
}
},
"additionalProperties": true
},
"download_addr": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Direct download URLs (watermarked in testing). Always null (URLs not returned)."
}
},
"additionalProperties": true
},
"has_watermark": {
"type": "boolean"
}
},
"description": "Encoding details for the playable video file.",
"additionalProperties": true
},
"author": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The author's numeric Douyin id."
},
"sec_uid": {
"type": "string",
"description": "The author's secure account id."
},
"nickname": {
"type": "string",
"description": "The author's public display name -- the subject of this lookup."
},
"unique_id": {
"type": "string",
"description": "The author's public handle."
},
"follower_count": {
"type": "number"
}
},
"description": "The queried video's own author (the creator who published this exact video).",
"additionalProperties": true
},
"region": {
"type": "string",
"description": "Region code, e.g. 'CN' in testing."
},
"aweme_id": {
"type": "string",
"description": "The video's public Douyin id."
},
"duration": {
"type": "number",
"description": "Video length in milliseconds (18134 in testing)."
},
"share_url": {
"type": [
"string",
"null"
],
"description": "The video's canonical share URL. Value withheld (stripped to `null`) in this tool's output -- only that a share destination exists is observable, not the URL."
},
"statistics": {
"type": "object",
"properties": {
"digg_count": {
"type": "number",
"description": "Likes."
},
"play_count": {
"type": "number",
"description": "Plays."
},
"share_count": {
"type": "number",
"description": "Shares."
},
"admire_count": {
"type": "number"
},
"collect_count": {
"type": "number",
"description": "Favorites/saves."
},
"comment_count": {
"type": "number",
"description": "Comments."
},
"recommend_count": {
"type": "number"
}
},
"description": "Engagement counters for this video.",
"additionalProperties": true
},
"text_extra": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hashtag_id": {
"type": "string"
},
"hashtag_name": {
"type": "string",
"description": "The hashtag topic (e.g. a game/theme tag) -- public topic, not a person's name."
}
},
"additionalProperties": true
},
"description": "Hashtag mentions parsed out of the caption."
},
"create_time": {
"type": "number",
"description": "Publish time, Unix seconds."
}
},
"description": "The queried video's own public metadata. Absent entirely on the not-found case (`{}`).",
"additionalProperties": true
}
},
"description": "The video record, limited to the fields below. Built as `{ aweme_detail: { ... } }` for a video that resolves; an invalid or unknown `share_url` returns `{}` instead (the call still completes successfully).",
"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.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
- Oct 12, 2026