Get TikTok Ad Library ad
Get a single TikTok Ad Library or Top Ads creative by ad id or public ad URL.
Headers
Get your API keyAPI key (`sfk_...`)
TikTok Ad Library or Top Ads ad id.
min 1 chars · max 4096 chars
Public TikTok Ad Library or Top Ads detail URL for the ad.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the ad was found.
one of: found, not_found
Ad details when found; otherwise null.
Stable identifier for the ad.
min 1 chars
Ad title or caption when available.
Brand or advertiser name when available.
Relative cost signal when available.
Click-through rate when available.
Like count when available.
≥ 0
Industry key reported for the ad when available.
Campaign objective key when available.
Video creative when available.
Video id when available.
Video duration in seconds when available.
Cover image URL when available.
Video width in pixels when available.
≥ 0
Video height in pixels when available.
≥ 0
Playback URLs by resolution when available.
360p video URL when available.
480p video URL when available.
540p video URL when available.
720p video URL when available.
1080p video URL when available.
Comment count when available.
≥ 0
Share count when available.
≥ 0
Countries associated with the ad when available.
min 1 chars
Landing page URL when available.
Keywords associated with the ad when available.
min 1 chars
Campaign objectives reported for the ad.
Objective label when available.
Objective value when available.
Creative pattern labels when available.
min 1 chars
Reported ad source when available.
Whether the ad includes a voice-over when known.
Public TikTok ad detail URL when available.
Second-by-second interactive analysis when available.
Click-through retention analysis when available.
Metric name when available.
Second-by-second metric samples.
Second offset within the ad video.
≥ 0
Metric value at this second.
Analysis duration in seconds when available.
≥ 0
Highlighted second offsets for this metric.
≥ 0
Percentile ranking for this metric when available.
Conversion retention analysis when available.
Metric name when available.
Second-by-second metric samples.
Second offset within the ad video.
≥ 0
Metric value at this second.
Analysis duration in seconds when available.
≥ 0
Highlighted second offsets for this metric.
≥ 0
Percentile ranking for this metric when available.
Click count analysis when available.
Metric name when available.
Second-by-second metric samples.
Second offset within the ad video.
≥ 0
Metric value at this second.
Analysis duration in seconds when available.
≥ 0
Highlighted second offsets for this metric.
≥ 0
Percentile ranking for this metric when available.
Conversion count analysis when available.
Metric name when available.
Second-by-second metric samples.
Second offset within the ad video.
≥ 0
Metric value at this second.
Analysis duration in seconds when available.
≥ 0
Highlighted second offsets for this metric.
≥ 0
Percentile ranking for this metric when available.
Playback retention analysis when available.
Metric name when available.
Second-by-second metric samples.
Second offset within the ad video.
≥ 0
Metric value at this second.
Analysis duration in seconds when available.
≥ 0
Highlighted second offsets for this metric.
≥ 0
Percentile ranking for this metric when available.
Related ads recommended alongside this ad.
Stable identifier for the ad.
min 1 chars
Ad title or caption when available.
Brand or advertiser name when available.
Relative cost signal when available.
Click-through rate when available.
Like count when available.
≥ 0
Industry key reported for the ad when available.
Campaign objective key when available.
Video creative when available.
Video id when available.
Video duration in seconds when available.
Cover image URL when available.
Video width in pixels when available.
≥ 0
Video height in pixels when available.
≥ 0
Playback URLs by resolution when available.
360p video URL when available.
480p video URL when available.
540p video URL when available.
720p video URL when available.
1080p video URL when available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/tiktok/ad-library/ads?adId=7646829987799334920" \
-H "x-api-key: YOUR_API_KEY"Responses
TikTok Ad Library ad.