TikTok Ad Details API
One TikTok Commercial Content Library ad by ID — calendar-day dates, always 2 credits.
Paste a TikTok Ad Library URL or ad ID and get that creative as clean JSON with the same uniform key set as /tiktok/search (null when withheld) plus calendar-day YYYY-MM-DD firstShown/lastShown (search omits those). platform=tiktok, library=dsa, media[] objects {url,type,expiresAt} — expiresAt is x-expires / VExpiration / expire= to the second, or null when the URL is unsigned (never midnight-of-fetch). impressions from Unique users seen when disclosed, spend only when shipped. advertiser is always {id,name,url,logo,location} — name is a human label, never a bare numeric id. Always 2 credits on success — native and fallback paths share one price (no 2-vs-5 surprise). Response includes fetchPath: "native" | "fallback" so you can see which path ran. Default country GB (EU-led library).
Request
- Base URL: https://api.captapi.com
- URL: https://api.captapi.com/v1/ad-library/tiktok/ad-details
- Auth: one of:
- HTTP bearer
- API key in header X-API-Key
Query parameters
TikTok Ad Library URL or numeric ad ID. Inputs with no extractable numeric ID are a definitive 400. An ID TikTok's library positively reports as nonexistent is a definitive 404 AD_NOT_FOUND (ads outside the EU/EEA+UK+CH never enter the library, and entries expire one year after last impression). The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.
Two-letter ISO country code. Default GB. Only EU/EEA + UK + CH are covered by TikTok's library; other codes return 400 UNSUPPORTED_REGION.
Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.
Response
Success. The data object for this endpoint.
Changes
No recorded changes to this operation across all 3 revisions of this API.