Social Fetch
Get API key
TikTok hub

TikTok Ad Library Search API

Top Ads sweeps and advertiser-name Ads Library lookups over REST — structured ad rows in the same envelope as the rest of the TikTok tag.

GET /v1/tiktok/ad-library/ads/search

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Paid creative research on TikTok usually means clicking through Top Ads or the public Ads Library by hand. That works for a one-off competitor check; it breaks when you need recurring industry slices, region windows, or the same schema you already use for organic TikTok video rows.

`GET /v1/tiktok/ad-library/ads/search` returns matching ads in the shared Social Fetch envelope under `data.ads`. Leave `advertiserName` unset to search Top Ads: optional `query`, `region` (defaults to US), `period` (`7`, `30`, `180`), `orderBy`, `industry`, `objective`, `duration`, `likes`, `adFormat`, and `adLanguage` narrow the page. Set `advertiserName` to search the public Ads Library by advertiser instead. When `data.page.hasMore` is true, pass `data.page.nextCursor` as `cursor` on the next call. Bill from `meta.creditsCharged`.

This route is search. For one known ad id or Ads Library / Top Ads detail URL, use `GET /v1/tiktok/ad-library/ads`. Organic keyword video search is a different path: `GET /v1/tiktok/search`. Same API key for all of them.

TikTok Ad Library Search API FAQ

What does the TikTok Ad Library Search API return?

A page of matching ads under data.ads, the evaluated keyword under data.query, optional data.advertiserName when you searched by advertiser, and pagination under data.page (hasMore, nextCursor, totalResultsEstimate). Each response uses the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I call TikTok Ad Library ads search?

Send GET /v1/tiktok/ad-library/ads/search with x-api-key. For Top Ads, pass optional query plus filters such as region, period, orderBy, industry, objective, duration, likes, adFormat, and adLanguage. For public Ads Library search by advertiser, pass advertiserName. Paginate with cursor when data.page.hasMore is true. Full enums and examples are in the API docs.

How much does TikTok Ad Library ads search 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. Each paginated page is a separate billed request.

Is this the same as getting one TikTok Ad Library ad by id?

No. GET /v1/tiktok/ad-library/ads/search finds ads by Top Ads filters or advertiser name. GET /v1/tiktok/ad-library/ads returns a single ad when you already have an ad id or a public Ads Library / Top Ads detail URL.

What is the difference between Top Ads search and advertiserName?

Without advertiserName, the route searches TikTok Top Ads with keyword and performance filters. When advertiserName is set, results come from the public Ads Library for that advertiser instead of the Top Ads catalog.

How does pagination work on TikTok Ad Library search?

When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same filters across pages. Do not treat totalResultsEstimate as an exact count or as the only end-of-results signal.

Do I need a TikTok Ads Manager account to search Ad Library ads?

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

Other TikTok endpoints