# Douyin search suggestions

Fetch keyword suggestion results from Douyin App. Takes keyword (optional). Served by TikHub.

Purpose:
- Fetch keyword suggestion results from Douyin App.
- Based on the user's input, returns a list of recommended search keywords to improve search experience.

Notes:
- Typically used for real-time keyword suggestions in the search box.
- The returned suggestions are scored and sorted internally by Douyin's recommendation system.

Parameters:
- keyword: Input keyword, e.g., "Artificial Intelligence"

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

Response (common fields, actual response may contain more fields):
- `status_code`: Status code (0 means success)
- `status_msg`: Response message (usually empty)
- `rid`: Request ID
- `sug_list[]`: List of suggested search keywords
  - `content`: Suggested keyword (e.g., "AI software free download")
  - `sug_type`: Suggestion type (usually empty, reserved field)
  - `pos[]`: Position marking
    - `begin`: Begin character position
    - `end`: End character position
  - `word_record`:
    - `group_id`: Suggestion group ID
    - `words_position`: Position in the current suggestion list
    - `words_content`: The word content (same as `content`)
    - `words_source`: Word source (typically "sug")
  - `extra_info`:
    - `client_server_extra`: Extra client-server config (JSON string)
    - `poi_id`: Related POI ID (usually empty)
    - `search_params`: Search parameters (with recommendation scores)
- `words_query_record`:
  - `info`: Additional info (usually empty)
  - `words_source`: Source of suggestions
  - `query_id`: Suggestion query ID
- `extra`:
  - `now`: Current server timest

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

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


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

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.01; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "需要联想的关键词/The keyword to be suggested",
      "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",
  "input": {
    "keyword": "人工智能"
  }
}
```

## 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_api_v1_douyin_search_fetch_search_suggest_post)

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

---

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