JUjustoneapi
Douyin (TikTok China)

Hot Search

Changed on

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.

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

Query parameters

tokenstring required

Access token for this API service.

keywordstring

Optional search keyword.

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.

Top-level content type. Only one content type can be selected.

Available Values:

  • ALL: All content types.
  • FASHION: Fashion.
  • TECHNOLOGY: Technology.
  • SCIENCE: Science.
  • PHOTOGRAPHY: Photography and videography.
  • FOOD: Food.
  • MOTHER_BABY: Mother and baby.
  • PARENTING: Parenting.
  • DRAMA: Drama.
  • GAME: Game.
  • AUTOMOTIVE: Automotive.
  • ANIMAL: Animal.
  • TRAVEL: Travel.
  • DANCE: Dance.
  • TRADITIONAL_CULTURE: Traditional culture.
  • ART: Art.
  • SPORTS: Sports.
  • MUSIC: Music.
  • LIFE_RECORD: Life records.
  • HOME_LIVING: Home and living.
  • LEISURE_ENTERTAINMENT: Leisure entertainment.
  • WORKPLACE: Workplace.
  • AGRICULTURE: Agriculture.
  • CASUAL: Casual videos.
  • ACG: Animation, comics, and games.
  • MOVIE: Movie.
  • TV_SERIES: TV series.
  • VARIETY_SHOW: Variety show.
  • CELEBRITY: Celebrity.
  • HUMANITIES_SOCIAL_SCIENCE: Humanities and social science.
  • EDUCATION_CAMPUS: Education and campus.
  • EMOTION: Emotion.
  • FINANCE: Finance.
  • PUBLIC_WELFARE: Public welfare.
videoType'ALL' | 'XINGTU_VIDEO' | 'NATURAL_VIDEO'

Douyin Hot Search video type.

Video type filter.

Available Values:

  • ALL: All video types.
  • XINGTU_VIDEO: Xingtu commercial videos.
  • NATURAL_VIDEO: Natural videos.
sortType'COMPREHENSIVE' | 'HIGH_INTERACTION' | 'HIGH_LIKE' | 'HIGH_COMMENT' | 'HIGH_SHARE'

Douyin Hot Search sort type.

Sorting criteria for hot content results.

Available Values:

  • COMPREHENSIVE: Comprehensive ranking.
  • HIGH_INTERACTION: Highest interaction count.
  • HIGH_LIKE: Highest like count.
  • HIGH_COMMENT: Highest comment count.
  • HIGH_SHARE: Highest share count.
pageinteger

Page number (starting from 1). Page size is fixed at 10.

likeCountMininteger

Minimum raw like count.

likeCountMaxinteger

Maximum raw like count.

commentCountMininteger

Minimum raw comment count.

commentCountMaxinteger

Maximum raw comment count.

shareCountMininteger

Minimum raw share count.

shareCountMaxinteger

Maximum raw share count.

interactionCountMininteger

Minimum raw interaction count.

interactionCountMaxinteger

Maximum raw interaction count.

followerCountMininteger

Minimum raw creator follower count.

followerCountMaxinteger

Maximum raw creator follower count.

Response

OK

code0 | 100 | 101 | 202 | 300 | 301 | 302 | 303 | 400 | 404 | 500 | 503 | 600 | 601 | 602 required
messagestring nullable required
dataunknown required
recordTimestring nullable required
requestIdstring
reasonstring

Changes

  • 9c931cc01324Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status