[中文]

用途:

获取抖音 App 中话题(挑战/标签)搜索的结果，使用 V2 版本 API。

支持关键词搜索，返回匹配的话题详情，包括话题名称、话题封面、浏览量、参与人数等。

备注:

本接口专注于搜索话题（Challenge/Hashtag）内容，不包含视频或直播等其他类型。

初次请求时 cursor 传入 0，search_id 传空字符串，后续翻页请使用上一次返回的 cursor 和 search_id。

参数:

keyword: 搜索关键词，如 "游戏"

cursor: 翻页游标（首次请求传 0，翻页时使用上次响应的 cursor）

sort_type: 排序方式

0: 综合排序

1: 最多点赞

2: 最新发布

publish_time: 发布时间筛选

0: 不限

1: 最近一天

7: 最近一周

180: 最近半年

filter_duration: 视频时长筛选

0: 不限

0-1: 1 分钟以内

1-5: 1-5 分钟

5-10000: 5 分钟以上

content_type: 内容类型筛选

0: 不限

1: 视频

2: 图片

3: 文章

search_id: 搜索ID（分页时使用）

请求体示例：

payload = {
    "keyword": "游戏",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

business_data（话题搜索结果列表）

data_id: 结果的唯一编号

type: 数据类型（固定为 2）

data.challenge_info:

cid: 话题ID

cha_name: 话题名称

desc: 话题描述

schema: 话题跳转链接（aweme://开头，可跳转抖音 App 内话题详情）

hashtag_profile: 话题封面图 URL

user_count: 参与人数

view_count: 话题浏览量

challenge_status: 话题状态（1=正常，其他=异常）

author: 创建者信息

uid: 创建者抖音用户ID

nickname: 昵称

avatar_thumb.url_list: 缩略头像URL列表

is_verified: 是否认证

follower_count: 粉丝数

share_info:

share_url: 话题分享链接

share_title: 分享标题

share_desc: 分享描述

[English]

Purpose:

Fetch hashtag/challenge search results from Douyin App using V2 API.

Supports searching by keyword and returns detailed challenge information, including name, cover image, view count, and participant count.

Notes:

This API focuses on searching challenges (hashtags), not including videos or live streams.

Set cursor to 0 and search_id to an empty string for the first request. For pagination, use the cursor and search_id from the last response.

Parameters:

keyword: Search keyword, e.g., "game"

cursor: Pagination cursor (0 for first request)

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: Under 1 minute

1-5: 1-5 minutes

5-10000: Over 5 minutes

content_type: Content type filter

0: Unlimited

1: Video

2: Image

3: Article

search_id: Search ID for pagination

Request Body Example:

payload = {
    "keyword": "game",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

Response (common fields, actual response may contain more fields):

business_data (list of hashtag search results)

data_id: Unique identifier for the result

type: Data type (fixed 2)

data.challenge_info:

cid: Challenge ID

cha_name: Challenge name

desc: Challenge description

schema: Challenge detail schema link (aweme:// schema, used to deep link inside Douyin App)

hashtag_profile: URL of the hashtag cover image

user_count: Number of participants

view_count: Number of views

challenge_status: Status (1 = active, others = abnormal)

author: Creator info

uid: User ID

nickname: Nickname

avatar_thumb.url_list: Thumbnail avatar URLs

is_verified: Whether the creator is verified

follower_count: Number of followers

share_info:

share_url: Shareable URL

share_title: Title for sharing

share_desc: Description for sharing

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Example

{
    "keyword": "猫咪",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取话题搜索 V2/Fetch hashtag search V2

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:#

[English]#

Purpose:#

Notes:#

Parameters:#

Request Body Example:#

Response (common fields, actual response may contain more fields):#

Request

Request Code Samples

Responses

[中文]

用途:

备注:

参数:

请求体示例：

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

[English]

Purpose:

Notes:

Parameters:

Request Body Example:

Response (common fields, actual response may contain more fields):