---
title: "Hot Search"
method: GET
path: "/api/douyin/hot-search/v1"
tags: ["Douyin (TikTok China)"]
---

# Hot Search

`GET /api/douyin/hot-search/v1`

## Request

- Base URL: `https://api.justoneapi.com`
- URL: `https://api.justoneapi.com/api/douyin/hot-search/v1`
- Auth: none declared

Searches Douyin (TikTok China) content with optional keyword, category, video-type, ranking, pagination, engagement, and creator-follower filters. Use it to support trend discovery and campaign research.

## Query parameters

- `token` string, required
- `keyword` string
- `contentType` 'ALL' | 'FASHION' | 'TECHNOLOGY' | 'SCIENCE' | 'PHOTOGRAPHY' | 'FOOD' | 'MOTHER_BABY' | 'PARENTING' | 'DRAMA' | 'GAME' | 'AUTOMOTIVE' | 'ANIMAL' | 'TRAVEL' | 'DANCE' | 'TRADITIONAL_CULTURE' | 'ART' | 'SPORTS' | 'MUSIC' | 'LIFE_RECORD' | 'HOME_LIVING' | 'LEISURE_ENTERTAINMENT' | 'WORKPLACE' | 'AGRICULTURE' | 'CASUAL' | 'ACG' | 'MOVIE' | 'TV_SERIES' | 'VARIETY_SHOW' | 'CELEBRITY' | 'HUMANITIES_SOCIAL_SCIENCE' | 'EDUCATION_CAMPUS' | 'EMOTION' | 'FINANCE' | 'PUBLIC_WELFARE': Douyin Hot Search content type.
- `videoType` 'ALL' | 'XINGTU_VIDEO' | 'NATURAL_VIDEO': Douyin Hot Search video type.
- `sortType` 'COMPREHENSIVE' | 'HIGH_INTERACTION' | 'HIGH_LIKE' | 'HIGH_COMMENT' | 'HIGH_SHARE': Douyin Hot Search sort type.
- `page` integer
- `likeCountMin` integer
- `likeCountMax` integer
- `commentCountMin` integer
- `commentCountMax` integer
- `shareCountMin` integer
- `shareCountMax` integer
- `interactionCountMin` integer
- `interactionCountMax` integer
- `followerCountMin` integer
- `followerCountMax` integer

## Response `200`

OK

- object
  - `code` 0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602, required
  - `message` string, nullable, required
  - `data` unknown, required
  - `recordTime` string, nullable, required
  - `requestId` string
  - `reason` string
  - `requestParams` object
    - `query` object
    - `body` object
      - `empty` boolean
      - `array` boolean
      - `null` boolean
      - `object` boolean
      - `float` boolean
      - `integralNumber` boolean
      - `floatingPointNumber` boolean
      - `bigDecimal` boolean
      - `bigInteger` boolean
      - `textual` boolean
      - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
      - `string` boolean
      - `missingNode` boolean
      - `valueNode` boolean
      - `container` boolean
      - `pojo` boolean
      - `short` boolean
      - `int` boolean
      - `long` boolean
      - `double` boolean
      - `boolean` boolean
      - `binary` boolean
      - `number` boolean
      - `embeddedValue` boolean

## Other responses

- `400`: Invalid request parameters or body
- `401`: Invalid or inactive access token
- `403`: Permission denied
- `429`: Request rate or daily quota limit exceeded
- `500`: Internal server error
- `503`: Service temporarily unavailable

## Changes

- **2026-10-31** `4f43dc260e5b`: 7 info
  - added the optional property `requestParams` to the response with the `200` status
  - added the optional property `requestParams` to the response with the `400` status
  - added the optional property `requestParams` to the response with the `401` status
  - added the optional property `requestParams` to the response with the `403` status
  - …3 more
- **2026-10-02** `9c931cc01324`: 7 info
  - added the optional property `reason` to the response with the `200` status
  - added the optional property `reason` to the response with the `400` status
  - added the optional property `reason` to the response with the `401` status
  - added the optional property `reason` to the response with the `403` status
  - …3 more

[Operation history](https://skmtc.dev/justoneapi/apis/justoneapi-api/changes/api/douyin/hot-search/v1/get.md)

---

[API](https://skmtc.dev/justoneapi/apis/justoneapi-api.md) - [All operations](https://skmtc.dev/justoneapi/apis/justoneapi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/justoneapi/apis/justoneapi-api/revisions/4f43dc260e5b?raw)