获取作品搜索关键词统计/Fetch item search keywords statistics

[中文]

用途:

• 获取抖音作品的搜索关键词统计数据
• 了解用户通过哪些搜索关键词找到并观看了该作品
• 帮助创作者优化内容标题、标签和描述，提升搜索曝光
• 此接口需要用户提供有效的抖音创作者平台Cookie
• 使用 POST 方法，Cookie 在请求体中传输，更安全

请求体参数:

• cookie: 用户的抖音创作者平台Cookie（必填，在请求体中传输）
• item_id: 作品ID（必填）

返回数据说明:

返回用户搜索该作品时使用的关键词列表，包括：

• keyword: 搜索关键词
• count: 该关键词被搜索的次数
• percentage: 该关键词占总搜索量的百分比

注意: 如果返回空列表，说明该作品目前暂无搜索关键词数据，可能原因：

• 作品刚发布，还没有用户通过搜索观看
• 作品主要通过推荐、关注等非搜索渠道传播
• 数据统计周期内没有搜索行为

数据价值:

• 优化标题: 根据热门关键词调整作品标题
• 优化标签: 添加相关的热门搜索词作为标签
• 内容策划: 了解用户兴趣点，制作更符合需求的内容
• SEO优化: 提升作品在搜索结果中的排名

Cookie 获取方式:

1. 登录抖音创作者平台 (https://creator.douyin.com)
2. 打开浏览器开发者工具（F12）
3. 切换到 Network 标签
4. 刷新页面或进行操作
5. 找到任意请求，复制 Cookie 请求头的值

[English]

Purpose:

• Get Douyin item search keywords statistics
• Understand which search keywords users used to find and watch the item
• Help creators optimize content titles, tags, and descriptions to improve search exposure
• This API requires users to provide valid Douyin Creator Platform Cookie
• Use POST method, Cookie is transmitted in request body, more secure

Request Body Parameters:

• cookie: User's Douyin Creator Platform Cookie (required, transmitted in request body)
• item_id: Item ID (required)

Return Data Description:

Returns a list of keywords users searched for to find this item, including:

• keyword: Search keyword
• count: Number of times this keyword was searched
• percentage: Percentage of this keyword in total searches

Note: If an empty list is returned, it means there is currently no search keyword data for this item, possible reasons:

• Item was just published and no users have searched for it yet
• Item is mainly spread through recommendations, follows, etc., not through search
• No search behavior during the statistics period

Data Value:

• Optimize Title: Adjust item title based on popular keywords
• Optimize Tags: Add relevant popular search terms as tags
• Content Planning: Understand user interests and create more relevant content
• SEO Optimization: Improve item ranking in search results

How to get Cookie:

1. Login to Douyin Creator Platform (https://creator.douyin.com)
2. Open browser developer tools (F12)
3. Switch to Network tab
4. Refresh page or perform operations
5. Find any request and copy the Cookie header value

[示例/Example]

{
    "cookie": "Your_Cookie_Here",
    "item_id": "7559536212910853422"
}

返回数据示例/Response Example:

{
    "keywords": [
        {
            "keyword": "搞笑视频",
            "count": 1250,
            "percentage": 35.5
        },
        {
            "keyword": "热门音乐",
            "count": 850,
            "percentage": 24.2
        },
        {
            "keyword": "舞蹈教学",
            "count": 620,
            "percentage": 17.6
        }
    ],
    "total_count": 3520,
    "status_code": 0,
    "status_msg": ""
}

数据解读/Data Interpretation:

• 关键词列表按搜索次数降序排列
• percentage 值越高，说明该关键词越受用户关注
• 可以根据高频关键词优化作品的标题、描述和标签
• 发现意外的热门关键词可能揭示新的内容方向
• 空列表: 说明作品暂无搜索数据，作品主要通过其他渠道传播

应用建议/Application Suggestions:

1. 标题优化: 在标题中自然融入高频关键词
2. 标签策略: 使用搜索量高的关键词作为标签
3. 内容调整: 创作更多用户搜索的相关内容
4. 竞品分析: 对比不同作品的关键词差异

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.