Douyin Search (Videos, Posts & Creators by Keyword)
omnial/douyin-search-fetch-multi-search
Given a keyword, searches Douyin (China's TikTok) across videos, image posts, and matching creator profiles. Each result carries the post's own text, its author's public identity and follower count, engagement stats (likes, comments, shares, collects), any attached hashtags, a sound/music credit when set, and a cursor to fetch the next page.
activeper callv5
Price
Up to $0.0205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from Douyin.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/douyin-search-fetch-multi-search" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-search-fetch-multi-search" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-search-fetch-multi-search", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-search-fetch-multi-search", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0205 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
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."
},
"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
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."
},
"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"
},
"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"
},
"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": "Usually 0."
},
"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."
},
"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"
},
"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"
},
"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": "Usually 0."
},
"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
}