Douyin Hashtag Challenge Search (V2)

Name: Douyin Hashtag Challenge Search (V2)
Price: 0.015 USD
Availability: InStock
Author: Douyin

https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v2

Returns Douyin hashtag and challenge search results matching a query keyword. Supports filtering by sort type, content type, post date, and duration with cursor-based pagination.

Try this API Get API key

Price: $0.01USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 0 required · 8 optional

Production route

Try the model

Playground

Open playground

Input

Backtrace(string)

Backtrace for pagination, obtained from the last response

Content Type(string)

Content type filter

Cursor(integer)

Pagination cursor (0 for first request)

Filter Duration(string)

Video duration filter

Keyword(string)

Search keyword, e.g., "game"

Publish Time(string)

Publish time filter

Search Id(string)

Search ID for pagination

Sort Type(string)

Sorting method

OutputExample

Responseoutputs · 270.7 KB · 6,357 lines

[
  {
    "data": {
      "business_config": {
        "ad_info": null,
        "card_count": 19,
        "extra": {
          "is_filter_search": 0,
          "req_start_ts": 1787219266071
        },
        "extra_fresh_struct": null,
        "feedback": null,
        "feelgood_msg": {},
        "filter_bar": null,
        "has_more": 1,
        "is_filter_search": 0,
        "keyword": "猫咪",
        "next_page": {
          "cursor": 20,
          "keyword": "猫咪",
          "poi_search_info": "",
          "search_id": "20260820174746AB438B5EAEE580FC2B3B",
          "search_request_id": "20260820174746AB438B5EAEE580FC2B3B"
        },
        "poi_search_info": "",
        "pre_loadmore_config": null,
        "search_nil_info": null
      },
      "business_data": [
        {
          "card_id": "douyin.doctype_aweme_hashtag",
          "data": {
            "challenge_info": {
              "author": {
                "accept_private_policy": false,
                "account_region": "",
                "ad_cover_url": null,
                "allow_story_normal_like": false,
                "apple_account": 0,
                "authority_status": 0,
                "avatar_168x168": {
                  "height": 720,
                  "uri": "168x168/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864",
                  "url_list": [
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864~c5_168x168.webp?from=273881474",
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864~c5_168x168.jpeg?from=273881474"
                  ],
                  "width": 720
                },
                "avatar_300x300": {
                  "height": 720,
                  "uri": "300x300/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864",
                  "url_list": [
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864~c5_300x300.webp?from=273881474",
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864~c5_300x300.jpeg?from=273881474"
                  ],
                  "width": 720
                },
                "avatar_larger": {
                  "height": 720,
                  "uri": "1080x1080/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864",
                  "url_list": [
                    "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864.webp?from=273881474",
                    "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864.jpeg?from=273881474"
                  ],
                  "width": 720
                },
                "avatar_medium": {
                  "height": 720,
                  "uri": "720x720/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864",
                  "url_list": [
                    "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864.webp?from=273881474",
                    "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864.jpeg?from=273881474"
                  ],
                  "width": 720
                },
                "avatar_schema_list": null,
                "avatar_thumb": {
                  "height": 720,
                  "uri": "100x100/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864",
                  "url_list": [
                    "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864.webp?from=273881474",
                    "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864.jpeg?from=273881474"
                  ],
                  "width": 720
                },
                "avatar_uri": "aweme-avatar/tos-cn-avt-0015_8f9c89c85921da89d4026411d3fd5864",
                "aweme_control": {
                  "can_comment": true,
                  "can_forward": true,
                  "can_share": true,
                  "can_show_comment": true
                },
                "aweme_count": 0,
                "aweme_hotsoon_auth": 1,
                "awemehts_greet_info": "",
                "ban_user_functions": [],
                "batch_unfollow_contain_tabs": null,
                "batch_unfollow_relation_desc": null,
                "bind_phone": "",
                "birthday": "",
                "can_set_geofencing": null,
                "card_entries": null,
                "card_entries_not_display": null,
                "card_sort_priority": null,
                "cf_list": null,
                "cha_list": null,
                "close_friend_type": 0,
                "comment_filter_status": 0,
                "comment_setting": 0,
                "commerce_user_level": 0,
                "constellation": 10,
                "contacts_status": 2,
                "contrail_list": null,
                "cover_url": [
                  {
                    "height": 720,
                    "uri": "c8510002be9a3a61aad2",
                    "url_list": [
                      "https://p3-sign.douyinpic.com/obj/c8510002be9a3a61aad2?lk3s=10531982&x-expires=1788426000&x-signature=JvJ3QRyF5z8K0MAjsm3BIcA4sFg%3D&from=273881474"
                    ],
                    "width": 720
                  }
                ],
                "create_time": 0,
                "creator_tag_list": null,
                "custom_verify": "",
                "cv_level": "",
                "data_label_list": null,
                "disable_image_comment_saved": 0,
                "display_info": null,
                "download_prompt_ts": 0,
                "download_setting": -1,
                "duet_setting": 0,
                "enable_nearby_visible": true,
                "endorsement_info_list": null,
                "enterprise_verify_reason": "",
                "familiar_confidence": 0,
                "familiar_visitor_user": null,
                "favoriting_count": 0,
                "fb_expire_time": 0,
                "follow_status": 0,
                "follower_count": 961,
                "follower_list_secondary_information_struct": null,
                "follower_request_status": 0,
                "follower_status": 0,
                "followers_detail": null,
                "following_count": 0,
                "gender": 0,
                "geofencing": [],
                "google_account": "",
                "has_email": false,
                "has_facebook_token": false,
                "has_insights": false,
                "has_orders": false,
                "has_twitter_token": false,
                "has_unread_story": false,
                "has_youtube_token": false,
                "hide_location": false,
                "hide_search": true,
                "homepage_bottom_toast": null,
                "house_talent_info": 0,
                "identity_labels": null,
                "im_role_ids": null,
                "ins_id": "",
                "interest_tags": null,
                "is_ad_fake": false,
                "is_ban": false,
                "is_binded_weibo": false,
                "is_block": false,
                "is_blocked_v2": false,
                "is_blocking_v2": false,
                "is_cf": 0,
                "is_discipline_member": false,
                "is_gov_media_vip": false,
                "is_mix_user": false,
                "is_not_show": false,
                "is_phone_binded": false,
                "is_star": false,
                "is_verified": true,
                "item_list": null,
                "ky_only_predict": 0,
                "language": "zh-Hans",
                "link_item_list": null,
                "live_agreement": 0,
                "live_agreement_time": 0,
                "live_commerce": false,
                "live_high_value": 0,
                "live_status": 0,
                "live_verify": 0,
                "location": "",
                "mate_add_permission": 0,
                "mate_count": 0,
                "mate_relation": {
                  "mate_apply_forward": 0,
                  "mate_apply_reverse": 0,
                  "mate_status": 0
                },
                "max_follower_count": 0,
                "need_points": null,
                "need_recommend": 0,
                "neiguang_shield": 0,
                "new_story_cover": null,
                "nickname": "Nineeeeeeee🌈",
                "not_seen_item_id_list": null,
                "not_seen_item_id_list_v2": null,
                "offline_info_list": null,
                "personal_tag_list": null,
                "platform_sync_info": null,
                "prevent_download": false,
                "private_relation_list": null,
                "profile_component_disabled": null,
                "profile_mob_params": null,
                "profile_signature_components": null,
                "react_setting": 0,
                "reflow_page_gid": 0,
                "reflow_page_uid": 0,
                "region": "CN",
                "relative_users": null,
                "risk_notice_text": "",
                "room_id": 0,
                "room_id_str": "0",
                "school_category": 0,
                "school_id": "",
                "school_name": "",
                "school_poi_id": "",
                "school_type": 0,
                "search_impr": {
                  "entity_id": "57797280539"
                },
                "sec_uid": "MS4wLjABAAAAuIfSSwm_vX3nwCZPkb6bhnlUJZh1tRBw6FuTjGTR0_k",
                "secret": 0,
                "share_info": {
                  "share_desc": "",
                  "share_desc_info": "",
                  "share_qrcode_url": {
                    "height": 720,
                    "uri": "216a001050607a8c680e",
                    "url_list": [
                      "https://p3-sign.douyinpic.com/obj/216a001050607a8c680e?lk3s=10531982&x-expires=1787238000&x-signature=jNxo81Gg5BlwD52kBk2IB6jR6W0%3D&from=273881474"
                    ],
                    "width": 720
                  },
                  "share_title": "",
                  "share_title_myself": "",
                  "share_title_other": "",
                  "share_url": "",
                  "share_weibo_desc": ""
                },
                "share_qrcode_uri": "216a001050607a8c680e",
                "shield_comment_notice": 0,
                "shield_digg_notice": 0,
                "shield_follow_notice": 0,
                "short_id": "4395328",
                "show_image_bubble": false,
                "show_nearby_active": false,
                "signature": "🤪消除烦恼，带来快乐‼️",
                "signature_display_lines": 5,
                "signature_extra": null,
                "social_real_relation_type": 0,
                "special_follow_status": 0,
                "special_lock": 1,
                "special_people_labels": null,
                "status": 1,
                "stitch_setting": 0,
                "story_count": 0,
                "story_open": false,
                "sync_to_toutiao": 0,
                "text_extra": null,
                "total_favorited": 0,
                "tw_expire_time": 0,
                "twitter_id": "",
                "twitter_name": "",
                "type_label": null,
                "uid": "57797280539",
                "unique_id": "",
                "unique_id_modify_time": 1787219266,
                "user_age": 126,
                "user_canceled": false,
                "user_mode": 0,
                "user_not_see": 0,
                "user_not_show": 1,
                "user_period": 0,
                "user_permissions": null,
                "user_rate": 1,
                "user_tags": null,
                "verification_permission_ids": null,
                "verification_type": 1,
                "verify_info": "",
                "video_icon": {
                  "height": 720,
                  "uri": "",
                  "url_list": [],
                  "width": 720
                },
                "webcast_preview_labels": null,
                "weibo_name": "",
                "weibo_schema": "",
                "weibo_url": "",
                "weibo_verify": "",

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.01 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

backtrace: string · optional
content_type: string · optional
cursor: integer · optional
filter_duration: string · optional
keyword: string · optional
publish_time: string · optional
search_id: string · optional
sort_type: string · optional

Access

Provider: Douyin
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/douyin/search/challenge-search-v2
Authentication: Bearer API key

API README

Douyin Hashtag Challenge Search (V2) API

Search Douyin hashtags and challenges using keyword alongside multiple filtering parameters. Use cursor, search_id, and backtrace to paginate through consecutive batches of results.

Use cases

Look up trending hashtag challenges across Douyin.
Filter challenge search results by video duration and post date.
Track content associated with specific campaign keywords.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

Name	Type	Required	Description
`cursor`	integer	No	Pagination cursor (0 for first request)
`keyword`	string	No	Search keyword, e.g., "game"
`backtrace`	string	No	Backtrace for pagination, obtained from the last response
`search_id`	string	No	Search ID for pagination
`sort_type`	string	No	Sorting method
`content_type`	string	No	Content type filter
`publish_time`	string	No	Publish time filter
`filter_duration`	string	No	Video duration filter

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "business_data": [
    {
      "card_id": "douyin.doctype_aweme_hashtag",
      "data_id": "0",
      "type": 2
    }
  ]
}

Notes

Set cursor to 0 for the initial search request.
Pass search_id and backtrace from the previous response to retrieve the next page of results.

Related APIs

Douyin Challenge Search: Returns Douyin challenge and hashtag search results matching a query.
Douyin Hashtag Suggestions: Returns a list of suggested Douyin hashtags and challenges matching a query keyword, including challenge IDs and view counts.
Douyin Discussion Search: Returns discussion and question-and-answer search results from Douyin.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v2

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "cursor": 0,
  "keyword": "猫咪",
  "backtrace": "",
  "search_id": "",
  "sort_type": "0",
  "content_type": "0",
  "publish_time": "0",
  "filter_duration": "0"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Douyin Hashtag Challenge Search (V2)This API `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Challenge Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Hashtag Suggestions `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Discussion Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Experience Content Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin General Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026

Questions

FAQ

How do I use the Douyin Hashtag Challenge Search (V2) API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v2 with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Douyin Hashtag Challenge Search (V2) API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Douyin Hashtag Challenge Search (V2) API accept?

No parameters are required. Optional: backtrace (string), content_type (string), cursor (integer), filter_duration (string), keyword (string) and publish_time (string) and 2 more. The Parameters table and the Playground on this page list every field.

What does the Douyin Hashtag Challenge Search (V2) API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Douyin developer account or API key?

No. Douyin Hashtag Challenge Search (V2) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.