> Search TikTok’s Commercial Content Library by keyword or advertiser. Up to 36 ads a page as JSON, with reach by country, for EEA, UK and Swiss ads.

Web version: https://publicadsapi.com/tiktok-ad-library-api · Last updated: 2026-10-21

# 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](https://publicadsapi.com/docs/quickstart)

-   Sandbox key straight away
-   100 credits a month free
-   No card

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.

Parameters of GET /v1/tiktok/ads
| Parameter | Values | Default |
| --- | --- | --- |
| `q` | A keyword. It also matches creators’ posts about a brand. | One subject is required |
| `advertiser` | The advertiser’s exact name, as TikTok shows it (a result’s advertiser.name). | One subject is required |
| `country` | An EEA country, GB or CH | GB |
| `sort` | last\_shown, first\_shown | last\_shown |
| `date_from` | YYYY-MM-DD | 12 months ago |
| `date_to` | YYYY-MM-DD | Today |
| `cursor` | next\_cursor from the last page, with the same parameters | 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](https://publicadsapi.com/docs/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](https://publicadsapi.com/pricing)

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](https://publicadsapi.com/docs/quickstart)