Social Fetch
Get API key
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 per successful request.

Try in playgroundFull API docs

About this endpoint

Search results give you a list of TikTok ad ids. Detail work starts when you already have one: a Top Ads share link from Slack, an Ads Library URL from a competitor review, or an id saved from a previous search page. Pasting those into the public UI works once; it does not scale when you hydrate hundreds of creatives into a warehouse next to organic TikTok video rows.

`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. 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. 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