douyin/index/item-query

Video search results

Purpose:

• Search the Douyin Index video library with 4-dimensional filters: category, duration, label type, publish date
• Results contain basic video info plus core metrics (plays, likes, followers, etc.) Parameters:
• query: Search keyword (required), e.g. "food"
• category_id: Category ID (string), default "0"=all
  • Common examples: 601=Drama, 602=Celebrity, 603=Variety, 604=Movie, 605=TV Series, 606=Music, 607=Anime, 608=Games, 615=Tech, 628=Food, 629=Travel, 631=Fashion
  • Full list (36 items incl. newly added) available via fetch_item_filter_options
• date_type: Publish date filter, default 0=any
  • Valid values: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days
• label_type: Video type (quality tag), default 0=any
  • Valid values: 0=any, 1=low-follower hit, 2=high completion rate, 3=high follower growth, 4=high like rate
• duration_type: Duration filter, default 0=any
  • Valid values: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s Note:
• All filter values can be fetched dynamically via GET /fetch_item_filter_options to avoid hard-coded outdated data. Return:
• Video list. Each item contains: itemId, itemTitle, cover, duration, publish time, play count, like count, comment count, share count, author id/nickname/followers, etc.

[Example]

category_id = "0"

category_id = "628" date_type = 7 duration_type = 6 label_type = 2

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.