Search TikTok Ad Library ads
Search the public TikTok Ads Library by keyword or advertiser name.
Headers
Get your API keyAPI key (`sfk_...`)
Keyword to search the public TikTok Ads Library.
max 4096 chars
Search the public TikTok Ads Library by advertiser name.
min 1 chars · max 4096 chars
TikTok advertiser business ID, from `advertiserMatches[].businessId` or an ad's `advertiserBusinessId`. Pins an advertiser search to that exact advertiser. Requires `advertiserName`.
pattern: ^\d{1,32}$
Opaque pagination cursor from a previous response.
min 1 chars
Endpoint-specific response payload.
Keyword query that was evaluated for this response.
Advertiser name filter that was evaluated, when searching by advertiser.
Advertiser TikTok resolved `advertiserName` to, when searching by advertiser and a match was found.
Advertisers TikTok matched to `advertiserName`. Empty for keyword searches or when none are reported.
Advertiser name as TikTok lists it.
min 1 chars
TikTok advertiser business ID. Pass it as `advertiserBusinessId`, with this `name` as `advertiserName`, to search only this advertiser.
min 1 chars
Listing source when reported. `tiktok_ads_library` is the public Ads Library.
one of: tiktok_ads_library, top_ads, null
Ads returned for the requested search. This array may be empty when no ads match.
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.
Public TikTok Ads Library detail URL when available.
ISO-8601 timestamp for when the ad was first shown, when available.
ISO-8601 timestamp for when the ad was last shown, when available.
Estimated audience band 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.
TikTok business ID of the ad's advertiser when available. Pass it as `advertiserBusinessId` with `advertiserName` to search only that advertiser.
Creative format: `video` for video ads, `images` for photo or carousel ads. Null when no creative is reported.
one of: video, images, null
Every video creative reported for the ad. `video` is the first entry. Empty for image ads.
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.
Image URLs for photo or carousel ads, in display order. Empty for video ads.
min 1 chars
Ad category as TikTok labels it, such as `News & Entertainment`, when available.
TikTok's review information for the ad.
Review status code exactly as TikTok reports it, such as `1`. TikTok does not document these codes. Null when not reported.
Rejection details as TikTok reports them, when the ad was rejected. Null otherwise.
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of ads can be requested.
Estimated total number of matching ads when available.
≥ 0
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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/tiktok/ad-library/ads/search?advertiserName=Nike" \
-H "x-api-key: YOUR_API_KEY"Responses
TikTok Ad Library search results.