tiktok-creative-center/
ad-analysis

The TikTok Creative Center Ad Analysis API breaks down one Creative Center top ad by ad ID: its details, impressions percentile, delivery countries and second-by-second click-through and retention curves.

TikTok Creative Center Ad Analysis API

Ad ID input
Retention curve
Click-through curve
1 credit / request
Ready
Ready

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

README

By SocQ · Updated

TikTok Creative Center Ad Analysis

TikTok Creative Center's ad analysis follows a top ad second by second, charting how strongly viewers click at each moment and what share is still watching, beside the ad's caption, objective, delivery countries, click-through rate and where its impressions rank among comparable ads. Read against the video, the curves show how long the opening holds viewers, when they leave and which moment prompts the click.

TikTok Creative Center Ad Analysis API Features

  • Retention by secondretention_curve lists the share of viewers still watching at each second, counted from second 0.
  • Click strength by secondclick_through_curve gives each second's relative click-through strength on a 0 to 1 scale, which marks the moments that drive action.
  • Where the impressions rankimpressions_percentile places the ad's impressions among comparable ads, from 0 to 1.
  • The ad record behind the curvesThe same result carries the caption, industry, objective, ctr, likes, countries, landing_page_url and video, so the curves can be read against the ad itself.

TikTok Creative Center Ad Analysis API Parameters

ParametersRequiredDescription
ad_idRequiredAd ID from a TikTok Creative Center Top Ads result.

How to Use the TikTok Creative Center Ad Analysis API

Take an ad ID from Top Ads and read its analysis from the TikTok Creative Center Ad Analysis API.

  1. Collect ads with TikTok Creative Center Top Ads and copy an id.
  2. POST {"ad_id": "7697084527089729557"} to /v1/tiktok-creative-center/ad-analysis.
  3. Poll GET /v1/tasks/{task_id} until status is succeeded and read the single record in results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_id":"7697084527089729557"}'

# retention_curve and click_through_curve list {second, value} points.

TikTok Creative Center Ad Analysis API Use Cases

  • Measuring how fast viewers leave a top ad: Read retention_curve over the opening seconds to see how many viewers survive the hook, then compare that across ads in one category.
  • Timing the call to action: Find the second where click_through_curve peaks in a TikTok Creative Center Ad Analysis API result and check which line, product shot or offer is on screen at that moment.
  • Checking an ad's reach before borrowing its angle: Use countries and impressions_percentile to see where an ad ran and how widely it was delivered before copying its approach for another market.

TikTok Creative Center Ad Analysis API Pro Tips

  • click_through_curve is a relative 0-to-1 score, so compare when clicks peak across ads, not how tall the peak is.
  • Compare retention at the same second across ads of similar duration_seconds instead of averaging whole curves of different lengths.
  • Run the TikTok Creative Center Ad Analysis API on a shortlist rather than every ad, and do not build on landing_page_url or advertiser, which are null in the documented sample.

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

TikTok Creative Center Ad Analysis API is a programmatic interface for analyzing one TikTok Creative Center top ad from its ad ID. It returns the ad's details, an impressions percentile, delivery countries and second-by-second click-through and retention curves.

Take the id of a result from TikTok Creative Center Top Ads. Ads outside Top Ads and ordinary TikTok videos have no ID that works here.

Each point is a second counted from 0 with a value from 0 to 1: the share of viewers still watching in retention_curve, relative click-through strength in click_through_curve. In the documented sample retention falls to 0.35 by second 1 and clicks peak at second 3.

Yes, for any ad that appears in Top Ads, whoever runs it. TikTok's own ad reporting covers only the campaigns you run.

No single number holds: published rules of thumb vary widely and this endpoint sets none. Judge an ad against other top ads in its category at the same second.

An unknown ad_id fails the task and its credit is refunded; a successful TikTok Creative Center Ad Analysis API call costs 1 credit.