Sign in
Platform Integration

Search TikTok music

Search the Commercial Music Library by song title or artist. TikTok has no music search endpoint, so this searches the trending charts Upload-Post caches per genre/country/period, not TikTok's whole catalogue: a song that is not trending in the chart you query will not be found. Matching is case- and accent-insensitive and every word must match.

get/uploadposts/tiktok/music/search

Query parameters

profilestring required

Profile username. Must have a TikTok account connected.

qstring

Text matched against titles and artists. Omit it to get the chart in trending order.

genrestring

Commercial Music Library genre, e.g. ALL, POP, HIP_HOP/RAP, R&B/SOUL. The slashes and the ampersand are part of TikTok's enum. Unknown values fall back to ALL.

country_codestring

ISO-3166 alpha-2 country whose trending chart is read. The catalogue is per country, so this changes which tracks come back.

date_range'1DAY' | '7DAY' | '30DAY' | '90DAY'

Trending window.

limitinteger

Maximum tracks to return.

Response

Matching tracks, ranked by relevance.

successboolean
querystring
genrestring
country_codestring
date_rangestring
limitinteger
totalinteger

How many tracks matched before limit was applied.

Example response

{
  "success": true,
  "query": "bad bunny",
  "tracks": [
    {
      "id": "7205381234567890123",
      "title": "Summer Nights",
      "artist": "The Example Band",
      "duration": 32,
      "genres": [
        "POP"
      ]
    }
  ]
}

Changes

Changed in 1 of the 4 revisions of this API.1