TikTok Ad Library Scraper — Ad Creatives, Targeting & Spend Data

Extract ad creatives, advertiser info, targeting data, and spend estimates from TikTok's official Ad Library — covering 33 EU/EEA regions. No API key or login required.

Try it free — your first $5 of usage is on Apify. No credit card required.

🔍 What is TikTok Ad Library Scraper?

TikTok Ad Library Scraper is an unofficial TikTok API that extracts paid ad data from TikTok's official Commercial Content Library — the transparency platform where TikTok publishes all ads running across 33 EU/EEA countries.

Use TikTok Ad Library Scraper to:

• Monitor competitor ads — see what creatives, messaging, and targeting your competitors use on TikTok
• Analyze ad spend & audience — extract estimated audience size, impressions, spend ranges, and targeting breakdowns by age, gender, and location
• Discover advertisers — find all advertisers on the platform via brute-force prefix search
• Track branded content — search commercial partnerships and sponsored posts
• Automate ad intelligence — schedule daily/weekly runs and integrate via API, Make, or Zapier

📊 Three scraping modes

Mode	What it delivers	Use case
🔍 Search Ads	Ad creatives, video URLs, audience estimates, impressions, spend, targeting	Competitive intelligence, market research
🏢 Discover Advertisers	Advertiser names and business IDs via brute-force prefix search	Build advertiser databases, find new competitors
📱 Commercial Content	Branded partnerships, sponsored posts, creator usernames, brand names	Influencer marketing research

TikTok Ad Library Scraper uses a real Chromium browser engine internally, bypassing TikTok's TLS fingerprint checks — no workarounds or cookies needed.

📋 What data does TikTok Ad Library Scraper extract?

Ad fields (Search Ads mode)

Field	Type	Description
adId	string	Unique TikTok ad identifier
adType	string	Ad format: video, image, or text
adVideoUrl	string	Direct URL to the ad video file
adVideoCover	string	Video thumbnail/cover image URL
adImageUrls	array	URLs of ad images (for image ads)
adStartDate	string	Date when the ad was first shown (YYYY-MM-DD)
adEndDate	string	Date when the ad was last shown (YYYY-MM-DD)
adEstimatedAudience	string	Estimated audience range (e.g., "10K-100K")
adSpent	string	Ad spend amount (when available)
adImpressions	string	Impression count or range
advertiserName	string	Advertiser display name
advertiserId	string	Advertiser's business ID

Detailed fields (with "Include ad details" ON)

Field	Type	Description
advertiserLocation	string	Advertiser's registered country
advertiserPaidForBy	string	Entity that paid for the ad
advertiserTtUser	object	Advertiser's TikTok profile (username, followers, account type)
advertisingObjective	string	Campaign objective (e.g., Sales, Traffic, Awareness)
targetingAudienceSize	string	Estimated target audience size (e.g., "11.1M-13.6M")
targetingCountries	array	List of targeted countries
targetingByLocation	array	Impression breakdown by country with age/gender splits
targetingByAge	array	Age group targeting per region
targetingByGender	array	Gender targeting per region

Browse sample data — see exactly what you'll get before running.

See real records before you run it

A public sample dataset is open — no account, no token:

100 real records →

📦 Output example

Each result is a structured JSON object. Here's a real ad from Nike with full targeting details:

{
  "adId": "1873955595880577",
  "adType": "video",
  "adVideoUrl": "https://library.tiktok.com/api/v1/cdn/.../video/...",
  "adVideoCover": "https://p16-common-sign.tiktokcdn.com/...",
  "adImageUrls": ["https://p16-common-sign.tiktokcdn.com/..."],
  "adStartDate": "2026-08-20",
  "adEndDate": "2026-08-27",
  "adEstimatedAudience": "10K-100K",
  "adSpent": "",
  "adImpressions": "10K-100K",
  "advertiserId": "6876453864464188162",
  "advertiserName": "NIKE Retail B.V.",
  "advertiserLocation": "Netherlands",
  "advertiserTtUser": {
    "username": "nike",
    "display_name": "Nike",
    "follower_count": "9.2M",
    "account_type": "VERIFIED_BA"
  },
  "advertiserPaidForBy": "INITIATIVE MEDIA B.V.",
  "advertisingObjective": "Sales",
  "adTotalRegions": 1,
  "targetingAudienceSize": "11.1M-13.6M",
  "targetingCountries": ["ES"],
  "targetingByLocation": [
    {
      "region": "ES",
      "impressions": "22K",
      "breakdowns": [
        { "age": "18-24", "gender": "MALE", "impressions": "4K" },
        { "age": "18-24", "gender": "FEMALE", "impressions": "6K" },
        { "age": "25-34", "gender": "MALE", "impressions": "4K" },
        { "age": "25-34", "gender": "FEMALE", "impressions": "7K" }
      ]
    }
  ],
  "targetingByAge": [{ "region": "ES", "18-24": true, "25-34": true, "35-44": true }],
  "targetingByGender": [{ "region": "ES", "female": true, "male": true }]
}

Download results in JSON, CSV, Excel, XML, or HTML from the Output tab, or pull them via API.

Browse sample records — see exactly what you'll get before running.

🚀 How to use TikTok Ad Library Scraper

1. Create a free Apify account at apify.com — your first $5 is free
2. Open TikTok Ad Library Scraper and click Try for free
3. Paste a TikTok Ad Library URL or configure search filters manually
4. Click Start — default settings scrape ~20 Nike ads in under 30 seconds
5. Preview your data in the Output tab
6. Export in JSON, CSV, or Excel — or connect via API, Make, or Zapier

Tip: Start with the default input (20 Nike ads in Spain) to see the output format before customizing.

⚙️ Input parameters

Quick start — paste a URL

Copy a URL from library.tiktok.com and paste it in the TikTok Ad Library URL field. TikTok Ad Library Scraper extracts all parameters (region, keyword, dates) automatically. When you paste a URL, all manual filter fields are skipped.

Manual configuration

Parameter	Type	Default	Description
mode	select	search_ads	search_ads, discover_advertisers, or search_commercial_content
searchQuery	string	nike	Keyword (e.g., running shoes) or advertiser name (e.g., Nike)
queryType	select	keyword	keyword searches ad text; advertiser finds by advertiser name
region	select	all	Country filter — 33 EU/EEA regions or all
maxResults	integer	100	Hard cap on results (TikTok limits searches to ~3,600 per query)
startDate	date	31 days	Start of date range — accepts YYYY-MM-DD or relative like 31 days
endDate	date	0 days	End of date range
includeDetails	boolean	false	Fetch full targeting, audience, and spend data (1 extra request per ad)
sortBy	select	last_shown_date,desc	Sort order for results
adIds	string	—	Comma-separated ad IDs for direct lookup (skips search)
advertiserIds	string	—	Filter by advertiser business IDs
discoveryPrefixes	string	—	Custom prefixes for Discover Advertisers mode
requestDelay	integer	500	Delay between API requests (ms) — increase to 1000–2000 if rate-limited
proxyConfiguration	object	—	Optional proxy config — residential recommended for high-volume runs

💰 How much does it cost to use TikTok Ad Library Scraper?

$0.90 per 1,000 ads (+ $0.0005 per start). Your $5 free trial credit covers ~5,500 ads.

💡 Use cases

• Competitive ad intelligence — Monitor what ads competitors run on TikTok, their creatives, messaging, and audience targeting across EU markets
• Brand protection — Detect unauthorized use of your brand name or trademarks in TikTok ads
• Market research — Analyze ad spend, audience targeting, and creative trends for any industry or category
• Influencer marketing — Discover which brands run paid partnerships and sponsored content on TikTok
• Compliance monitoring — Track ad transparency data for regulatory compliance across EU/EEA regions
• Creative analysis — Download ad videos and images to study creative strategies and messaging trends

🔑 Key advantages

• Real browser engine — uses Chromium internally, bypassing TikTok's TLS fingerprint checks automatically
• Full targeting data — audience size, impression breakdowns by age/gender/location — data you can't get from the TikTok Ad Library UI alone
• URL import — paste any library.tiktok.com URL and parameters are extracted automatically
• Three scraping modes — search ads, discover advertisers, or track commercial content
• 33 EU/EEA regions — all countries available in TikTok's official Ad Library
• Direct ad video download — adVideoUrl field contains a direct link to the ad video file

🔄 Integrations & scheduling

• Schedule daily or weekly runs from the Apify Console for automated ad monitoring
• Push results to Google Sheets, Slack, Zapier, Make, webhooks, or any database
• Fetch datasets via the Apify REST API or the official JavaScript/Python clients
• Use the Apify API to trigger runs programmatically from your own applications

🔗 Related Rastriq Actors

Ad library scrapers

All four share a normalized output schema — same field names, same formats. Merge datasets from different platforms without a mapping layer.

Actor	What it adds
Facebook Ad Library Scraper	Ad creatives from Facebook and Instagram — Meta's entire paid media ecosystem
Google Ads Transparency Scraper	Search, Display and YouTube ads from Google's Ads Transparency Center
LinkedIn Ad Library Scraper	B2B ad intelligence — impressions by country, paying entity and targeting segments

TikTok Creative Center

Actor	What it adds
TikTok Top Ads Scraper	Top-performing ad creatives — CTR, likes, video URLs, landing pages across 49 countries and 21 industries
TikTok Trending Videos Scraper	Trending videos with creator profiles, engagement rates, organic views and 6-second view-through rates
TikTok Trends Scraper	Trending hashtags with view counts, post volumes and industry tags across 27 countries

Competitive intelligence

Actor	What it adds
SimilarWeb Data Extractor	Traffic estimates and top pages for the landing pages these ads point to

Copy to your AI assistant

Copy the Apify Store URL for this Actor and paste it into ChatGPT, Claude, or any LLM with web access:

https://apify.com/rastriq/tiktok-ad-library-scraper

The model will read the Actor description, input schema, and field list — then help you build the right API call or integration.

About the data

This actor is part of Rastriq's ad intelligence coverage. See the normalised output fields, the full source list and the use cases behind it: Competitor Ad Tracking — TikTok Ads.

❓ FAQ

Is scraping TikTok Ad Library legal?

TikTok Ad Library Scraper only accesses publicly available data from TikTok's official transparency platform. The Ad Library was created specifically to provide public access to advertising data. You are responsible for using the extracted data in compliance with TikTok's Terms of Service and applicable data protection laws (including GDPR where relevant).

Does TikTok Ad Library Scraper require a login or API key?

No. TikTok Ad Library Scraper works with public data only. The browser engine handles session cookies and security tokens automatically — no manual setup required.

What regions are supported?

All 33 EU/EEA regions available in TikTok's Ad Library: Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Turkey, and the United Kingdom.

How many ads can I extract per run?

TikTok limits search results to approximately 3,600 ads per query (300 pages × 12 ads). For more coverage, run multiple searches with different keywords, regions, or date ranges.

What's the difference between basic and detailed output?

With Include ad details OFF (default), you get ad creative data: video/image URLs, dates, audience estimate, and advertiser name. With Include ad details ON, each ad gets an extra API call that returns full targeting breakdowns (age, gender, location), audience size, spend data, advertiser location, and TikTok profile info.

Do I need residential proxies?

The actor works without proxies from most locations. Enable Apify's residential proxy pool if you experience rate limiting (HTTP 429) or for high-volume runs. Datacenter proxies are not recommended as TikTok blocks them.

Can I download the ad videos?

Yes. The adVideoUrl field contains a direct link to the ad video file. You can download videos programmatically using the URLs from the dataset.

Why did my run return 0 results?

Common causes: (1) no ads match your search query in the selected region and date range — try broadening your filters, (2) TikTok's API returned a rate limit — increase requestDelay to 1000–2000ms, (3) session initialization failed — check the run log for errors and retry.

How do I find a specific advertiser's ads?

Set Query type to Advertiser name and enter the company name. TikTok Ad Library Scraper automatically resolves the advertiser's business ID and fetches all their ads. You can also paste the advertiser's business ID directly in the Advertiser IDs field.