# Douyin search suggestions

Fetch Douyin search keyword suggestions (V2). Takes keyword and history words, all optional. Served by TikHub.

Purpose:
- Fetch Douyin search keyword suggestions (V2).
- Returns suggested keywords for the entered prefix, for real-time search-box completion.

Notes:
- The number of suggestions is decided by Douyin and cannot be specified.
- `history_words` is optional; passing the user's previous search words (comma separated)
  affects the ranking of the suggestions.
- Compared with V1, V2 returns a plain `words` list directly, no extraction needed.

Parameters:
- keyword: The entered keyword, e.g., "Artificial Intelligence"
- history_words: Optional history search words, e.g., "cat,food"

Request Body Example:
```json
payload = {
    "keyword": "Artificial Intelligence",
    "history_words": ""
}
```

Response (common fields, actual response may contain more fields):
- `words[]`: Plain list of suggested keywords (enough for most use cases)
- `items[]`: Full suggestion entries, use when highlight positions or sources are needed
  - `content`: Suggested keyword
  - `pos[]`: Matched position (`begin` / `end` character positions)
  - `word_record`: Word record (`group_id`, `words_source`, etc.)
  - `extra_info`: Extra information
- `virtual[]`: Virtual suggestion list (only for some keywords)
- `empty_reason`: Why the suggestion list is empty (only returned when there is no result)

- Tool ID: `tikhub/douyin-search-fetch-search-suggest-v2`
- Variant: API v2
- Name in the catalog: Douyin, Fetch search keyword suggestions V2
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Douyin search](/tools/douyin/search.md)
- Price: price pending
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

No price is recorded for this tool yet.


```json
{
  "model": "per_call",
  "amountUsd": 0
}
```

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "需要联想的关键词/The keyword to be suggested",
      "default": "人工智能"
    },
    "history_words": {
      "type": "string",
      "title": "History Words",
      "description": "可选，用户的历史搜索词（英文逗号分隔），会影响联想词的排序/Optional, the user's history search words (comma separated), affects the ranking of suggestions",
      "default": ""
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/douyin-search-fetch-search-suggest-v2",
  "input": {
    "keyword": "人工智能",
    "history_words": ""
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Douyin-Search-API/fetch_search_suggest_v2_api_v1_douyin_search_fetch_search_suggest_v2_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/douyin-search-fetch-search-suggest-v2) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/douyin-search-fetch-search-suggest-v2) · [Agent index](/llms.txt)