Skip to main content
GET
Search TikTok music

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer <key>. One key manages every profile on the account.

Query Parameters

profile_id
string
required

Id of the brand profile to act on. List them with GET /v1/profiles.

q
string
required

Words from the track title or artist, up to 80 characters. Accents may be left off, but đ is its own letter and does not match d; words match as fragments.

country_code
string

Two-letter country whose chart to read. Defaults to VN.

genre
string

Chart genre, e.g. POP or EASY_LISTENING. Defaults to ALL.

date_range
string

Chart window: 1DAY, 7DAY, 30DAY or 90DAY. Defaults to 7DAY.

limit
integer

Maximum tracks to return, 1–100.

Response

Success.

The response envelope is stable — a profile_id plus the payload — but its inner fields are not yet pinned down in this document.