Douyin Music Search

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

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

Returns music search results from Douyin based on keywords and filters such as sort type, content type, and duration.

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 background music"

Publish Time(string)

Publish time filter

Search Id(string)

Search ID for pagination

Sort Type(string)

Sorting method

OutputExample

Responseoutputs · 202.8 KB · 3,164 lines

[
  {
    "data": {
      "ad_info": {},
      "cursor": 10,
      "extra": {
        "fatal_item_ids": [],
        "logid": "202608201746586EB121083447BAD02630",
        "now": 1787219219000,
        "scenes": null,
        "search_request_id": ""
      },
      "global_doodle_config": {
        "keyword": "猫咪"
      },
      "has_more": 1,
      "log_pb": {
        "impr_id": "202608201746586EB121083447BAD02630",
        "stab_extra": {
          "traffic_identification": "normal"
        }
      },
      "music": [
        {
          "album": "",
          "artist_user_infos": null,
          "artists": [],
          "audition_duration": 19,
          "author": "宋智敏",
          "author_deleted": false,
          "author_position": null,
          "binded_challenge_id": 0,
          "can_background_play": true,
          "collect_stat": 0,
          "cover_color_hsv": {
            "h": 35,
            "s": 11,
            "v": 88
          },
          "cover_hd": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm",
            "url_list": [
              "https://p3.douyinpic.com/aweme/1080x1080/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg",
              "https://p26.douyinpic.com/aweme/1080x1080/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg"
            ],
            "width": 720
          },
          "cover_large": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm",
            "url_list": [
              "https://p3.douyinpic.com/aweme/720x720/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg",
              "https://p26.douyinpic.com/aweme/720x720/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg"
            ],
            "width": 720
          },
          "cover_medium": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm",
            "url_list": [
              "https://p3.douyinpic.com/aweme/200x200/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg",
              "https://p26.douyinpic.com/aweme/200x200/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg"
            ],
            "width": 720
          },
          "cover_thumb": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm",
            "url_list": [
              "https://p3.douyinpic.com/aweme/100x100/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg",
              "https://p26.douyinpic.com/aweme/100x100/tos-cn-v-2774c002/oUAbhexQCElZ2nNQImHANpAIFTDtvkSNgABeIm.jpeg"
            ],
            "width": 720
          },
          "dmv_auto_show": false,
          "dsp_status": 10,
          "duration": 19,
          "end_time": 0,
          "external_song_info": [],
          "extra": "{\"dsp_switch\":0,\"has_edited\":0,\"reviewed\":0,\"music_tagging\":{\"Languages\":[\"non_vocal\"],\"Moods\":[\"Happy\",\"Cute\"],\"Genres\":null,\"Themes\":[\"Spring\",\"Summer\"],\"AEDs\":[\"non_vocal\"],\"SingingVersions\":[\"Seed\"],\"Instruments\":null},\"is_subsidy_exp\":false,\"aggregate_exempt_conf\":[],\"peak\":\"1.0618203\",\"cover_colors\":{\"rgb\":[225,215,201]},\"aigc_clip\":false,\"with_aed_model\":0,\"loudness\":\"-11.1920185\",\"review_unshelve_reason\":0,\"beats\":{\"energy_trace\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oUZBAeAcAc3bAbLfDlTzCbCsHAEtEAhpnLsDDg\",\"merged_beats\":\"https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/o4AEQhBAsghEyBstsADlAlD7btszWAfbmsdgTP\",\"audio_effect_onset\":\"https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oYlAEsjtCnDdegAAtsMBbeDSAADX3EmkZLLGSA\",\"beats_tracker\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/ooIZIAAAZYTLC4nl7eBJbZlBwATt3DAgDyLGBf\"},\"music_label_id\":1112,\"long_pic_video_usable\":true,\"image_beats_url\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/ooIZIAAAZYTLC4nl7eBJbZlBwATt3DAgDyLGBf\",\"douyin_beats_info\":{},\"schedule_search_time\":0,\"hotsoon_review_time\":-1,\"is_red\":0,\"is_aed_music\":0}",
          "id": 7259250675263719000,
          "id_str": "7259250675263719484",
          "is_audio_url_with_cookie": false,
          "is_commerce_music": false,
          "is_del_video": false,
          "is_matched_metadata": false,
          "is_original": false,
          "is_original_sound": false,
          "is_pgc": true,
          "is_restricted": false,
          "is_video_self_see": false,
          "luna_info": {
            "has_copyright": false,
            "is_luna_user": false
          },
          "lyric_short_position": null,
          "mid": "7259250675263719484",
          "music_chart_ranks": null,
          "music_collect_count": 0,
          "music_cover_atmosphere_color_value": "",
          "music_image_beats": {
            "music_image_beats_url": {
              "height": 720,
              "uri": "tos-cn-v-2774c002/ooIZIAAAZYTLC4nl7eBJbZlBwATt3DAgDyLGBf",
              "url_list": [
                "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/ooIZIAAAZYTLC4nl7eBJbZlBwATt3DAgDyLGBf"
              ],
              "width": 720
            }
          },
          "music_status": 1,
          "musician_user_infos": null,
          "mute_share": false,
          "offline_desc": "",
          "owner_handle": "",
          "owner_nickname": "",
          "pgc_music_type": 1,
          "play_url": {
            "height": 720,
            "uri": "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/osCmvsaZLQ49tG4ADkhgHunf8lbJCB6wtYUeIy",
            "url_key": "7259250675263719484",
            "url_list": [
              "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/osCmvsaZLQ49tG4ADkhgHunf8lbJCB6wtYUeIy",
              "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/osCmvsaZLQ49tG4ADkhgHunf8lbJCB6wtYUeIy"
            ],
            "width": 720
          },
          "position": null,
          "prevent_download": false,
          "prevent_item_download_status": 0,
          "preview_end_time": 0,
          "preview_start_time": 0,
          "reason_type": 0,
          "redirect": false,
          "schema_url": "",
          "search_impr": {
            "entity_id": "7259250675263719484"
          },
          "shoot_duration": 19,
          "show_origin_clip": false,
          "song": {
            "artists": [
              {
                "artist_name": "宋智敏",
                "uid": "0"
              }
            ],
            "chorus": {
              "duration_ms": 19644,
              "start_ms": 0
            },
            "chorus_v3_infos": null,
            "id": 7259250675263703000,
            "id_str": "7259250675263703100",
            "title": "我养的可爱猫咪 "
          },
          "source_platform": 25,
          "start_time": 0,
          "status": 1,
          "strong_beat_url": {
            "height": 720,
            "uri": "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oEsNtAKEZDifHMDeIgAiuEAyECSnazD3xLwAFB",
            "url_list": [
              "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oEsNtAKEZDifHMDeIgAiuEAyECSnazD3xLwAFB",
              "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oEsNtAKEZDifHMDeIgAiuEAyECSnazD3xLwAFB"
            ],
            "width": 720
          },
          "tag_list": [],
          "talent_hashtag_name_list": null,
          "title": "我养的可爱猫咪 ",
          "unshelve_countries": null,
          "user_count": 149076,
          "video_duration": 6000
        },
        {
          "album": "搞怪猫咪跳",
          "artist_user_infos": null,
          "artists": [],
          "audition_duration": 59,
          "author": "黄锦城",
          "author_deleted": false,
          "author_position": null,
          "binded_challenge_id": 0,
          "can_background_play": true,
          "collect_stat": 0,
          "cover_color_hsv": {
            "h": 32,
            "s": 27,
            "v": 46
          },
          "cover_hd": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS",
            "url_list": [
              "https://p3.douyinpic.com/aweme/1080x1080/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg",
              "https://p26.douyinpic.com/aweme/1080x1080/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg"
            ],
            "width": 720
          },
          "cover_large": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS",
            "url_list": [
              "https://p3.douyinpic.com/aweme/720x720/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg",
              "https://p26.douyinpic.com/aweme/720x720/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg"
            ],
            "width": 720
          },
          "cover_medium": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS",
            "url_list": [
              "https://p3.douyinpic.com/aweme/200x200/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg",
              "https://p26.douyinpic.com/aweme/200x200/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg"
            ],
            "width": 720
          },
          "cover_thumb": {
            "height": 720,
            "uri": "tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS",
            "url_list": [
              "https://p3.douyinpic.com/aweme/100x100/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg",
              "https://p26.douyinpic.com/aweme/100x100/tos-cn-v-2774c002/o4MgAGARQC7EMQQYa8zYaNKBeDecDAW9AfFAXS.jpeg"
            ],
            "width": 720
          },
          "dmv_auto_show": false,
          "dsp_status": 10,
          "duration": 59,
          "end_time": 0,
          "external_song_info": [],
          "extra": "{\"review_unshelve_reason\":0,\"is_aed_music\":0,\"peak\":\"1.0480095\",\"dsp_switch\":0,\"has_edited\":0,\"schedule_search_time\":0,\"loudness\":\"-12.240083\",\"beats\":{\"audio_effect_onset\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/o8AEtABhEFC9dCAgEZiDCHe9lvWAtrpK0AMfB0\",\"beats_tracker\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/ocBAKiZj2h70BW9AsfdASdW2QhiPgAAEz0NtEy\",\"energy_trace\":\"https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/o4oUZpA4CAbEttMFACIAhptfHNegEFIDAnDBsl\",\"merged_beats\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oMAflFtzCouZeDlRIUtAH0AzAWEtCpGCgABUIm\"},\"douyin_beats_info\":{},\"cover_colors\":{\"rgb\":[117,102,85]},\"reviewed\":0,\"image_beats_url\":\"https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/ocBAKiZj2h70BW9AsfdASdW2QhiPgAAEz0NtEy\",\"is_red\":0,\"is_subsidy_exp\":false,\"aigc_clip\":false,\"music_label_id\":6322,\"aggregate_exempt_conf\":[],\"with_aed_model\":0,\"hotsoon_review_time\":-1,\"music_tagging\":{\"Languages\":[\"non_vocal\"],\"Moods\":[\"Funny\",\"Happy\",\"Cute\"],\"Genres\":null,\"Themes\":[\"Food\"],\"AEDs\":[\"non_vocal\"],\"SingingVersions\":[\"Seed\"],\"Instruments\":null},\"long_pic_video_usable\":true}",
          "id": 7568318771121097000,
          "id_str": "7568318771121096731",
          "is_audio_url_with_cookie": false,
          "is_commerce_music": false,
          "is_del_video": false,
          "is_matched_metadata": false,
          "is_original": false,
          "is_original_sound": false,
          "is_pgc": true,
          "is_restricted": false,
          "is_video_self_see": false,
          "luna_info": {
            "has_copyright": false,
            "is_luna_user": false
          },
          "lyric_short_position": null,
          "mid": "7568318771121096731",
          "music_chart_ranks": null,
          "music_collect_count": 0,
          "music_cover_atmosphere_color_value": "",
          "music_image_beats": {
            "music_image_beats_url": {
              "height": 720,
              "uri": "tos-cn-v-2774c002/ocBAKiZj2h70BW9AsfdASdW2QhiPgAAEz0NtEy",
              "url_list": [
                "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/ocBAKiZj2h70BW9AsfdASdW2QhiPgAAEz0NtEy"
              ],
              "width": 720
            }
          },
          "music_status": 1,
          "musician_user_infos": null,
          "mute_share": false,
          "offline_desc": "",
          "owner_handle": "",
          "owner_nickname": "",
          "pgc_music_type": 1,
          "play_url": {
            "height": 720,
            "uri": "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/owIArEMaTEWgQIiIumvxSvNIIOi5RBLwgHQwk",
            "url_key": "7568318771121096731",
            "url_list": [
              "https://sf6-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/owIArEMaTEWgQIiIumvxSvNIIOi5RBLwgHQwk",
              "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-ve-2774/owIArEMaTEWgQIiIumvxSvNIIOi5RBLwgHQwk"
            ],
            "width": 720
          },
          "position": null,
          "prevent_download": false,
          "prevent_item_download_status": 0,
          "preview_end_time": 0,
          "preview_start_time": 0,
          "reason_type": 0,
          "redirect": false,
          "schema_url": "",
          "search_impr": {
            "entity_id": "7568318771121096731"
          },
          "shoot_duration": 59,
          "show_origin_clip": false,
          "song": {
            "artists": [
              {
                "artist_name": "黄锦城",
                "uid": "0"
              }

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/music-search
Authentication: Bearer API key

API README

Douyin Music Search API

Look up music tracks on Douyin by passing a keyword along with optional filter and pagination parameters.

Use cases

Discover trending songs and audio tracks on Douyin using keywords.
Filter music results by sorting method, content type, or track duration.
Retrieve music IDs, author details, and lyric URLs for identified tracks.

Request

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

{
  "music": [
    {
      "audition_duration": 38,
      "author": "华Fit",
      "author_deleted": false,
      "binded_challenge_id": 0,
      "dsp_status": 10,
      "duration": 38,
      "end_time": 0,
      "id": 7692065182327736355,
      "lyric_type": 10,
      "lyric_url": "https://sf3-cdn-tos.douyinstatic.com/obj/tos-cn-v-2774c002/oMAMAfPXDAFqFAPtYfEt7…",
      "search_impr": {
        "entity_id": "7692065182327736355"
      },
      "song": {
        "id": 7692065182327703587,
        "title": "我是快乐小猫咪"
      }
    }
  ]
}

Notes

Set cursor to 0 for the initial query, then pass subsequent pagination tokens to continue.
Use backtrace and search_id from the previous response to paginate through deeper results.

Related APIs

Douyin Challenge Search: Returns Douyin challenge and hashtag search results matching a query.
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.

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/music-search

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/music-search" \
  -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 Music SearchThis API `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Challenge Search `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

Questions

FAQ

How do I use the Douyin Music Search API?

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