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
| Parameters | Required | Description |
|---|---|---|
ad_id | Required | Ad 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.
- Collect ads with TikTok Creative Center Top Ads and copy an id.
- POST {"ad_id": "7697084527089729557"} to /v1/tiktok-creative-center/ad-analysis.
- 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.
Related APIs
Beyond the TikTok Creative Center Ad Analysis API, use these APIs when you need a different type of public TikTok Creative Center data.
- TikTok Creative Center Top Ads API — Browse top-performing ads by keyword and period, with captions, CTR, likes, and the ad video.
- TikTok Creative Center Trending Hashtags API — Get a country's trending hashtag ranking with post counts, views, and popularity curves.
- TikTok Creative Center Hashtag Insights API — Dig into one trending hashtag's popularity curve, top countries, and example videos.
- TikTok Creative Center Top Videos API — Get a country's chart of top-performing videos with views and engagement rates.
- TikTok Creator Marketplace API — Get Creator Marketplace cards with follower demographics, median views, and starting rates.