🆔 Ad id and ad page (adId, adDetailUrl) |
🏢 Advertiser and business id |
📝 Ad text (adTitle) |
| 📅 First and last shown dates |
⏱️ Days running |
👀 Unique users seen (estimatedAudience) |
| 🎬 Video, cover and images |
🔗 Landing URL and call to action |
🎯 Campaign objective |
| 🌍 Targeted countries, ages, genders |
📊 Reach by country × age × gender |
💳 Paid for by (adPaidForBy) |
| 👤 Advertiser's TikTok account and followers |
🚫 Removal and restriction notices |
📈 Creative Center CTR, likes, budget level |
| 🏭 Industry and objective names |
⏯️ Keyframe CTR, CVR and retention by second |
🤝 Creators' paid partnerships |
On two 100-ad Zalando runs with Ad Library details on, every row had dates, unique users seen, targeting, reach by country and payer; 87-88% had a call to action, 90-91% an objective, 93-97% a landing URL and 91-92% the advertiser's TikTok account.
### How to scrape the TikTok Ad Library with TikTok Ads Library Scraper
1. [Create a free Apify account](https://console.apify.com/sign-up) — the free plan includes monthly credit.
2. Open [TikTok Ads Library Scraper](https://apify.com/topapi/tiktok-ads-library-scraper) and click **Try for free**.
3. Pick the **Ad sources**, then type a keyword into **Search terms** or a brand into **Advertiser names**, and choose the **Ad Library countries**.
4. Set **Max ads** and switch on **Ad Library details** if you want targeting and reach.
5. Click **Start**. Rows stream into the dataset as they are found.
6. Open the **Storage** tab and **Export** as JSON, CSV or Excel — or save the input as a task and put it on a schedule.
### ⬇️ Input for TikTok Ads Library Scraper
| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `sources` | List | `library` (default), `creative_center`, `spotlight`, `other_commercial_content`. Any combination. |
| `searchTerms` | List | Keywords, e.g. `running shoes`. Put a term in quotes for an exact phrase. For creators' commercial content: creator usernames. For the Creative Center: matched on the ad caption. |
| `advertiserNames` | List | Brands as the Ad Library names them, e.g. `nike`, `Zalando`, looked up in TikTok's own advertiser search box. Pin any entity with `Name|advertiser id`. |
| `advertiserMatch` | Select | `contains` (default: every advertiser whose name starts with the term as a whole word, e.g. Nike Store and Nike, Inc. for `nike`, not NIKELAB LTD or TikTok handles like nike_shop) or `exact` (the name alone, legal form ignored). |
| `adIds` | List | Ad Library ad ids or Creative Center top ad ids. |
| `startUrls` | URLs | Ad Library search or ad URLs, other commercial content URLs, Creative Center top ad URLs. |
| **🎯 Ad Library filters** | | |
| `countries` | List | `all` (default) or any of the 33 countries the library covers. |
| `dateFrom` / `dateTo` | Date | Ads last shown in this window; absolute (`2026-01-31`) or relative (`12 months`). Default: since October 2022. |
| `timezone` | Text | IANA timezone for the dates. Default `UTC`. |
| `sortBy` | Select | Last shown, published date or unique users seen, either direction. Default: last shown, newest first. Advertiser searches follow it. Keyword searches are read one week at a time, newest week first, in TikTok's own order within each week. |
| `adType`, `adStatus`, `ages`, `adReach`, `gender` | Select | Format (video / image / text), active or inactive, target ages, unique-users bucket, target gender. |
| `occSortBy` | Select | Order of creators' commercial posts: posted date or views. |
| **🎯 Creative Center filters** | | |
| `ccCountries` | List | 28 Creative Center countries; empty = all regions. |
| `ccPeriod` | Select | Last 7, 30 (default) or 180 days. |
| `ccIndustries`, `ccObjectives`, `ccAdLanguages` | List | Industry, campaign objective, ad language. |
| `ccAdFormat`, `ccLikes`, `ccSortBy` | Select | Spark / non-Spark Ads, likes percentile, sort (For you, Reach, CTR, 2s and 6s view rate, CVR, Likes). |
| **✂️ Refine results** | | |
| `excludeKeywords` | List | Drop ads whose title, advertiser, brand or creator contains a word. |
| `minLikes` | Integer | Creative Center / Spotlight: minimum likes. |
| `includeRemovedAds` | Boolean | Ad Library ads TikTok removed carry no advertiser or creative. Default `false` (skipped). |
| **➕ Extra data** | | |
| `includeDetails` | Boolean | Ad Library targeting, reach by country × age × gender, landing URL, CTA, objective, payer, advertiser account — event **ad-details**. |
| `maxDetails` | Integer | Ad Library details on at most this many ads, from searches, ad ids and ad URLs alike; the rest come without them and are not charged **ad-details**. 0 = no limit. Top ad details are not counted. |
| `includeTopAdDetails` | Boolean | Creative Center landing page, objectives, comments, shares, countries, creative summary — event **top-ad-details**. |
| `keyframeMetrics` | List | `retain_ctr`, `retain_cvr`, `click_cnt`, `convert_cnt`, `play_retain_cnt` curves. Free. |
| **🔁 Monitoring** | | |
| `monitorMode`, `monitorStoreName` | Boolean, Text | Return only ads not delivered by earlier runs with the same store. |
| `monitorChanges` | Boolean | Also re-deliver known Ad Library ads whose last shown date or reach changed. |
| **📦 Output** | | |
| `maxResults` | Integer | Default `100`; `0` = no limit. |
| `maxResultsPerSearch` | Integer | Cap per search term, advertiser, URL or source. |
| `compact` | Boolean | Core fields only, for AI agents and MCP. An add-on you turn on keeps all its fields and `detailsFetched` on every row, so a compact row never drops a field it is charged for; requested keyframes are kept too. |
| **⚙️ Advanced** | | |
| `proxyConfiguration`, `maxConcurrency` | Proxy, Integer | Optional proxy; parallel sessions (default 4). |
#### Input JSON
```json
{
"advertiserNames": ["nike"],
"countries": ["FR"],
"dateFrom": "12 months",
"includeDetails": true,
"maxResults": 100
}
```
#### Search an advertiser by name, not by keyword
A keyword (`searchTerms`) matches the ad text, so `nike` also returns retailers that mention Nike. An advertiser (`advertiserNames`) is looked up in the advertiser search box of TikTok's Ad Library and returns those advertisers' ads only. That box matches the start of a name and shows 5 names at a time, so the actor asks again with longer prefixes (`nike `, `nike,`, `nike a` ...) until it has every advertiser whose name starts with the term as a whole word: in our tests `nike` found 7 (NIKE Retail B.V., NIKE COM SRL, Nike Store, Nike Factory Store, Nike Unite, Nike, Inc. and nike x solana), `zalando` 7 (Zalando SE among them) and `lidl` 33 (LIDL ITALIA SRL, Lidl Schweiz DL AG, LIDL STIFTUNG & CO KG and the other national entities), where the box alone shows 5. Not matched: names where the word runs on (NIKELAB LTD), TikTok handles (nike_shop) and names with the term further in (Air Nike), which the box never shows; pin any of those with `Name|advertiser id`. **Do:** `"advertiserNames": ["nike"]` · **Don't:** `"searchTerms": ["nike ads"]`.
#### Quote a phrase for an exact match
`running shoes` matches ads with either word ranked by relevance; `"running shoes"` (with the quotes) matches the exact phrase, the same as the Ad Library's own quoted search.
#### Pick the source before the filters
Countries (except Switzerland and the UK) and dates also apply to creators' commercial content, ordered by `occSortBy`; `adType`, `adStatus`, `ages`, `adReach`, `gender` and `sortBy` are Ad Library only. Creative Center filters start with `cc`. Both sources can run in one input.
### ⬆️ TikTok ads output
Every ad becomes one dataset item; `source` says which TikTok source it came from. Here is the table view of an advertiser run with Ad Library details on:
An Ad Library ad with details, as JSON (shortened):
```json
{
"source": "library",
"adId": "1878351002796241",
"adDetailUrl": "https://library.tiktok.com/ads/detail/?ad_id=1878351002796241",
"advertiserName": "Zalando Lounge c/o Zalando SE",
"adTitle": "E un nou sezon! Ia-ți îmbrăcăminte sport de la mărci de top ...",
"adFormat": "video",
"firstShownDate": "2026-10-07",
"lastShownDate": "2026-10-07",
"estimatedAudience": "0-1K",
"callToAction": "Apply now",
"campaignObjective": "Sales",
"adPaidForBy": "ZALANDO LOUNGE SERVICE GMBH",
"advertiserCountry": "Germany",
"targeting": { "countries": ["RO"], "ages": ["18-24", "25-34", "35-44", "45-54", "55+"], "genders": ["female", "male", "unknown"] },
"targetAudienceSize": "8.2M-10.0M",
"uniqueUsersSeenByCountry": [{ "region": "RO", "impressions": "0-1K", "breakdowns": [{ "age": "18-24", "gender": "FEMALE", "impressions": "0-1K" }] }]
}
```
A Creative Center top ad (shortened):
```json
{
"source": "creative_center",
"adId": "7686346996722745360",
"adTitle": "Discover the world of Emiriah perfumes. Find the fragrance that speaks to you.",
"industryName": "Fragrances & Perfumes",
"objectiveName": "Conversions",
"ctr": 0.81,
"likes": 71,
"videoDuration": 18.8,
"landingPage": "https://www.emiriah.com?utm_source=tiktok...",
"countryCodes": ["AE", "MX", "US", "IT"],
"keyframeMetrics": { "retain_ctr": { "duration": 20, "highlight": [3] } }
}
```
#### TikTok ads fields
| Field | Source | What it is | Fill on test runs |
|---|---|---|---|
| `adId`, `adDetailUrl`, `firstShownDate`, `lastShownDate`, `estimatedAudience` | Ad Library | Id, ad page, shown dates, unique users seen | 100% |
| `advertiserName` | Ad Library | Advertiser | 100% (live ads) |
| `adTitle` | Ad Library | Ad text | 98% on Zalando runs, 63-67% on nike FR runs, 100% on keyword runs (catalog ads print none) |
| `videoUrl` / `imageUrls` | Ad Library | Creative | 38-40% / 36-38% on Zalando runs, 97% / 95% on keyword runs (catalog ads print no creative) |
| `targeting`, `uniqueUsersSeenByCountry`, `targetAudienceSize`, `adPaidForBy` | details | Targeting, reach and payer | 100% |
| `callToAction` / `campaignObjective` | details | Call to action, objective | 87-88% / 90-91% |
| `adLandingUrl` | details | Landing page | 93-97% |
| `advertiserTiktokAccount` | details | Username, followers, verified, profile | 91-92% |
| `ctr`, `likes`, `cost`, `objectiveName`, `videoUrl` | Creative Center | Performance and video | 100% |
| `industryName` | Creative Center | Industry | 96% |
| `landingPage` | top-ad details | Landing page | 75-77% |
| `comments`, `shares`, `countryCodes`, `objectives` | top-ad details | Engagement and reach | 100% |
| `creativePatterns`, `creativeSummary` | top-ad details | TikTok's creative summary | rare on recent ads: none of 200 top ads on two 30-day runs (the default); 13 of 60 on a 180-day run sorted by likes |
| `keyframeMetrics` | Creative Center | Second-by-second curves | 100% when requested |
| `creatorUsername`, `contentLabel`, `postedDate`, `videoViews` | Commercial content | Creator post | 100% |
### How can I use TikTok ads data?
- 🕵️ **Competitive intelligence** — see every ad a competitor ran in Europe, when, how long, and to how many people
- 🎯 **Media planners** — read the targeting (countries, ages, genders, interests) and the reach by country behind a brand's campaigns
- 🎨 **Creative teams** — pull top-performing Creative Center ads by industry with CTR, likes and second-by-second retention
- 🛡️ **Brand safety and compliance** — track removed and restricted ads with TikTok's stated reasons and affected countries
- 🤝 **Influencer marketing** — list creators' paid partnerships and promotional posts by country
- 🤖 **AI and research teams** — feed compact rows to an LLM or a dashboard
- 📈 **Agencies** — schedule a daily run per client and get only new ads
### How much does it cost to scrape TikTok ads?
TikTok Ads Library Scraper is pay-per-result, no start fee:
| Event | Price | Per 1,000 |
|---|---:|---:|
| Ad Library ad or creator commercial post (`ad`) | $0.0016 | $1.60 |
| Ad Library details add-on (`ad-details`) | $0.001 | $1.00 |
| Creative Center top ad or Spotlight case (`top-ad`) | $0.00099 | $0.99 |
| Creative Center details add-on (`top-ad-details`) | $0.001 | $1.00 |
| Ads | Ad Library | Ad Library + details | Creative Center | Creative Center + details |
|---:|---:|---:|---:|---:|
| 10 | $0.016 | $0.026 | $0.0099 | $0.0199 |
| 100 | $0.16 | $0.26 | $0.099 | $0.199 |
| 1,000 | $1.60 | $2.60 | $0.99 | $1.99 |
| 10,000 | $16.00 | $26.00 | $9.90 | $19.90 |
Add-ons are charged only for ads that get them. There is nothing else to pay: Apify platform usage is included in these prices. Measured on the default 256 MB, two runs each: 30 ads in about 10 s, 100 advertiser ads with details in 52-117 s (TikTok's answer times vary), 150 keyword ads in about 28 s, 100 top ads with details and keyframes in 74-100 s.
### Integrations, API, scheduling & MCP
- **Schedules:** run TikTok Ads Library Scraper daily or weekly from the **Schedules** tab; with `monitorMode` each run returns only new ads.
- **Webhooks:** call a URL when a run finishes to push the ads to a CRM, Slack or a sheet.
- **No-code:** Make, Zapier, n8n, Google Sheets, Airtable and Slack through [Apify integrations](https://docs.apify.com/integrations).
- **API:** start runs and read datasets from Node.js or Python with `apify-client` — code on the [API tab](https://apify.com/topapi/tiktok-ads-library-scraper/api/python).
- **MCP / AI agents:** connect Claude, Cursor or any MCP client through the [MCP tab](https://apify.com/topapi/tiktok-ads-library-scraper/api/mcp) and ask for a brand's TikTok ads in plain language; `compact` keeps the rows short.
### More TopApi scrapers