Skip to main content
POST
TikTok Creative Center Ad Analysis API

TikTok Creative Center Ad Analysis

Take one top ad apart second by second. Alongside the ad’s details, the result traces how click-through interest and viewer retention change across the video, and shows where its impressions rank against comparable ads. Read the two curves together to locate the hook, the point where viewers drop off and the moment they act.
ad_id is required; use the id of a TikTok Creative Center Top Ads result. Returns one analysis, billed once.

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

ad_id is required; use an id from TikTok Creative Center Top Ads results. Returns one analysis with the ad's details, how its impressions rank among comparable ads, and second-by-second click-through and retention curves.

ad_id
string
required

Ad ID from TikTok Creative Center Top Ads results.

Pattern: ^\d{5,32}$
callback_url
string<uri>

Response

Task accepted

code
integer
data
object