douyin.trends.hotsearch@v1

Douyin hot search

Hot Search TermList

Read the current public hot-search terms with observable heat and activity counts.

POST/v1/douyin/trends/hot-search

Chinese name: 抖音热搜榜 · 热搜词 · 列表
读取当前公开热搜词及热度、浏览和关联作品快照。

Use it when

Use it to discover terms receiving strong public attention now.

Do not use it for

Do not use it for historical trends, forecasts, or ranking causality.

Request parameters

FieldTypeConstraints and defaultsRequirement

Full request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Static response example

application/json

{
  "code": 200,
  "request_id": "req_example_douyin_batch_3",
  "message": "success",
  "data": {
    "items": [
      {
        "id": "hot-01",
        "keyword": "AI 应用",
        "rank": 1,
        "hot_value": 9876543,
        "views": 12345678,
        "related_videos": 4321,
        "label_code": 3
      }
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "result_status": "complete",
    "balance_after": "0.98",
    "listing_id": "douyin.trends.hotsearch",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-17.1",
    "price_book_version": "pricebook-production-2026-09-17.1",
    "charged_amount": "0.02",
    "currency": "CNY"
  }
}

Unavailable while paused

Nonempty complete results are charged; empty, partial, and failed results are not.

Response contract

The field summary is for scanning; the full JSON Schema is the stable output contract.

FieldTypeConstraints and defaultsRequirement

Fieldcodenumberconst: 200Required

Fieldrequest_idstringNo additional constraintsRequired

Fieldmessagestringconst: "success"Required

FielddataobjectNo additional constraintsRequired

FieldpageobjectNo additional constraintsRequired

FieldwarningsarrayNo additional constraintsRequired

FieldmetaobjectNo additional constraintsRequired

Full response JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "keyword": {
                "type": "string"
              },
              "rank": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "hot_value": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "views": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "related_videos": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "label_code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "required": [
              "id",
              "keyword",
              "rank",
              "hot_value",
              "views",
              "related_videos",
              "label_code"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "douyin.trends.hotsearch"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "const": "complete"
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Known limitations

This is a point-in-time board snapshot.
Heat, views, and related-video counts use different public units.
Board order does not explain the recommendation algorithm.

Integration example

REST (cURL)

curl -X POST https://api.dataxapi.com/v1/douyin/trends/hot-search \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: your-stable-intent-key" \
  -H "Content-Type: application/json" \
  -d '{}'

Exact MCP Preview (Codex config)

[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"

The same API key exposes only the precise tools in its scope. Keep the key in an environment variable, never in the config file. Reuse an explicit idempotency_key for safe retries.

View client compatibility →

Catalog release: catalog-production-2026-09-17.1 · PriceBook: pricebook-production-2026-09-17.1