tiktok-creative-center/
top-ads

The TikTok Creative Center Top Ads API pulls Creative Center's top-performing ads by keyword, a 7, 30 or 180 day window and sort order, with captions, CTR, likes, objective, industry and the ad video.

TikTok Creative Center Top Ads API

Top-performing ads
CTR per ad
Ad video files
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 Ads

TikTok Creative Center's Top Ads is a curated selection of ads that perform well on TikTok, each shown with its caption, industry, campaign objective, click-through rate, likes and video. Looking across them reveals which hooks, formats and offers keep winning in a category, so they serve creative research, competitor watching and ad briefs.

TikTok Creative Center Top Ads API Features

  • Creative Center's own top-ads listTikTok Creative Center Top Ads API results come from the ads Creative Center ranks as top performers, ordered by TikTok's relevance or by likes.
  • CTR, likes and campaign context per adEach ad carries ctr and likes, plus its industry and objective as Creative Center labels them.
  • The video, not just the numbersmedia returns the ad video URL with its thumbnail, width, height and duration, and text holds the caption.
  • Keyword, window and volume controlsquery narrows by keyword, time_range looks back 7, 30 or 180 days, and results_limit returns up to 300 ads per request.

TikTok Creative Center Top Ads API Parameters

ParametersRequiredDescription
queryOptionalOptional keyword to filter the ads by, such as a product category.
time_rangeOptionalHow far back to look: 7d, 30d (default) or 180d.
sort_byOptionalrelevance for TikTok's own order (default), or likes for the most-liked ads first.
results_limitOptionalHow many ads to return, from 1 to 300. Defaults to 20.

How to Use the TikTok Creative Center Top Ads API

Filter the top ads with the TikTok Creative Center Top Ads API and page through the results.

  1. POST {"query": "skincare", "time_range": "30d", "sort_by": "likes"} to /v1/tiktok-creative-center/top-ads.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read ads from results.items and pass results.next_cursor back while has_more is true.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'

# Each item's id can be sent to TikTok Creative Center Ad Analysis.

TikTok Creative Center Top Ads API Use Cases

  • Building a swipe file for a product category: Query a product keyword in the TikTok Creative Center Top Ads API and keep the captions, videos and duration_seconds of the leading ads as a reference set for designers and editors.
  • Telling fresh hooks from lasting ones: Run one keyword with 7d and with 180d: ads present in both windows are formats that keep working, while ads only in the short window are current experiments.
  • Shortlisting by CTR within an objective: Pull a large batch, group it by objective and rank each group by ctr to find the ads worth a closer look.
  • Labeling hooks and formats at scale: Feed captions, video files and durations into your own tagging pipeline to count which hook types and lengths dominate a category.

TikTok Creative Center Top Ads API Pro Tips

  • Compare ctr only among ads from the same result set and objective: its unit is not documented and the result carries no budget or offer data, so rank ads against each other rather than against a general TikTok CTR benchmark.
  • sort_by offers only relevance and likes, so request a larger results_limit and sort by ctr in your own code.
  • Read the fields defensively: industry and objective come back as Creative Center label codes such as campaign_objective_video_view, and advertiser and the comment, share and view counts in metrics are null in the documented sample.
  • Save each ad's id on every TikTok Creative Center Top Ads API run and dedupe on it, since the same ad can return under different queries and time windows.
  • Send only your shortlisted ids to TikTok Creative Center Ad Analysis, which costs 1 credit per ad and adds delivery countries and the per-second curves.

Beyond the TikTok Creative Center Top Ads 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 Ads API — FAQ

TikTok Creative Center Top Ads API is a programmatic interface for collecting the top-performing ads listed in TikTok Creative Center, filtered by keyword, time window and sort order. It returns each ad's caption, industry, objective, click-through rate, likes and video.

No. Top Ads is a curated list of strong performers shown with CTR and likes, while the TikTok Ad Library is a transparency archive of ads that ran, searched by advertiser or keyword, and gives no CTR.

No. Top Ads lists only ads whose advertisers authorized Creative Center to show them, so it is a sample of top performers, not a complete record. Use the TikTok Ad Library endpoints for advertiser-level lookups.

Not with the TikTok Creative Center Top Ads API, which filters by keyword and time_range. Industry and objective come back on each ad, so filter on them after the request, and read an ad's delivery countries from TikTok Creative Center Ad Analysis.

sort_by accepts relevance or likes only. Request up to 300 ads and sort on the returned ctr yourself.

The TikTok Creative Center Top Ads API charges 0.5 credits for each ad returned, so 300 ads cost 150 credits. A request that returns no ads is not charged.

Each ad's media entry includes the video URL, thumbnail, size and duration, so you can fetch the file. The videos belong to their advertisers, so use them for research and reference rather than republishing.