获取经验搜索/Fetch experience search
POST
/api/v1/douyin/search/fetch_experience_search
Douyin-Search-API
Last modified:2025-05-01 12:31:14
OperationId:fetch_experience_search_api_v1_douyin_search_fetch_experience_search_post
[中文]
用途:
备注:
cursor
应传 0,search_id
传空字符串,翻页时使用上次响应返回的 cursor 和 search_id。参数:
0
: 综合排序1
: 最多点赞2
: 最新发布0
: 不限1
: 最近一天7
: 最近一周180
: 最近半年0
: 不限0-1
: 1分钟以内1-5
: 1-5分钟5-10000
: 5分钟以上search_id
请求体示例:
payload = {
"keyword": "游戏攻略",
"cursor": 0,
"sort_type": 0,
"publish_time": 0,
"filter_duration": 0,
"content_type": 1,
"search_id": ""
}
### 返回(部分常用字段,实际返回字段更多,一切以实际响应为准):
- business_data: 搜索结果业务数据列表
- data_id: 数据块ID
- type: 数据类型(如 999 表示内容列表)
- data:
- height: 显示区域高度
- aweme_list: 视频列表
- aweme_id: 视频ID
- desc: 视频描述内容
- create_time: 视频发布时间(时间戳)
- author: 作者信息
- uid: 作者UID
- nickname: 作者昵称
- avatar_thumb.url_list: 作者头像缩略图
- is_verified: 是否是认证账号
- follower_count: 粉丝数
- music: 背景音乐信息
- id_str: 音乐ID
- title: 音乐标题
- author: 音乐作者昵称
- cha_list: 关联的话题标签列表
- cha_name: 话题名称
- video: 视频播放信息
- play_addr.url_list: 视频播放地址列表
- cover.url_list: 视频封面图地址
- width: 视频宽度
- height: 视频高度
- duration: 视频时长(单位毫秒)
- statistics: 视频互动数据
- digg_count: 点赞数
- comment_count: 评论数
- share_count: 分享数
- play_count: 播放次数
- status: 视频状态信息
- is_delete: 是否已删除
- is_private: 是否私密
- share_url: 视频外部分享链接
# [English]
### Purpose:
- Fetch experience (knowledge/tutorial) content search results from Douyin App.
- Retrieves video results related to knowledge sharing, tutorials, or tips based on the input keyword.
### Notes:
- This API focuses on experience-related videos and does not include other content types.
- Set `cursor` to 0 and `search_id` to an empty string for the first request; for pagination, use the previous cursor and search_id.
- The response includes rich information such as video details, author profile, background music, hashtags, video URLs, and engagement statistics.
### Parameters:
- keyword: Search keyword, e.g., "gaming guide"
- cursor: Pagination cursor (0 for first page)
- sort_type: Sorting method
- `0`: Comprehensive
- `1`: Most likes
- `2`: Latest
- publish_time: Publish time filter
- `0`: Unlimited
- `1`: Last day
- `7`: Last week
- `180`: Last half year
- filter_duration: Video duration filter
- `0`: Unlimited
- `0-1`: Within 1 minute
- `1-5`: 1 to 5 minutes
- `5-10000`: More than 5 minutes
- content_type: Content type filter (usually fixed to video)
- search_id: Search ID for pagination
### Request Body Example:
```json
payload = {
"keyword": "gaming guide",
"cursor": 0,
"sort_type": 0,
"publish_time": 0,
"filter_duration": 0,
"content_type": 1,
"search_id": ""
}
Response (common fields, actual response may contain more fields):
Request
Body Params application/json
Request samples
Responses
Modified at 2025-05-01 12:31:14