Skip to main content
POST
TikTok Creative Center Top Videos API

TikTok Creative Center Top Videos

Pull TikTok’s chart of top-performing videos for a country, ranked by views, engagement rate or six-second view rate. Each entry carries the caption, the creator, views in the chart period, lifetime views and engagement metrics. When a creator stands out, pass their creator_id to TikTok Creator Marketplace for audience and rate details.
All fields are optional. country defaults to US, period picks the daily (default), weekly or long_term chart, and sort_by ranks by views (default), engagement_rate or six_second_view_rate. The latest published chart is used. results_limit defaults to 20 and accepts 1 to 100.

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

All fields are optional. Returns the latest published chart of top-performing TikTok videos in a country, with views, engagement rate and six-second view rate. results_limit defaults to 20 and accepts 1 to 100.

callback_url
string<uri>
country
string
default:US

Two-letter country code of the market, such as US, GB or JP.

Minimum string length: 1
Pattern: ^[A-Za-z]{2}$
period
enum<string>
default:daily

Chart to read: daily, weekly or long_term.

Available options:
daily,
long_term,
weekly
Minimum string length: 1
results_limit
integer
default:20
Required range: 1 <= x <= 100
sort_by
enum<string>
default:views

Ranking metric: views, engagement_rate or six_second_view_rate.

Available options:
engagement_rate,
six_second_view_rate,
views
Minimum string length: 1

Response

Task accepted

code
integer
data
object