Skip to main content
GET
Get Ad Details
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

ad_id
string
required

The TikTok Creative Center ad ID.

Example:

"7448078361224445953"

Response

Successful response containing ad details

Key Response Fields:

  • id: Unique ad ID
  • ad_title: Ad creative text/caption
  • brand_name: Brand name (if available)
  • like: Total likes
  • comment: Total comments
  • share: Total shares
  • ctr: Click-through rate
  • country_code: Countries where the ad ran
  • industry_key: Industry category identifier
  • objective_key: Primary campaign objective
  • objectives[]: All objectives with label and weight
  • landing_page: Ad destination URL
  • source: Ad source type
  • video_info.duration: Video length in seconds
  • video_info.cover: Video cover/thumbnail URL
  • video_info.video_url: Download URLs by quality (540p, 720p)
  • video_info.width: Video width in pixels
  • video_info.height: Video height in pixels
  • creative_center_url: Link to the ad on TikTok Creative Center
  • interactive_time_analysis: Second-by-second metrics for CTR, CVR, clicks, conversions, and retention
  • recommended_for_you: Related ads suggested by Creative Center