douyin/search/challenge-search-v2

Fetch hashtag search V2

Purpose:

• Fetch hashtag/challenge search results from Douyin App using V2 API.
• Supports searching by keyword and returns detailed challenge information, including name, cover image, view count, and participant count.

Notes:

• This API focuses on searching challenges (hashtags), not including videos or live streams.
• Set cursor to 0 and search_id to an empty string for the first request. For pagination, use the cursor and search_id from the last response.

Parameters:

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

• business_data (list of hashtag search results)
  • data_id: Unique identifier for the result
  • type: Data type (fixed 2)
  • data.challenge_info:
    • cid: Challenge ID
    • cha_name: Challenge name
    • desc: Challenge description
    • schema: Challenge detail schema link (aweme:// schema, used to deep link inside Douyin App)
    • hashtag_profile: URL of the hashtag cover image
    • user_count: Number of participants
    • view_count: Number of views
    • challenge_status: Status (1 = active, others = abnormal)
    • author: Creator info
      • uid: User ID
      • nickname: Nickname
      • avatar_thumb.url_list: Thumbnail avatar URLs
      • is_verified: Whether the creator is verified
      • follower_count: Number of followers
    • share_info:
      • share_url: Shareable URL
      • share_title: Title for sharing
      • share_desc: Description for sharing

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