TikTok Ads Library Scraper (Apify)

Scrape the TikTok Ad Library by brand or keyword: ad copy, creatives, advertiser, regions and dates. JSON or CSV.

Hosted MCP Server

npx add-mcp 'https://mcp.apify.com/?tools=monkey.d.scraping/tiktok-ads-library-scraper'

Installs into Claude Code, Codex, Cursor and more

Documentation

TikTok Ads Library Scraper | TikTok广告库采集 | $0.29/1K (monkey.d.scraping/tiktok-ads-library-scraper) Actor

Scrape the TikTok Ad Library by brand or keyword for $0.29 per 1,000 ads, platform usage included. Many more ads per search; add advertiser, payer and age × gender targeting for $0.60/1K. No login. TikTok广告库采集,无需登录。

Pricing

from $0.29 / 1,000 ads

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the API section below.

Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (pip install apify-client).

README

TikTok Ads Library Scraper | Ads & Targeting | $0.29/1K

TikTok Ads Library Scraper exports ads from the public TikTok Ad Library (Commercial Content Library) by brand, advertiser name or keyword. Get ad text, video, first and last shown dates and estimated reach for $0.29 per 1,000 ads, platform usage included. Add advertiser, payer, objective, reach by country with age and gender, and targeting for $0.60 per 1,000 ads. No TikTok account, login or cookies needed.

Built for marketers, agencies, e-commerce teams and analysts who want to see what competitors advertise on TikTok, which products and angles they push, and which countries and audiences they target.

中文用户 / 中文用戶: 简体中文说明 · 繁體中文說明(TikTok广告库采集、TikTok广告爬虫、TikTok Ads Library API)

Why choose this TikTok Ads Library scraper?

  • Low, all-inclusive price. $0.29 per 1,000 ads, or $0.89 with full details. Platform usage is included, so the price you see is the price you pay. Several TikTok ad scrapers charge Apify platform usage on top of their per-result price, or add a start fee per run.
  • More ads per search. The TikTok Ad Library only shows a few hundred ads at once. This scraper keeps going automatically, so large brands and broad keywords return many more ads.
  • Built for a busy library. The run adapts its pace to the TikTok Ad Library, so it keeps delivering when the library is slow.
  • You never pay for gaps. Duplicate ads are free. Details are charged only when they were actually obtained. Ads requested by ID that cannot be read are not charged.
  • Every ad found is delivered. The search runs first, then details are added, and the status message shows progress live. Ads delivered without details are not charged for details.
  • Full targeting data. Reach per country with the age × gender breakdown, targeted ages and genders, interests, custom audiences, languages, devices, objective, payer and advertiser registration country.
  • No login, no cookies, no TikTok account.
Benchmark on the same search

Same search, same day: keyword samsung, Italy, 6 October – 5 November 2026, about 100 ads with details. Measured on 5 November 2026 against a popular TikTok ads scraper in the Apify Store.

This ActorPopular alternative
Ads delivered10870 (stopped after 7 of 9 pages)
Ads with details108 / 10870 / 70
Run time8 min 41 s14 min 25 s
Total cost to the user$0.096 ($0.89 per 1,000 ads)$0.087 for 70 ads (about $1.24 per 1,000 ads, platform usage included)

Results depend on the search, the date range and how busy the TikTok Ad Library is. Re-run your own search with 10 ads to check output and cost before larger runs.

What can you use it for?

  • Competitor ad research: list every TikTok ad a brand ran in the last days or months, with video, text and dates.
  • Product and creative ideas: search a keyword (for example skincare or air fryer) and see which products and hooks advertisers are using.
  • Targeting and reach analysis: see in which countries an ad ran, estimated unique users reached, and the age and gender breakdown.
  • Advertiser and lead research: find who pays for ads in a niche, where the advertiser is registered and which TikTok account it uses.
  • Monitoring with schedules or API: run the same search daily or weekly and compare results in your own pipeline.

What data do you get?

FieldDescriptionSearch ($0.29/1K)Details (+$0.60/1K)
adId, adUrlAd ID and link to the ad page in the TikTok Ad Library✅✅
adText, adTypeAd caption and format: video, image or text✅✅
videoUrl, coverImageUrl, imageUrlsCreative links as published by the library✅✅
firstShownDate, lastShownDateDates the ad was shown (YYYY-MM-DD)✅✅
estimatedAudience, category, statusUnique users reached range, category, active or unavailable✅✅
advertiserNameAdvertiser name when the library shows it✅ (when shown)✅
advertiserId, advertiserCountry, paidBy, advertiserTikTokUserAdvertiser ID, registration country, payer, linked TikTok account—✅
objectiveCampaign objective, for example Reach or Lead generation—✅
totalImpressions, totalRegions, impressionsByCountryReach overall and per country, with age × gender breakdown—✅
targetingAgeByCountry, targetingGenderByCountry, targeting, targetAudienceSizeTargeted ages, genders, countries, languages, interests, custom audiences, devices—✅

Every row also has searchTerm, searchCountry, detailsIncluded and scrapedAt.

  • Covers ads shown in the European Union, EEA, Switzerland, United Kingdom, Turkey and Brazil, with dates up to one year back.
  • Reach values are ranges published by TikTok (for example 1K-10K).
  • Fields that TikTok does not publish for an ad (reach, countries, objective, or the advertiser name of some removed ads) are null or empty.
  • Video and image links are temporary links published by the library.

How much does it cost?

You pay only for results. Platform usage is included.

What you getPrice per 1,000 ads100 ads1,000 ads
Search results only (details off)$0.29$0.029$0.29
Search results with details (default)$0.89 ($0.29 + $0.60)$0.089$0.89
  • Duplicate ads are removed and not charged.
  • Details are charged only when they were actually obtained for that ad.
  • An ad requested by ID whose details cannot be read is not charged.
  • Set a maximum cost per run in Apify Console and the run stops when it is reached.

How to use it

  1. Enter one or more advertiser names or keywords, one per line.
  2. Choose the country where the ads were shown, or all supported countries.
  3. Set maximum ads per search. Start with 10 to see the output.
  4. Optional: choose dates. Without dates you get the last 30 days.
  5. Click Start and export to JSON, CSV, Excel, or use the API.

For faster and cheaper runs, turn off Include advertiser and targeting details in the advanced options.

Tips for large searches
  • Narrow the search with a country and dates: you get more relevant ads and faster runs.
  • For thousands of ads, run the search without details first, then put the IDs of the ads you care about in Ad IDs to get their details. It is quicker and cheaper.

Input example

{
  "searchTerms": ["samsung"],
  "country": "IT",
  "maxAdsPerSearch": 10,
  "dateFrom": "2026-10-01",
  "dateTo": "2026-11-05",
  "includeDetails": true
}

Output example

Real result with details, shortened:

{
  "adId": "1879941377312769",
  "adUrl": "https://library.tiktok.com/ads/detail/?ad_id=1879941377312769",
  "status": "active",
  "searchTerm": "samsung",
  "searchCountry": "IT",
  "advertiserName": "Ricardos_cartel",
  "advertiserId": "7700239797620785170",
  "advertiserCountry": "Italy",
  "paidBy": "Ricardos_cartel",
  "adText": "samsung s26 ultra edit#samsung #s26u",
  "adType": "video",
  "objective": "Reach",
  "category": "Tech & Electronics",
  "firstShownDate": "2026-10-24",
  "lastShownDate": "2026-10-25",
  "estimatedAudience": "1K-10K",
  "totalImpressions": "1K-10K",
  "totalRegions": 1,
  "impressionsByCountry": [
    {
      "country": "IT",
      "impressions": "8K",
      "breakdowns": [
        { "age": "18-24", "gender": "MALE", "impressions": "2K" },
        { "age": "18-24", "gender": "FEMALE", "impressions": "2K" }
      ]
    }
  ],
  "targetingAgeByCountry": [
    { "region": "IT", "13-17": true, "18-24": true, "25-34": true, "35-44": true, "45-54": true, "55+": true }
  ],
  "targetingGenderByCountry": [{ "region": "IT", "female": true, "male": true, "unknown": true }],
  "targetAudienceSize": "22.1M-27.0M",
  "detailsIncluded": true,
  "scrapedAt": "2026-11-05T13:11:03.394Z"
}

Ready-to-run examples

ExampleUse caseWhat you get
Competitor ads by brandSee what a brand advertises on TikTok in GermanyUp to 20 recent adidas ads with advertiser and targeting details
Ad ideas by keywordFind products and hooks in a niche across all countriesUp to 50 skincare ads, search results only
Highest-reach ads and targetingSee which ads reached the most people and whom they targetedUp to 20 Nike ads in France sorted by reach, with age, gender and country breakdown

FAQ

Is this the cheapest way to scrape the TikTok Ad Library? At $0.29 per 1,000 ads with platform usage included, it is lower than the TikTok ad scrapers we checked in the Apify Store on 5 November 2026, which charge between $0.40 and $15 per 1,000 ads, often plus platform usage or a start fee. Prices change, so compare the total cost of a test run.

Why is the total cost lower than other scrapers? Because platform usage is included in the price, details are charged only when obtained, and duplicates are free. You do not get a separate compute bill.

How many ads can I get for one brand or keyword? As many as the library shows for your dates, well past the few hundred ads TikTok shows at once.

Why are reach or countries empty for some ads? The TikTok Ad Library does not publish reach, countries or objective for every ad. When TikTok leaves them out, the scraper returns null instead of guessing. Advertiser ID, registration country, payer and target audience size are usually still available with details.

Do I need a TikTok account or cookies? No. The scraper reads the public TikTok Ad Library like a visitor does.

What is the difference between search and details? Search returns the ad, its creative and dates. Details add who advertises and pays, the objective, reach by country with age and gender, and targeting. Details take longer because each ad page is opened.

Can I search by advertiser and by keyword? Yes. Each line is searched as the library does: advertiser names and words in the ad.

Can I get specific ads? Yes. Put ad IDs in Ad IDs in the advanced options. Details are fetched for each ID.

Does it work for the TikTok Creative Center top ads? No. This Actor covers the TikTok Ad Library (Commercial Content Library) only.

How do I monitor a competitor? Save an Apify task with the brand and schedule it. Each run returns the ads shown in the chosen period; compare runs by adId.

Chinese Simplified

中文说明:TikTok广告库采集工具(TikTok Ads Library 爬虫 / API)

TikTok Ads Library Scraper 按品牌名、广告主名称或关键词,批量导出 TikTok广告库(TikTok Ad Library / 商业内容资料库)中的公开广告:广告文案、视频素材链接、首次和最后展示日期、预估覆盖人数。每1,000条广告仅0.29美元,平台用量已包含。开启详情(每1,000条另加0.60美元)后,还能拿到广告主、付款方、投放目标、各国家覆盖量及年龄×性别分布和完整定向设置。无需TikTok账号、无需登录、无需Cookie。

专为跨境电商卖家、出海品牌、广告代理和数据分析团队打造:一眼看清竞品在TikTok上投了哪些广告、主推哪些产品和卖点、投放到哪些国家和人群。

为什么选择这款TikTok广告采集工具?
  • 价格低,费用全包:每1,000条广告0.29美元,含详情0.89美元。平台费用已包含,没有额外账单,也没有启动费。
  • 单次搜索拿到更多广告:TikTok广告库一次只显示几百条,本工具会自动继续采集,大品牌和热门关键词也能拿到更多结果。
  • 完整的定向数据:各国家覆盖量及年龄×性别分布,定向年龄、性别、兴趣、自定义受众、语言、设备,以及投放目标、付款方和广告主注册国家。
  • 只为有效数据付费:重复广告免费;详情只有成功获取时才计费。
  • 已找到的广告全部交付:先完成搜索再补充详情,运行进度实时显示。
  • 导出方便:一键导出JSON、CSV、Excel,或通过API接入你的系统。
同一搜索实测对比

2026年11月5日,关键词 samsung、意大利、约100条带详情的广告,与Apify商店中一款热门TikTok广告采集工具对比:

本工具热门替代工具
交付广告数108条(全部含详情)70条(9页中只完成7页)
运行时间8分41秒14分25秒
每1,000条成本0.89美元约1.24美元
适用场景
  • 跨境电商选品:搜索 skincare、air fryer 等关键词,看哪些产品在TikTok上大量投放,发现爆款和热门卖点。
  • 竞品广告监控:导出竞品品牌最近几天或几个月的全部TikTok广告,含视频素材和投放日期。
  • 广告素材灵感:批量收集同类目的广告视频和文案,分析开头钩子和创意方向。
  • 投放市场分析:了解广告投放到哪些国家、覆盖多少人、主要触达哪个年龄段和性别。
  • 广告主与销售线索:找出某个细分领域正在投放广告的公司、付款方和对应的TikTok账号。
  • 定时监控:保存为任务并设置定时运行,每天或每周自动获取最新广告。
可以获取哪些数据?
  • 基础数据(0.29美元/1,000条):广告ID和链接、广告文案、广告类型(视频、图片、文字)、视频和封面图链接、首次和最后展示日期、预估覆盖人数、类目、状态、广告主名称。
  • 详情(另加0.60美元/1,000条):广告主ID、注册国家、付款方、关联的TikTok账号、投放目标(如触达、获客)、总覆盖量、各国家覆盖量及年龄×性别分布、定向年龄和性别、兴趣、自定义受众、语言、设备、目标受众规模。
  • 覆盖范围:欧盟、欧洲经济区、瑞士、英国、土耳其和巴西投放的TikTok广告,最长可追溯一年。
价格

按结果付费,平台用量已包含:

内容每1,000条广告100条1,000条
仅搜索结果0.29美元0.029美元0.29美元
搜索结果 + 详情(默认)0.89美元0.089美元0.89美元

可在Apify控制台设置每次运行的最高费用,达到后自动停止。

使用方法
  1. 输入一个或多个品牌名、广告主名称或关键词,每行一个。
  2. 选择广告投放的国家,或选择全部国家。
  3. 设置每次搜索的最大广告数,建议先用10条查看结果。
  4. 可选:设置日期范围,不填则默认最近30天。
  5. 点击 Start,完成后导出为JSON、CSV、Excel,或通过API获取。
{
  "searchTerms": ["temu"],
  "country": "DE",
  "maxAdsPerSearch": 20,
  "includeDetails": true
}

一键运行中文示例: TikTok竞品广告采集:Temu在德国的广告(上面的输入已保存为示例任务,打开即可运行)。

常见问题

需要TikTok账号或Cookie吗? 不需要。工具像普通访客一样读取公开的TikTok广告库。

能看到竞品广告投放到哪些国家和人群吗? 可以。开启详情后返回各国家覆盖量、年龄和性别分布,以及定向年龄、性别、兴趣和语言。

能下载广告视频素材吗? 结果中包含TikTok广告库公开的视频和封面图链接,可直接用于素材分析。

可以通过API、自动化工具或AI智能体调用吗? 可以。支持Apify API、Python和Node.js客户端,以及n8n、Make、Zapier等自动化工具;也可以通过Apify MCP服务器作为AI智能体的工具使用。

如何每天监控竞品的新广告? 将品牌保存为Apify任务并设置定时运行,按 adId 对比每次结果即可。

中文说明会翻译采集到的数据吗? 不会。中文说明只是使用文档;采集到的数据保持来源的原始语言(广告文案按发布时的原文呈现)。

其他广告情报工具

Chinese Traditional

中文說明(繁體):TikTok廣告資料庫擷取工具(TikTok Ads Library 爬蟲 / API)

TikTok Ads Library Scraper 依品牌、廣告主名稱或關鍵字,從公開的 TikTok廣告資料庫 匯出廣告文案、影片素材、曝光日期與預估觸及人數,每1,000則廣告0.29美元,平台用量已包含。開啟詳細資料(另加0.60美元)可取得廣告主、付款方、各國觸及量與目標設定。不需要帳號,也不必登入。

為什麼選擇這款TikTok廣告爬蟲?
  • 費用全包:含詳細資料每1,000則0.89美元,沒有額外帳單或啟動費。
  • 更多廣告:自動持續擷取,取得遠多於一次顯示的幾百則廣告。
  • 完整目標設定:各國觸及量、年齡×性別分布、興趣、語言與裝置。
  • 只為有效資料付費:重複廣告免費,詳細資料成功取得才計費。
適用場景
  • 競品分析:匯出競爭品牌在TikTok上的所有廣告與影片素材。
  • 廣告監測:設定排程每天或每週執行,依 adId 比對新廣告。
  • 品牌行銷靈感:搜尋 skincare 等關鍵字,看哪些產品和切入點正在投放。
  • 投放市場分析:廣告投放到哪些國家,觸及哪些年齡層與性別。
使用方法
  1. 輸入品牌、廣告主名稱或關鍵字,每行一個。
  2. 選擇國家,設定每次搜尋的最大廣告數(建議先用10則)。
  3. 選填日期範圍(預設最近30天),點擊 Start,匯出JSON、CSV、Excel或透過API取得。
{
  "searchTerms": ["temu"],
  "country": "DE",
  "maxAdsPerSearch": 20,
  "includeDetails": true
}
價格

僅搜尋結果每1,000則廣告0.29美元,含詳細資料(預設)0.89美元,平台用量已包含。

常見問題

需要TikTok帳號或Cookie嗎? 不需要,工具就像一般訪客一樣讀取公開資料庫。

能看到廣告投放到哪些國家和族群嗎? 可以。開啟詳細資料後會回傳各國觸及量及年齡、性別分布。

中文說明會翻譯擷取到的資料嗎? 不會。說明是中文,資料保留來源的原始語言(廣告文案以刊登時的語言呈現)。

完整欄位與輸出範例請見英文說明或简体中文说明。

Related ad research tools

  • Microsoft Ads Library Scraper: Bing ads by keyword, advertiser or website domain, with landing pages, UTM parameters, impressions by country and targeting. From $0.50 per 1,000 ads.
  • LinkedIn Ad Library Scraper: LinkedIn ads by company, keyword or payer, with impressions by country, targeting, payer and dates. From $0.50 per 1,000 ads.
  • Google Ads Scraper — Transparency Center: a competitor's Google Search, YouTube and Shopping ads by domain or brand, with reach by country and platform, ad texts and landing pages. From $0.40 per 1,000 ads.
  • Google Ads Domain Checker: check whether a website domain advertises on Google, with advertiser names, ad dates and evidence links.
  • LinkedIn Ad Library Change Monitor: collect a company's public LinkedIn ads and see what changed between runs.

More tools for marketers

These are separate Actors and are never called by this TikTok Actor.

Actor input Schema

searchTerms (type: array):

Brand, advertiser name or keyword, one per line, for example samsung or air fryer. Each line is a separate search in the TikTok Ad Library.

country (type: string):

Country where the ads were shown. The TikTok Ad Library covers the EU, EEA, Switzerland, the UK, Turkey and Brazil.

maxAdsPerSearch (type: integer):

Stops each search after this many unique ads. Start with 10 to preview the output; duplicates are never charged.

dateFrom (type: string):

Ads shown on or after this date. Empty: 30 days before the end date. At most one year back.

dateTo (type: string):

Ads shown on or before this date. Empty: today.

includeDetails (type: boolean):

Adds advertiser ID and country, payer, objective, reach by country with age and gender, and targeting (+$0.60 per 1,000 ads). Turn off for search results only ($0.29 per 1,000 ads).

sortBy (type: string):

Order of the results returned by the library.

adIds (type: array):

Fetch these ads directly by ID, for example 1879941377312769. When filled, the search fields are ignored and details are fetched for each ID.

Actor input object example

{
  "searchTerms": [
    "samsung"
  ],
  "country": "all",
  "maxAdsPerSearch": 10,
  "includeDetails": true,
  "sortBy": "last_shown_date,desc"
}

Actor output Schema

ads (type: string):

One row per unique TikTok ad, with details when enabled.

advertisers (type: string):

Advertiser, payer, objective, reach and audience size per ad.

summary (type: string):

Searches, ads delivered, details obtained, date range and search completion status.

API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

JavaScript example

import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "samsung"
    ],
    "country": "all",
    "maxAdsPerSearch": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("monkey.d.scraping/tiktok-ads-library-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

Python example

from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["samsung"],
    "country": "all",
    "maxAdsPerSearch": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("monkey.d.scraping/tiktok-ads-library-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

CLI example

echo '{
  "searchTerms": [
    "samsung"
  ],
  "country": "all",
  "maxAdsPerSearch": 10
}' |
apify call monkey.d.scraping/tiktok-ads-library-scraper --silent --output-dataset

MCP server setup

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,monkey.d.scraping/tiktok-ads-library-scraper"
        }
    }
}

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an Authorization: Bearer <APIFY_API_TOKEN> header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/QQjOBpPFRdWT0jYQl/builds/ulIsxY0RIwAXD3UWx/openapi.json