Skip to main content
POST
TikTok Popular Songs API

TikTok Popular Songs

Choose the TikTok app Top 50 or Viral 50 songs chart. Submit an asynchronous task, then read its standard results.
Get the TikTok app Top 50 or Viral 50 songs chart. chart_type defaults to top; choose viral for Viral 50. results_limit defaults to 20 and accepts integers from 1 to 50. Optionally provide callback_url to receive a task completion notification.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Choose the TikTok App Top 50 (top, default) or Viral 50 (viral) music chart. results_limit defaults to 20 and accepts integers from 1 to 50.

callback_url
string<uri>
chart_type
enum<string>
default:top

TikTok App music chart: top for Top 50, viral for Viral 50.

Available options:
top,
viral
results_limit
integer
default:20
Required range: 1 <= x <= 50

Response

Task accepted

code
integer
data
object