# Douyin music search

Fetch music content search results from Douyin App. Takes keyword, cursor, sort type and more, all optional. Served by TikHub.

Purpose:
- Fetch music content search results from Douyin App.
- Supports filtering by keyword, sort type, etc.

Notes:
- This API focuses on music content search, excluding other types.
- Set `cursor` to 0 and `search_id` to an empty string for the first request.
- Response includes music basic info, artist info, covers, play URLs, tags, etc.

Parameters:
- keyword: Search keyword, e.g., "game background music"
- 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 to 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 background music",
    "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):
- `music`: List of music search results
  - `id_str`: Music ID (as string)
  - `title`: Music title
  - `author`: Music author's nickname
  - `album`: Album name (if any)
  - `play_url.url_list`: List of music play URLs
  - `duration`: Duration in seconds
  - `cover_thumb.url_list`: List of thumbnail cover URLs
  - `cover

- Tool ID: `tikhub/douyin-search-fetch-music-search`
- Name in the catalog: Douyin, Fetch music search
- 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-music-search",
  "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_music_search_api_v1_douyin_search_fetch_music_search_post)

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

---

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