Douyin Challenge Search

Name: Douyin Challenge Search
Price: 0.015 USD
Availability: InStock
Author: Douyin

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

Returns Douyin challenge and hashtag search results matching a query. Supports filtering by date, content type, duration, and sorting method.

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., "food"

Publish Time(string)

Publish time filter

Search Id(string)

Search ID for pagination

Sort Type(string)

Sorting method

OutputExample

Responseoutputs · 253.6 KB · 6,191 lines

[
  {
    "data": {
      "ad_info": {},
      "challenge_list": [
        {
          "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": 1787219209,
              "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": "",
              "white_cover_url": null,
              "with_commerce_entry": false,
              "with_dou_entry": false,
              "with_fusion_shop_entry": false,
              "with_shop_entry": false,
              "youtube_channel_id": "",
              "youtube_channel_title": "",
              "youtube_expire_time": 0
            },
            "banner_list": null,
            "cha_attrs": null,
            "cha_name": "猫咪",
            "challenge_status": 1,
            "cid": "1562727459956738",
            "collect_stat": 0,
            "connect_music": [],
            "desc": "",
            "extra_attr": {
              "is_live": false
            },
            "from_ugc_hashtag_bank": "0",
            "hashtag_album_cell_camera_icon": "https://lf3-static.bytednsdoc.com/obj/eden-cn/kndeh7nuvkuhbnbd/topic/photo_picker_page/dark_shoot_icon.png",
            "hashtag_profile": "https://p26-sign.douyinpic.com/obj/image-cut-tos/8d0440060cb54c1f2b2ad49d967d3d3f.jpg?lk3s=fc8b4eca&x-expires=1787238000&x-signature=2FZxFhdGGWeY0PkXLdbLnh0dDLM%3D&from=4236988106",
            "insert_template_category_list": null,
            "is_challenge": 0,
            "is_commerce": false,

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-v1
Authentication: Bearer API key

API README

Douyin Challenge Search API

Query Douyin hashtag and challenge listings by submitting a keyword. Paginate through results using cursor, search_id, and backtrace.

Use cases

Discover trending Douyin hashtags and challenge topics for topic research.
Look up challenge metadata including challenge status and profile image assets.
Filter hashtag query results by sorting criteria and duration.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v1" \
  -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., "food"
`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.

{
  "challenge_list": [
    {
      "challenge_info": {
        "cha_name": "宠物猫咪",
        "challenge_status": 1,
        "from_ugc_hashtag_bank": "1",
        "hashtag_profile": "https://p3-sign.douyinpic.com/obj/image-cut-tos/bfe0b2e5561077683b8dca38cf1f5e5b…",
        "publish_type": 1,
        "sub_type": 0
      }
    }
  ]
}

Notes

Set cursor to 0 for the first request and pass subsequent offsets for pagination.
Pass backtrace and search_id from the previous response when paginating through results.

Related APIs

Douyin Hashtag Challenge Search (V2): Returns Douyin hashtag and challenge search results matching a query keyword.
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-v1

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-v1" \
  -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 Challenge SearchThis API `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Hashtag Challenge Search (V2) `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 Challenge Search API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/search/challenge-search-v1 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 Challenge Search 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 Challenge Search 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 Challenge Search 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 Challenge Search 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.