Social Fetch
Start for freeStart free
TikTok hub

TikTok Ad Library Ad API

Resolve one public Ad Library or Top Ads creative by ad id or detail URL — full ad detail in the same envelope as the rest of the TikTok tag.

GET /v1/tiktok/ad-library/ads

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/tiktok/ad-library/ads takes either adId or url (at least one required). On a found lookup you get data.lookupStatus of found and data.ad with summary fields (id, title, brandName, cost, ctr, likeCount, industryKey, objective, video) plus detail fields when TikTok exposes them: commentCount, shareCount, countries, landingPageUrl, keywords, objectives, patterns, source, hasVoiceOver, detailUrl, interactiveAnalysis, and relatedAds. Creative and review fields match search: format (video or images), videos, imageUrls for photo ads, category, advertiserBusinessId, moderation, and isUnavailable. A miss returns lookupStatus not_found with ad null — branch on that before you write rows. Bill from meta.creditsCharged.

This route is single-ad detail. To discover ads by Top Ads filters or advertiser name, use GET /v1/tiktok/ad-library/ads/search. Organic keyword video search is GET /v1/tiktok/search. Same API key for all of them.

TikTok Ad Library Ad API FAQ

What does the TikTok Ad Library Ad API return?

A lookup under data.lookupStatus (found or not_found) and data.ad when found. The ad object includes id, title, brandName, cost, ctr, likeCount, industryKey, objective, and video, plus detail fields such as countries, landingPageUrl, objectives, detailUrl, interactiveAnalysis, and relatedAds when available. It also reports the creative format (video or images), every video and image URL, the ad category, the advertiser business ID, TikTok's review status and whether the ad is still available. Each response uses the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I get one TikTok Ad Library ad by id or URL?

Send GET /v1/tiktok/ad-library/ads with x-api-key and either adId or url (at least one required). url accepts a public Ads Library or Top Ads detail link. Read data.lookupStatus, then data.ad. Full parameter rules and examples are in the API docs.

How much does TikTok Ad Library ad detail cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

Is this the same as TikTok Ad Library ads search?

No. GET /v1/tiktok/ad-library/ads returns one creative when you already have an ad id or detail URL. GET /v1/tiktok/ad-library/ads/search finds ads by Top Ads filters or advertiser name and paginates under data.ads.

What happens when the ad is missing or removed?

Successful HTTP 200 responses can still be not_found: data.lookupStatus is not_found and data.ad is null. Treat that as a real miss, not as an empty found object.

Can I pass a Top Ads Creative Center URL instead of an ad id?

Yes. Pass the public detail URL as url, or extract the ad id and pass adId. Both Ads Library and Top Ads detail links are accepted when TikTok exposes them publicly.

Do I need a TikTok Ads Manager account to look up one ad?

No. You authenticate to Social Fetch with an API key. The route reads public Ad Library and Top Ads detail; it does not act on behalf of an ads account you manage.

Other TikTok endpoints