Contract
input_schema.json
{
"type": "object",
"required": [
"keyword"
],
"properties": {
"count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 12,
"example": 12,
"description": "每页数量/Page size"
},
"cursor": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 0,
"example": 0,
"description": "翻页游标,首页传 0,后续传上一页响应里的 cursor/Pagination cursor, 0 for first page"
},
"keyword": {
"type": "string",
"example": "major",
"description": "视频标题/关键词/Video title or keyword"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"msg": {
"type": "string",
"description": "Vendor status message, observed as the literal string 'success' on all three real captures."
},
"code": {
"type": "integer",
"description": "Vendor status code, observed as 0 on all three real captures."
},
"data": {
"type": "object",
"properties": {
"cursor": {
"type": "integer",
"description": "Pass this value back as the next call's `cursor` input to fetch the following page."
},
"hasMore": {
"type": "boolean",
"description": "Whether a further page is available."
},
"itemList": {
"type": "array",
"items": {
"type": "object",
"properties": {
"IsAd": {
"type": "boolean",
"description": "Whether the video is a paid/boosted placement. Observed false on every item across all three real captures; a true value was never observed."
},
"AwemeInfo": {
"type": "object",
"properties": {
"Desc": {
"type": "string",
"description": "The video's caption text, as posted (often includes hashtags)."
},
"Video": {
"type": "object",
"properties": {
"Title": {
"type": "string",
"description": "Observed identical to Desc on every real item captured."
},
"PlayAddr": {
"type": "object",
"properties": {
"Width": {
"type": "integer",
"description": "Source video pixel width."
},
"Height": {
"type": "integer",
"description": "Source video pixel height."
}
},
"additionalProperties": true
},
"CreateTime": {
"type": "string",
"description": "Post time, epoch SECONDS as a string -- a different precision than AwemeInfo.CreateTime's milliseconds, both observed on every item."
}
},
"additionalProperties": true
},
"Author": {
"type": "object",
"properties": {
"SecUid": {
"type": "string",
"description": "The creator's public account identifier."
},
"Nickname": {
"type": "string",
"description": "The creator's public display name."
},
"UniqueId": {
"type": "string",
"description": "The creator's public @handle. Observed empty on at least one real item -- not every account has one set."
},
"Signature": {
"type": "string",
"description": "The creator's own public profile bio text. Observed empty on most real items."
},
"FollowerCount": {
"type": "integer"
}
},
"additionalProperties": true
},
"AwemeId": {
"type": "string",
"description": "The video's unique id."
},
"IsPhoto": {
"type": "boolean",
"description": "True for a photo-mode post rather than a video."
},
"CreateTime": {
"type": "string",
"description": "Post time, epoch MILLISECONDS as a string."
},
"Statistics": {
"type": "object",
"properties": {
"DiggCount": {
"type": "integer",
"description": "Like count."
},
"ShareCount": {
"type": "integer"
},
"CommentCount": {
"type": "integer"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"ItemSource": {
"type": "object",
"properties": {
"SourceType": {
"type": "integer"
},
"ItemGeneraion": {
"type": "integer",
"description": "The vendor's own field name (their spelling, kept as observed)."
}
},
"additionalProperties": true
},
"PlayletType": {
"type": "integer"
},
"HasLocalAnchor": {
"type": "boolean"
}
},
"additionalProperties": true
},
"description": "Matching videos, up to `count` per page. Observed as 11 items on every one of the three real captures, including a nonsense keyword expected to return zero results -- a genuinely empty result set was never observed; its shape is unconfirmed."
}
},
"additionalProperties": true
}
},
"description": "The search response, at routing.responseResultPath ($.output).",
"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
- Sep 15, 2026