douyin/search/challenge-search-v1

Fetch hashtag search V1

Purpose:

• Fetch hashtag/challenge search results from Douyin App.
• Returns related hashtag topics including name, view count, participants, and cover images.

Notes:

• Only hashtag type content is returned.
• Set cursor to 0 and search_id to an empty string for the first request.
• For pagination, use cursor and search_id from the last response.

Parameters:

• keyword: Search keyword, e.g., "food"
• 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-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:

payload = {
    "keyword": "food",
    "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):

• cursor: Cursor for next page

• has_more: Whether more results are available (1=Yes, 0=No)

• challenge_list[]: List of hashtags

  • challenge_info:
    • cid: Challenge ID
    • cha_name: Challenge name (e.g., "#FoodHunt")
    • desc: Challenge description
    • schema: Deep link for Douyin App
    • share_info:
      • share_url: H5 shareable link
      • share_title: Share title
      • share_desc: Share description
    • view_count: Total view count
    • user_count: Total participant count
    • hashtag_profile: Cover image URL
    • challenge_status: Challenge status (1=Normal, 0=Abnormal)
  • author:
    • uid: Author's user ID
    • nickname: Author's nickname
    • follower_count: Follower count
    • is_verified: Verified status
    • region: Region
    • avatar_thumb.url_list: Thumbnail avatar URLs
    • avatar_medium.url_list: Medium avatar URLs
    • avatar_larger.url_list: Large avatar URLs

• extra:

  • now: Server timestamp
  • search_request_id: Unique search session ID

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