Douyin Search Fetch Discuss Search
## Purpose Search Douyin discussion and Q&A content by topic. Results can be sorted and filtered by publication time, video duration, and content format. This tool searches discussion/Q&A content rather than all Douyin content and does not retrieve a comment thread. ## Inputs Provide a required `request_body` object. Its fields are optional: - `keyword`: Search text; defaults to `"猫咪"`. - `cursor`: Integer pagination cursor; defaults to `0`. - `search_id` and `backtrace`: Pagination identifiers; both default to `""`. - `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"` over five minutes. - `content_type`: `"0"` all (default), `"1"` video, `"2"` picture, `"3"` article. Use strings for filter values. For the first page, set `cursor` to `0` and leave `search_id` and `backtrace` empty. For later pages, use the corresponding values from the previous response when available. ## Returned information The response contains a status code and `data` holding search results, which may be null. Documented result items include a result type and `aweme_info` with content ID, description, author information, video playback and cover links, engagement counts, hashtags, music, content status, and a share link where available. Engagement counts can include likes, comments, shares, plays, and collections; they are not the comments themselves. Video duration in returned metadata is measured in milliseconds. Actual data structure and field availability may vary.
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 | 抖音讨论区/问答内容搜索的请求体对象,包含搜索关键词 keyword、分页参数 cursor、search_id、backtrace,以及排序 sort_type、发布时间 publish_time、视频时长 filter_duration 和内容类型 content_type 筛选字段。 / Request body object for searching Douyin discussion and Q&A content, containing the search keyword (keyword), pagination parameters (cursor, search_id, backtrace), sorting (sort_type), and filters for publication time (publish_time), video duration (filter_duration), and content type (content_type). | — |
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_discuss_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"backtrace": "",
"content_type": "0",
"cursor": 0,
"filter_duration": "0",
"keyword": "防水 旧房 翻新 漏水 避坑",
"publish_time": "180",
"search_id": "",
"sort_type": "1"
}
}
}'{
"code": 200,
"data": {
"business_data": [
{
"data": {
"aweme_list": [
{}
],
"prefetch_resource": {
"dynamic_component": null,
"prefetch_image": null
}
},
"data_id": "0",
"type": 999
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_discuss_search_api_v1_douyin_search_fetch_discuss_search_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

