# Douyin hashtag search

Fetch hashtag/challenge search results from Douyin App using V2 API. Takes keyword, cursor, sort type and more, all optional. Served by TikHub.

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:
```json
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`: Chall

- Tool ID: `tikhub/douyin-search-fetch-challenge-search-v2`
- Name in the catalog: Douyin, Fetch hashtag search V2
- 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": "关键词 / Keyword",
      "default": "猫咪"
    },
    "cursor": {
      "type": "integer",
      "title": "Cursor",
      "description": "偏移游标，用于翻页，从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response",
      "default": 0
    },
    "sort_type": {
      "type": "string",
      "title": "Sort Type",
      "description": "排序方式：0=综合排序 1=最多点赞 2=最新发布 / Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest",
      "default": "0"
    },
    "publish_time": {
      "type": "string",
      "title": "Publish Time",
      "description": "发布时间筛选：0=不限 1=最近一天 7=最近一周 180=最近半年 / Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year",
      "default": "0"
    },
    "filter_duration": {
      "type": "string",
      "title": "Filter Duration",
      "description": "视频时长过滤：0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上 / Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes",
      "default": "0"
    },
    "content_type": {
      "type": "string",
      "title": "Content Type",
      "description": "内容类型：0=不限 1=视频 2=图片 3=文章 / Content type: 0=All, 1=Video, 2=Picture, 3=Article",
      "default": "0"
    },
    "search_id": {
      "type": "string",
      "title": "Search Id",
      "description": "搜索ID，用于翻页，从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response",
      "default": ""
    },
    "backtrace": {
      "type": "string",
      "title": "Backtrace",
      "description": "翻页回溯标识，用于翻页，从上一次请求返回的响应中获取 / Backtrace for pagination, obtained from the last response",
      "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-challenge-search-v2",
  "input": {
    "keyword": "猫咪",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": "",
    "backtrace": ""
  }
}
```

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

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

---

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