tiktok-creative-center/
top-videos

The TikTok Creative Center Top Videos API pulls Creative Center's top video charts by country, ranked by views, engagement rate or six-second view rate, with organic views and creator Marketplace IDs.

TikTok Creative Center Top Videos API

Country charts
Daily, weekly or long-term
Views and engagement rates
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

TikTok Creative Center Top Videos

Creative Center's top videos are TikTok's published charts of the best-performing videos in a country, ranked by views, engagement rate or six-second view rate and showing each video's caption, creator, views in the chart period, lifetime views and organic views. The charts reveal which videos are winning attention in a market, how much of their reach is organic and which creators keep landing on them.

TikTok Creative Center Top Videos API Features

  • Daily, weekly and long-term chartsperiod selects which chart of a country to read, and the newest published edition is used automatically.
  • Three ranking metricssort_by orders the TikTok Creative Center Top Videos API chart by views, engagement_rate or six_second_view_rate.
  • Reach split three waysmetrics separates views_count in the chart period, organic_views_count and lifetime_views_count, next to the two rates.
  • Video and creator identityEach row has the caption, url, cover_url and author, plus creator_id, the Creator Marketplace ID that TikTok Creator Marketplace accepts.

TikTok Creative Center Top Videos API Parameters

ParametersRequiredDescription
countryOptionalTwo-letter country code of the market, such as US, GB or JP. Defaults to US.
periodOptionalChart to read: daily (default), weekly or long_term.
sort_byOptionalRanking metric: views (default), engagement_rate or six_second_view_rate.
results_limitOptionalHow many videos to return, from 1 to 100. Defaults to 20.

How to Use the TikTok Creative Center Top Videos API

Choose a country, period and metric, then read the chart from the TikTok Creative Center Top Videos API.

  1. POST {"country": "US", "period": "daily", "results_limit": 20} to /v1/tiktok-creative-center/top-videos.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read videos from results.items in rank order and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","period":"daily","sort_by":"views","results_limit":20}'

# creator_id on each item feeds TikTok Creator Marketplace.

TikTok Creative Center Top Videos API Use Cases

  • Hook benchmarking: Rank a country's chart by six_second_view_rate and review the leaders' captions and covers to catalogue the openings that keep viewers past six seconds.
  • Organic versus paid reach: Divide organic_views_count by views_count for each row to separate videos that grew on their own from those carried mostly by paid distribution.
  • Weekly market snapshots: Store each weekly chart from the TikTok Creative Center Top Videos API per country and compare rows by id to see which videos and creators recur and which formats rotate out.
  • Creator shortlists: Collect the creator_id values from chart rows and send them, deduplicated, to Creator Marketplace for audience and rate details.

TikTok Creative Center Top Videos API Pro Tips

  • Read the engagement_rate and six_second_view_rate values in TikTok Creative Center Top Videos API rows as fractions: 0.0265 means 2.65 percent, not 2.65.
  • rank is the position under the chosen sort_by, so compare ranks only between runs that share country, period and sort_by.
  • A creator can fill several rows, so collapse repeated creator_id values before passing them on; Creator Marketplace takes at most 20 IDs per request.

Beyond the TikTok Creative Center Top Videos API, use these APIs when you need a different type of public TikTok Creative Center data.

Explore other platforms

Combine TikTok Creative Center data with public data from other supported social platforms.

TikTok Creative Center Top Videos API — FAQ

TikTok Creative Center Top Videos API is a programmatic interface for retrieving TikTok Creative Center's charts of top-performing videos by country, period and ranking metric. It returns each video's rank, caption, creator, chart-period, organic and lifetime views, engagement rate and six-second view rate.

views orders by reach in the chart period. engagement_rate orders by engagements divided by views, which favors videos that prompt reactions, and six_second_view_rate orders by the share of views that lasted at least six seconds, which points to videos with strong openings.

It is the newest published edition, which is usually about two days behind the current date. Weekly charts end on a Sunday.

Both kinds of reach are counted. views_count is every view in the chart period and organic_views_count the part from non-paid distribution, so a row where the second is far smaller than the first was mostly promoted.

author.id is the creator's TikTok user ID. creator_id is their Creator Marketplace ID, the value TikTok Creator Marketplace accepts.

views_count covers only the chart period, so a video published months earlier can rank while people are still watching it. lifetime_views_count shows its total since publishing.

Not every market has a chart for every period. The task still succeeds with zero results and no charge, so you can try another period or country at no cost; the TikTok Creative Center Top Videos API charges 0.5 credits for each row of a chart that does exist.