# TikTok Ad Library API

Search TikTok's public Commercial Content Library for ads and advertisers.

- Platform ID: `tiktok-adlibrary`
- Capabilities: 2
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/tiktok-adlibrary/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [Search Ads](https://docs.upscrape.com/docs/platforms/tiktok-adlibrary/tiktok-adlibrary.ad.search) | `tiktok-adlibrary.ad.search` | 10 credits per request | Searches the TikTok Commercial Content Library by keyword. Returns raw ad payloads including creative, advertiser, run dates, targeted countries, and disclosed reach. Supports country and date-range filtering. |
| [List Advertiser Ads](https://docs.upscrape.com/docs/platforms/tiktok-adlibrary/tiktok-adlibrary.advertiser-ads.list) | `tiktok-adlibrary.advertiser-ads.list` | 10 credits per request | Lists every ad run by a specific TikTok advertiser, identified by its exact registered entity name (e.g. "NIKE Retail B.V."). Returns raw ad payloads with country and date-range filtering. |

## Common uses

- Monitor competitor creative campaigns
- Research advertiser activity by market
- Build ad transparency datasets

## 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).