# TikTok Ad Library API

Look up TikTok advertisers, aggregate ad activity, and supported regions.

- Platform ID: `tiktok-adlibrary`
- Capabilities: 3
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [Get ads report](https://docs.upscrape.com/docs/platforms/tiktok-adlibrary/tiktok-adlibrary.ads.report.get)

- Capability ID: `tiktok-adlibrary.ads.report.get`
- Cost: 10 credits per request

Returns TikTok's aggregate ad publication report: country share and daily unique-ad counts, optionally filtered to one advertiser.
### [Search advertisers](https://docs.upscrape.com/docs/platforms/tiktok-adlibrary/tiktok-adlibrary.advertiser.search)

- Capability ID: `tiktok-adlibrary.advertiser.search`
- Cost: 10 credits per request

Resolves an advertiser name fragment to TikTok's exact registered advertiser names and business ids for advertiser-filtered capabilities.
### [List supported regions](https://docs.upscrape.com/docs/platforms/tiktok-adlibrary/tiktok-adlibrary.regions.list)

- Capability ID: `tiktok-adlibrary.regions.list`
- Cost: 10 credits per request

Lists the countries currently supported by TikTok's Commercial Content Library with their display names and region codes.

## Common uses

- Find exact public advertiser names and business IDs
- Compare aggregate publication counts by date and market
- Review the supported 33-region catalog
- Build source-scoped aggregate ad transparency reports

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).