douyin/creator-v2/item-search-keyword

Fetch item search keywords statistics

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"
}

{
    "keywords": [
        {
            "count": 1250,
            "percentage": 35.5
        },
        {
            "count": 850,
            "percentage": 24.2
        },
        {
            "count": 620,
            "percentage": 17.6
        }
    ],
    "total_count": 3520,
    "status_code": 0,
    "status_msg": ""
}

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