Contract
input_schema.json
{
"type": "object",
"required": [
"count"
],
"properties": {
"count": {
"type": "integer",
"examples": [
16
],
"description": "Number of videos to return per page. Required -- the endpoint returns this many feed entries for each call."
},
"cookie": {
"type": "string",
"description": "Optional Douyin login cookie, used by the endpoint for personalized feed results. Leave unset to get the public feed."
},
"refresh_index": {
"type": "integer",
"default": 1,
"description": "Paging index: which page of the feed to return, starting at 1. Page 2 returns the next page after page 1."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"aweme_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "The video's caption text, including any hashtags."
},
"music": {
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "Soundtrack title -- original-sound names observed on the calibrated fixtures (e.g. a creator-name original sound)."
},
"author": {
"type": "string",
"description": "The soundtrack creator's display name (same as the record author on the original-sound fixtures)."
},
"id_str": {
"type": "string",
"description": "The sound's public id in string form."
},
"duration": {
"type": "number",
"description": "Sound duration in seconds."
},
"is_original": {
"type": "boolean"
},
"owner_nickname": {
"type": "string",
"description": "The sound owner's public display name."
}
},
"description": "The soundtrack attached to the video.",
"additionalProperties": true
},
"video": {
"type": "object",
"properties": {
"cover": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Cover image URLs, always withheld (stripped to `null`) in this tool's output -- only whether a cover is set is observable, not the image itself."
}
},
"additionalProperties": true
},
"ratio": {
"type": "string",
"description": "Aspect-ratio label; 'default' on both fixtures."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"duration": {
"type": "number",
"description": "Video duration in milliseconds (matches the aweme duration)."
}
},
"description": "Video playback metadata (stream URLs are withheld).",
"additionalProperties": true
},
"author": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The creator's numeric account id."
},
"region": {
"type": "string",
"description": "Creator account region code, e.g. 'CN'."
},
"nickname": {
"type": "string",
"description": "The creator's public display name."
},
"signature": {
"type": "string",
"description": "The creator's public profile bio. May be empty on some creators."
},
"unique_id": {
"type": "string",
"description": "The creator's public handle (short user id)."
},
"avatar_thumb": {
"type": "object",
"properties": {
"url_list": {
"type": [
"array",
"null"
],
"description": "Avatar image URLs, always withheld (stripped to `null`) in this tool's output -- only whether an avatar is set is observable, not the image itself."
}
},
"additionalProperties": true
},
"custom_verify": {
"type": "string",
"description": "Verification label text; empty when the creator is unverified."
}
},
"description": "The video's creator.",
"additionalProperties": true
},
"status": {
"type": "object",
"properties": {
"part_see": {
"type": "number",
"description": "0 on both fixtures (not partially visible)."
},
"is_delete": {
"type": "boolean",
"description": "True if the video was deleted."
},
"allow_share": {
"type": "boolean"
},
"allow_comment": {
"type": "boolean"
},
"is_prohibited": {
"type": "boolean"
},
"private_status": {
"type": "number",
"description": "0 on both fixtures (public)."
}
},
"description": "Availability/permission flags for the video.",
"additionalProperties": true
},
"aweme_id": {
"type": "string",
"description": "The video's public Douyin id (string form of a large integer)."
},
"duration": {
"type": "number",
"description": "Video duration in milliseconds (198136 observed on the first entry -- about 3m18s)."
},
"mix_info": {
"type": "object",
"properties": {
"mix_id": {
"type": "string",
"description": "The collection's public id."
},
"statis": {
"type": "object",
"properties": {
"play_vv": {
"type": "number"
},
"collect_vv": {
"type": "number"
},
"current_episode": {
"type": "number",
"description": "Episode index the collection is on."
},
"updated_to_episode": {
"type": "number",
"description": "Episode the collection is updated to."
}
},
"description": "Collection counters.",
"additionalProperties": true
},
"mix_name": {
"type": "string",
"description": "The collection's public title."
}
},
"description": "The collection/playlist the clip belongs to, when it is part of one -- absent otherwise. On the calibrated fixtures `mix_id` equals `series_info.series_id` (the same underlying collection surfaced through two objects).",
"additionalProperties": true
},
"video_tag": {
"type": "array",
"items": {
"type": "object",
"properties": {
"tag_id": {
"type": "number"
},
"tag_name": {
"type": "string",
"description": "Tag label, e.g. an anime content vertical."
}
},
"additionalProperties": true
},
"description": "Content category tags for the video."
},
"statistics": {
"type": "object",
"properties": {
"digg_count": {
"type": "number",
"description": "Number of likes."
},
"play_count": {
"type": "number",
"description": "Play count -- observed as 0 on every entry in both fixtures; Douyin does not expose a real play count for these feed items."
},
"share_count": {
"type": "number",
"description": "Number of shares."
},
"collect_count": {
"type": "number",
"description": "Number of saves/bookmarks."
},
"comment_count": {
"type": "number",
"description": "Number of comments."
},
"recommend_count": {
"type": "number",
"description": "Recommendation count."
}
},
"description": "Public engagement counters for the video.",
"additionalProperties": true
},
"text_extra": {
"type": "array",
"items": {
"type": "object",
"properties": {
"hashtag_id": {
"type": "string",
"description": "The hashtag's public id."
},
"hashtag_name": {
"type": "string",
"description": "Hashtag text, e.g. a show, character, or fandom name."
}
},
"additionalProperties": true
},
"description": "Hashtag mentions parsed out of the caption, one entry each."
},
"create_time": {
"type": "number",
"description": "Publish time as Unix seconds."
},
"series_info": {
"type": "object",
"properties": {
"desc": {
"type": "string",
"description": "The series' public description."
},
"stats": {
"type": "object",
"properties": {
"total_episode": {
"type": "number"
},
"current_episode": {
"type": "number"
},
"updated_to_episode": {
"type": "number"
}
},
"additionalProperties": true
},
"series_id": {
"type": "string",
"description": "The series' public id."
},
"series_name": {
"type": "string",
"description": "The series' public title."
}
},
"description": "The anime series this clip is part of, when known -- absent otherwise.",
"additionalProperties": true
}
},
"description": "One anime/cartoon video record.",
"additionalProperties": true
},
"description": "One entry per video in the requested page. Both fixtures returned 16 entries."
},
"status_code": {
"type": "number",
"description": "0 on both real feeds observed; a nonzero value would signal a feed-level failure."
}
},
"description": "The feed page, as returned at routing.responseResultPath ($.output): a `status_code` (0 on both real calls) plus `aweme_list`, one entry per video in the page.",
"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 25, 2026