Contract
input_schema.json
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"cursor": {
"type": "integer",
"default": 0,
"description": "偏移游标，用于翻页，从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response"
},
"keyword": {
"type": "string",
"description": "关键词 / Keyword -- the search term to look up. The upstream provider itself falls back to a demo value (its own docs example is \"cat\") when this is omitted, but this tool requires it explicitly so a call always reflects a real search intent rather than silently billing for the provider's own placeholder."
},
"backtrace": {
"type": "string",
"default": "",
"description": "翻页回溯标识，用于翻页，从上一次请求返回的响应中获取 / Backtrace for pagination, obtained from the last response"
},
"search_id": {
"type": "string",
"default": "",
"description": "搜索ID，用于翻页，从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response"
},
"sort_type": {
"type": "string",
"default": "0",
"description": "排序方式：0=综合排序 1=最多点赞 2=最新发布 / Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest"
},
"content_type": {
"type": "string",
"default": "0",
"description": "内容类型：0=不限 1=视频 2=图片 3=文章 / Content type: 0=All, 1=Video, 2=Picture, 3=Article"
},
"publish_time": {
"type": "string",
"default": "0",
"description": "发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年 / Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year"
},
"filter_duration": {
"type": "string",
"default": "0",
"description": "视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上 / Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"business_data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"aweme_info": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "The post's own caption text."
},
"music": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"author": {
"type": "string",
"description": "The sound's own credited artist/composer name (public music metadata)."
},
"id_str": {
"type": "string"
},
"duration": {
"type": "number",
"description": "Seconds."
},
"is_original_sound": {
"type": "boolean"
},
"music_collect_count": {
"type": "number"
}
},
"description": "The sound/music track attached to the post, when one is set.",
"additionalProperties": true
},
"video": {
"type": "object",
"properties": {
"cover": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Cover thumbnail URLs. Values withheld (stripped to `null`)."
}
},
"additionalProperties": true
},
"ratio": {
"type": "string",
"description": "e.g. \"480p\"."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"duration": {
"type": "number",
"description": "Milliseconds."
},
"play_addr": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Playable video stream URLs. Values withheld (stripped to `null`) in this tool's output -- only whether the field is populated is observable, not the video itself."
}
},
"additionalProperties": true
},
"origin_cover": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Original-resolution cover URLs. Values withheld (stripped to `null`)."
}
},
"additionalProperties": true
}
},
"description": "Playable-video fields, present on video posts.",
"additionalProperties": true
},
"author": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The author's numeric Douyin user id."
},
"gender": {
"type": "number",
"description": "0/1/2, platform-defined."
},
"region": {
"type": "string"
},
"sec_uid": {
"type": "string",
"description": "The author's opaque platform-internal id."
},
"nickname": {
"type": "string",
"description": "The author's public display name."
},
"short_id": {
"type": "string"
},
"signature": {
"type": "string",
"description": "The author's public bio text. Often empty."
},
"unique_id": {
"type": "string",
"description": "The author's public Douyin handle (@id). Empty string when unset."
},
"aweme_count": {
"type": "number",
"description": "The author's total post count."
},
"is_verified": {
"type": "boolean"
},
"avatar_larger": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "The author's avatar image URLs. Values withheld (stripped to `null`) in this tool's output -- only whether the field is populated is observable, not the image itself."
}
},
"additionalProperties": true
},
"custom_verify": {
"type": "string",
"description": "Verification badge text, when set."
},
"follower_count": {
"type": "number"
},
"following_count": {
"type": "number"
},
"total_favorited": {
"type": "number",
"description": "Total likes received across all posts."
},
"favoriting_count": {
"type": "number",
"description": "Number of posts the author has liked."
},
"verification_type": {
"type": "number"
},
"enterprise_verify_reason": {
"type": "string"
}
},
"description": "The post's own author (or, inside `aweme_list[]`, the matched creator).",
"additionalProperties": true
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Image URLs. Values withheld (stripped to `null`)."
}
},
"additionalProperties": true
},
"description": "Present on image posts instead of `video`."
},
"aweme_id": {
"type": "string"
},
"cha_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cid": {
"type": "string"
},
"desc": {
"type": "string"
},
"cha_name": {
"type": "string",
"description": "The hashtag's display text (without the # sign)."
},
"user_count": {
"type": "number",
"description": "Total posts tagged with this hashtag."
},
"view_count": {
"type": "number",
"description": "Total views across posts with this hashtag."
}
},
"additionalProperties": true
},
"description": "Hashtags/challenges attached to the post."
},
"share_url": {
"type": [
"string",
"null"
],
"description": "The post's public share link. Value withheld (stripped to `null`)."
},
"aweme_type": {
"type": "number"
},
"media_type": {
"type": "number"
},
"share_info": {
"type": "object",
"properties": {
"share_url": {
"type": [
"string",
"null"
],
"description": "Same share link, under a second key. Withheld to `null`."
}
},
"additionalProperties": true
},
"statistics": {
"type": "object",
"properties": {
"digest": {
"type": "string"
},
"aweme_id": {
"type": "string"
},
"digg_count": {
"type": "number",
"description": "Like count."
},
"lose_count": {
"type": "number"
},
"play_count": {
"type": "number",
"description": "Observed as 0 on every result calibrated."
},
"share_count": {
"type": "number"
},
"collect_count": {
"type": "number"
},
"comment_count": {
"type": "number"
},
"forward_count": {
"type": "number"
},
"download_count": {
"type": "number"
},
"exposure_count": {
"type": "number"
},
"recommend_count": {
"type": "number"
},
"live_watch_count": {
"type": "number"
},
"lose_comment_count": {
"type": "number"
},
"whatsapp_share_count": {
"type": "number"
}
},
"additionalProperties": true
},
"create_time": {
"type": "number",
"description": "Unix seconds."
}
},
"additionalProperties": true
},
"aweme_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"desc": {
"type": "string"
},
"music": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"author": {
"type": "string",
"description": "The sound's own credited artist/composer name (public music metadata)."
},
"id_str": {
"type": "string"
},
"duration": {
"type": "number",
"description": "Seconds."
},
"is_original_sound": {
"type": "boolean"
},
"music_collect_count": {
"type": "number"
}
},
"description": "The sound/music track attached to the post, when one is set.",
"additionalProperties": true
},
"video": {
"type": "object",
"properties": {
"cover": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Cover thumbnail URLs. Values withheld (stripped to `null`)."
}
},
"additionalProperties": true
},
"ratio": {
"type": "string",
"description": "e.g. \"480p\"."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"duration": {
"type": "number",
"description": "Milliseconds."
},
"play_addr": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Playable video stream URLs. Values withheld (stripped to `null`) in this tool's output -- only whether the field is populated is observable, not the video itself."
}
},
"additionalProperties": true
},
"origin_cover": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Original-resolution cover URLs. Values withheld (stripped to `null`)."
}
},
"additionalProperties": true
}
},
"description": "Playable-video fields, present on video posts.",
"additionalProperties": true
},
"author": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The author's numeric Douyin user id."
},
"gender": {
"type": "number",
"description": "0/1/2, platform-defined."
},
"region": {
"type": "string"
},
"sec_uid": {
"type": "string",
"description": "The author's opaque platform-internal id."
},
"nickname": {
"type": "string",
"description": "The author's public display name."
},
"short_id": {
"type": "string"
},
"signature": {
"type": "string",
"description": "The author's public bio text. Often empty."
},
"unique_id": {
"type": "string",
"description": "The author's public Douyin handle (@id). Empty string when unset."
},
"aweme_count": {
"type": "number",
"description": "The author's total post count."
},
"is_verified": {
"type": "boolean"
},
"avatar_larger": {
"type": "object",
"properties": {
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "The author's avatar image URLs. Values withheld (stripped to `null`) in this tool's output -- only whether the field is populated is observable, not the image itself."
}
},
"additionalProperties": true
},
"custom_verify": {
"type": "string",
"description": "Verification badge text, when set."
},
"follower_count": {
"type": "number"
},
"following_count": {
"type": "number"
},
"total_favorited": {
"type": "number",
"description": "Total likes received across all posts."
},
"favoriting_count": {
"type": "number",
"description": "Number of posts the author has liked."
},
"verification_type": {
"type": "number"
},
"enterprise_verify_reason": {
"type": "string"
}
},
"description": "The post's own author (or, inside `aweme_list[]`, the matched creator).",
"additionalProperties": true
},
"aweme_id": {
"type": "string"
},
"cha_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cid": {
"type": "string"
},
"desc": {
"type": "string"
},
"cha_name": {
"type": "string",
"description": "The hashtag's display text (without the # sign)."
},
"user_count": {
"type": "number",
"description": "Total posts tagged with this hashtag."
},
"view_count": {
"type": "number",
"description": "Total views across posts with this hashtag."
}
},
"additionalProperties": true
},
"description": "Hashtags/challenges attached to the post."
},
"share_url": {
"type": [
"string",
"null"
]
},
"aweme_type": {
"type": "number"
},
"media_type": {
"type": "number"
},
"share_info": {
"type": "object",
"properties": {
"share_url": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
},
"statistics": {
"type": "object",
"properties": {
"digest": {
"type": "string"
},
"aweme_id": {
"type": "string"
},
"digg_count": {
"type": "number",
"description": "Like count."
},
"lose_count": {
"type": "number"
},
"play_count": {
"type": "number",
"description": "Observed as 0 on every result calibrated."
},
"share_count": {
"type": "number"
},
"admire_count": {
"type": "number"
},
"collect_count": {
"type": "number"
},
"comment_count": {
"type": "number"
},
"forward_count": {
"type": "number"
},
"download_count": {
"type": "number"
},
"exposure_count": {
"type": "number"
},
"recommend_count": {
"type": "number"
},
"live_watch_count": {
"type": "number"
},
"lose_comment_count": {
"type": "number"
},
"whatsapp_share_count": {
"type": "number"
}
},
"additionalProperties": true
},
"create_time": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Matched creator profiles, only observed on a keyword that matches a known public figure (e.g. a celebrity search)."
}
},
"description": "Either `aweme_info` (one video/image post) or `aweme_list` (matched creator profiles) is populated, depending on `card_id`/`type` above.",
"additionalProperties": true
},
"type": {
"type": "number",
"description": "Numeric card-type code."
},
"card_id": {
"type": "string",
"description": "The card's content-type id, e.g. \"douyin.doctype_aweme_image\"."
},
"data_id": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "One entry per result card on this page."
},
"business_config": {
"type": "object",
"properties": {
"has_more": {
"type": "number",
"description": "1 when more results remain, else 0."
},
"backtrace": {
"type": "string"
},
"next_page": {
"type": "object",
"properties": {
"cursor": {
"type": "number"
},
"search_id": {
"type": "string"
}
},
"additionalProperties": true
}
},
"description": "This page's pagination state, for the next call's `cursor`/`search_id`/`backtrace`.",
"additionalProperties": true
}
},
"additionalProperties": true
}
}
},
"description": "Search result cards, narrowed from the provider's top-level array and wrapped as `{results: [...]}`. Each card carries a `business_data[]` array (each entry either a video/image post under `data.aweme_info`, or a matched-creator list under `data.aweme_list[]` -- the latter only observed when the keyword matches a known public figure) and a `business_config` object with this page's pagination state.",
"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.020475 |
- 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