Douyin Search Fetch General Search V1
## Purpose Search the Douyin app's general search tab by keyword. This is general search, not the standalone video-search tab. You can sort results and filter by publication time, video duration and content type. ## Inputs Pass a required `request_body` object. Its fields have documented defaults: - `keyword`: search text; default `"猫咪"`. - `cursor`: integer pagination cursor; default `0`. - `search_id` and `backtrace`: pagination strings; default `""`. - `sort_type`: `"0"` comprehensive (default), `"1"` most likes, `"2"` latest. - `publish_time`: `"0"` unrestricted (default), `"1"` last day, `"7"` last week, `"180"` last half year. - `filter_duration`: `"0"` unrestricted (default), `"0-1"` within one minute, `"1-5"` one to five minutes, `"5-10000"` more than five minutes. - `content_type`: `"0"` all (default), `"1"` video, `"2"` picture, `"3"` article. Use strings for all filter values. On the first request, use `cursor: 0`, `search_id: ""` and `backtrace: ""`. For later pages, copy these three values from the previous response. ## Results The response's `data` payload contains search results. Depending on the item, results may include content IDs and descriptions, author profiles, music, hashtags, video playback and cover URLs, share links, engagement statistics and publishing status or permissions. Common documented fields include `aweme_info`, `aweme_id`, `desc`, `author`, `music`, `cha_list`, `video`, `statistics`, `status` and `share_url`. Engagement statistics can include likes, comments, shares, plays and collections; video duration is measured in milliseconds. The data schema is flexible and may be null, so inspect the actual response rather than assuming every result has every field.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 抖音 App 综合搜索的请求体对象,包含搜索关键词 keyword、排序方式 sort_type、发布时间筛选 publish_time、视频时长筛选 filter_duration、内容类型筛选 content_type,以及用于翻页的 cursor、search_id 和 backtrace。首次请求时 cursor 为 0,search_id 和 backtrace 为空字符串;翻页时使用上一次响应返回的这三个字段值。 / Request body object for Douyin App general search, containing the keyword, sorting method, publication time, video duration and content type filters, plus cursor, search_id and backtrace for pagination. For the first request, use cursor=0 and empty search_id and backtrace strings; for subsequent pages, use these three values from the previous response. | — |
request_body.cursor | integer | No | 偏移游标,用于翻页,从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response | 0 |
request_body.keyword | string | No | 关键词 / Keyword | 猫咪 |
request_body.backtrace | string | No | 翻页回溯标识,用于翻页,从上一次请求返回的响应中获取 / Backtrace for pagination, obtained from the last response | "" |
request_body.search_id | string | No | 搜索ID,用于翻页,从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response | "" |
request_body.sort_type | string | No | 排序方式:0=综合排序 1=最多点赞 2=最新发布 / Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest | 0 |
request_body.content_type | string | No | 内容类型:0=不限 1=视频 2=图片 3=文章 / Content type: 0=All, 1=Video, 2=Picture, 3=Article | 0 |
request_body.publish_time | string | No | 发布时间筛选:0=不限 1=最近一天 7=最近一周 180=最近半年 / Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year | 0 |
request_body.filter_duration | string | No | 视频时长过滤: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 | 0 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_search_fetch_general_search_v1' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"backtrace": "",
"content_type": "1",
"cursor": 0,
"keyword": "上海迪士尼",
"publish_time": "7",
"search_id": "",
"sort_type": "0"
}
}
}'{
"code": 200,
"data": {
"data": [
{
"aweme_info": {
"author": {
"avatar_larger": {},
"avatar_medium": {},
"avatar_thumb": {},
"aweme_count": 0,
"birthday": "1993-01-01",
"follow_status": 0
},
"aweme_id": "7706141712700257957",
"create_time": 1794225935,
"desc": "连迪士尼都没想到,玲娜贝儿会火成这样? 从一个由上海迪士尼打造的原创角色,拥有了庞大的粉丝群体,上海网友叫ta“川沙妲己”。玲娜贝儿的爆红究竟是精心策划,还是一场超出预期的惊喜?\n\n上海迪士尼度假区总裁兼总经理包兆天揭秘:当初团队究竟有多看好这只粉色小狐狸?又是如何不断创造新的惊喜,让中国粉丝对她持续上头?\n\n💗 贝儿粉们集合!你最喜欢玲娜贝儿的哪套造型?有没有让你至今难忘的贝儿互动瞬间?欢迎在评论区晒出照片,分享你心中的“贝儿名场面”!\n\n#sohereweare #马星星播客 #迪士尼 #双语视频 #"
},
"type": 1
}
],
"status_code": 0
},
"docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_general_search_v1_api_v1_douyin_search_fetch_general_search_v1_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "8510d71c-3964-4078-a183-cf0a12a2438e"
}This example shows part of the response. Copied content is valid JSON.

