TikTok Ad library search API
Search TikTok's public Ads Library by keyword or advertiser (advertiser, title, audience band, run dates, library link, and video).
$0.80/1k req, pay per request, no subscription.
{"adId": "7648493525660270600","adTitle": "Spotify Premium: 3 months free","brandName": "Spotify","estimatedAudience": "500K-1M","firstShownUtc": 1758067200,"lastShownUtc": 1758931200,"url": "https://library.tiktok.com/ads/detail?ad_id=7648493525660270600®ion=DE","videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4",... 3 more fields}
Pricing and providers
TikTok Ad library search API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get TikTok ad library search in one request
This sample shows 17 of 18 fields. See every field
{
"found": true,
"data": {
"nextCursor": "eyJvZmZzZXQiOjIwfQ==",
"hasMore": true,
"total": 46,
"ads": [
{
"adId": "7648493525660270600",
"adTitle": "Spotify Premium: 3 months free",
"brandName": "Spotify",
"estimatedAudience": "500K-1M",
"firstShownUtc": 1758067200,
"lastShownUtc": 1758931200,
"url": "https://library.tiktok.com/ads/detail?ad_id=7648493525660270600®ion=DE",
"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4",
"coverUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-cover.jpeg",
"status": "active",
"format": "video"
},
{
"adId": "7648501298817568001",
"adTitle": "Discover Weekly, reimagined",
"brandName": "Spotify",
"estimatedAudience": "1M-2M",
"firstShownUtc": 1757548800,
"lastShownUtc": 1758758400,
"url": "https://library.tiktok.com/ads/detail?ad_id=7648501298817568001®ion=DE",
"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648501298817568001~tplv-ad-video.mp4",
"coverUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648501298817568001~tplv-ad-cover.jpeg",
"status": "active",
"format": "video"
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- advertiserNamestring
Advertiser name to list ads for (e.g. Spotify). Provide advertiserName or query, never both.
- cursorstring
Opaque cursor from a previous response's nextCursor. Omit it for the first page.
- querystring
spotify
Keyword to search ad titles and content (e.g. spotify). Provide query or advertiserName, never both.
- regionstring
DE
Two-letter region code for TikTok's Commercial Content Library, such as DE, FR, GB or IT. Each region holds a different set of ads. Omit it to take the library's own default region, DE. Coverage is the EU and EEA; a non-EU code such as US is not served.
Response
JSON, one example value per field.
Populated whenever the provider has data for the entity.
- adIdstring
7648493525660270600
TikTok ad id. Populated whenever the provider has data for the entity.
- adTitlestring
Spotify Premium: 3 months free
Ad title as shown in TikTok's ad library. Populated whenever the provider has data for the entity.
- brandNamestring
Spotify
Advertiser name on the ad.
- coverUrlstring
https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-cover.jpeg
Cover image URL of the ad's first video. Populated whenever the provider has data for the entity.
- estimatedAudiencestring
500K-1M
Audience size band TikTok publishes for the ad, for example "100K-200K".
- firstShownUtcinteger
1758067200
UTC epoch timestamp in seconds (Unix time) when TikTok first showed the ad. Multiply by 1000 for a JS Date in milliseconds.
- formatstring
video
TikTok's creative format code for the ad, as the ad library reports it.
- lastShownUtcinteger
1758931200
UTC epoch timestamp in seconds (Unix time) when TikTok last showed the ad. Multiply by 1000 for a JS Date in milliseconds.
- statusstring
active
TikTok's audit status code for the ad, as the ad library reports it.
- urlstring
https://library.tiktok.com/ads/detail?ad_id=7648493525660270600®ion=DE
Link to the ad's detail page in TikTok's public Ads Library.
- videoUrlstring
https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4
Playable URL of the ad's first video. Populated whenever the provider has data for the entity.
- hasMoreboolean
true
- nextCursorstring
eyJvZmZzZXQiOjIwfQ==
Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.
- totalinteger
46
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the TikTok Ad library search API
The AnyAPI TikTok Ad library search API returns TikTok ad library search data as normalized JSON from one POST call to /v1/run/tiktok.ad_library_search. Search TikTok's public Ads Library by keyword or advertiser (advertiser, title, audience band, run dates, library link, and video). AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $0.80 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 96.3% of TikTok ad library search calls through AnyAPI succeeded, with a median response time of 2.4 seconds across 4,118 measured calls.