Public Ads API
Get API key
Last updated 21 October 2026View as Markdown

Commercial Content LibraryEEA, UK and SwitzerlandReachSandbox

TikTok Ad Library API

Search TikTok’s Commercial Content Library from your own software. Send a keyword or an advertiser’s exact name and get up to 36 ads a page as JSON, with the video, dates and reach.

Read the quickstart
  • Sandbox key straight away
  • 100 credits a month free
  • No card

GET /v1/tiktok/ads?q=pottery&country=GB

authorization: Bearer $PADS_API_KEY

Sandbox sample video, no media
TikTokVideo

Fabrikam Studio

Glaze your own mug this weekend

Book now
Shown
20 Aug 2026 to 16 Oct 2026
Reach
1K to 10K
Where
Tiktok
Regions
GB
tiktok_7400000000000000001In the library
A sandbox ad from a made-up advertiser
Up to 36 ads a page1 credit a page with adsEmpty pages freeSandbox instantLive status →

What you can search

Search the TikTok Commercial Content Library

GET /v1/tiktok/ads takes one of two subjects and the filters this library has. A filter it doesn’t have is refused by name, so nothing is silently ignored.

A keyword

q matches the ad and the advertiser’s name, and creators’ posts about a brand.

One advertiser

advertiser takes its exact name, as TikTok shows it (TikTok can’t search by business id). Not yet confirmed against the live library; if it brings nothing back, search the name as a keyword.

  • q
    Values
    A keyword. It also matches creators’ posts about a brand.
    Default
    One subject is required
  • advertiser
    Values
    The advertiser’s exact name, as TikTok shows it (a result’s advertiser.name).
    Default
    One subject is required
  • country
    Values
    An EEA country, GB or CH
    Default
    GB
  • sort
    Values
    last_shown, first_shown
    Default
    last_shown
  • date_from
    Values
    YYYY-MM-DD
    Default
    12 months ago
  • date_to
    Values
    YYYY-MM-DD
    Default
    Today
  • cursor
    Values
    next_cursor from the last page, with the same parameters
    Default
    First page

One ad

What one ad’s detail adds

GET /v1/ads/{id} returns the ad with everything the TikTok Commercial Content Library shows about it, in one call, for 1 credit.

  • Unique users reached in each country, and by age and gender.
  • Whether audience, interest, creator and video targeting were used.
  • The advertiser’s registered country, and who paid.
  • The landing page and the ad’s category.

GET https://api.publicadsapi.com/v1/ads/tiktok_7400000000000000001

Where the library is thin

TikTok’s library has no US ads at all. It covers ads shown in the EEA, the UK and Switzerland, so country takes only those. A search needs a date window; without one we ask for the last 12 months.

ScrapeCreators, Adyntel and SearchAPI also search TikTok’s Commercial Content Library.

Sandbox

Every answer, before your first live search

Your sandbox key comes the moment you sign up. Any search returns sample ads from made-up advertisers in the live shape, and these searches return what a live one can. None of them uses a credit.

Read the quickstart

  • 200, no ads

    q=empty

    A search that finds nothing. An empty page uses no credits.

  • 503 UPSTREAM_BLOCKED

    q=blocked

    The platform refused every address we tried. Retry-After says when to try again.

  • 504 TIMEOUT

    q=timeout

    The platform didn’t answer in time. Retry, or narrow the search.

  • 502 UPSTREAM_CHANGED

    q=changed

    The platform’s page changed and we couldn’t read it. We are alerted.

1 credit

a page of ads, or one ad

Up to 36 ads a page. 100 credits a month free, no card.

$0.054

per 1,000 ads on Growth

With full pages: $49 a month for 25,000 credits.

$0

when there is nothing

Empty pages, blocks, timeouts and errors use no credits.

See pricing

Ask your AI about this API

It reads this page, then tells you if it fits, what it costs and what building it takes.

Ask ChatGPT about this(opens in a new tab)Ask Claude about this(opens in a new tab)

Questions

Before you build

Is there an official TikTok Ad Library API?

TikTok has no public API for its Commercial Content Library. Public Ads API reads the public library pages and returns each ad as JSON.

What does a TikTok search cost?

A page of up to 36 ads uses 1 credit, and so does one ad with all its detail. On Growth ($49 for 25,000 credits) that is about $0.054 per 1,000 ads with full pages. An empty page, a block, an error and every sandbox call use nothing. The free plan has 100 credits a month and needs no card.

Does it cover US ads?

No. TikTok’s library only holds ads shown in the EEA, the UK and Switzerland, so no API that reads it can return US ads.

What reach does TikTok give?

A search result carries TikTok’s audience range, such as 1,000 to 10,000. One ad’s detail adds unique users by country, age and gender.

Your first TikTok Ad Library search, in the next ten minutes

Sandbox key straight away. 100 credits a month free.

Read the quickstart