🔍 TikTok Ads Scraper: Library + Top Ads

The most complete TikTok advertising intelligence tool on Apify. Two powerful modes in one Actor:

• 📚 Ads Library: EU transparency data from library.tiktok.com
• 🎯 Top Ads: Performance-ranked ads from TikTok Creative Center

---

🎯 Two Modes, One Actor

📚 Ads Library Mode (EU Transparency)

Access TikTok's official Ad Library for the European market. Get full transparency data: advertiser info, targeting, audience size, spend estimates, impressions, media assets, and more.

Best for: Compliance research, competitor monitoring in EU/EEA, advertiser-level analysis, spend & audience insights.

🎯 Top Ads Mode (Creative Center)

Access TikTok's Creative Center Top Ads, a curated ranking of the best-performing ads worldwide. Get engagement metrics (likes, CTR, budget level), video assets, and industry classification.

Best for: Creative inspiration, ad benchmarking, industry trend analysis, competitive intelligence.

---

💎 Key Features

Feature	Ads Library	Top Ads
🌍 Global coverage	EU/EEA countries	80+ countries
🔍 Keyword search	✅	✅
🏢 Advertiser search	✅	-
🔗 Direct URL import	✅	-
❤️ Engagement metrics (likes, CTR, budget)	-	✅
📈 Impressions & audience estimates	✅ (with details)	-
💰 Spend estimates	✅ (with details)	-
🎯 Targeting data (age, gender, region)	✅ (with details)	-
🏷️ Industry & objective classification	-	✅
🎬 Video URLs	Up to 1080p	720p
👤 Sponsor & advertiser info	✅ (with details)	Brand name
⚡ Speed	~2-5 ads/sec	~20 ads/sec

💡 Tip: In Library mode, enable "Fetch Ad Details" to get impressions, spend, targeting, sponsor and audience size. Without it, scraping is ~3x faster but only returns basic ad info.

---

📚 Ads Library Mode

Search Options

1. 🔤 Keyword Search: Search ads by content keywords
2. 🏢 Advertiser Name: Find all ads from a specific advertiser (optionally with Advertiser ID for precision)
3. 🌐 Direct URL: Paste any TikTok Ads Library URL and all parameters are auto-extracted

Input Parameters

Parameter	Type	Default	Description
mode	string	"library"	Set to "library"
region	string	"all"	Country code (FR, DE, GB, etc.) or "all"
startDate	string	"2025-01-01"	Start date (YYYY-MM-DD)
endDate	string	""	End date (empty = today)
queryType	string	"2"	1 = Keyword, 2 = Advertiser Name, url = Direct URL
query	string	""	Search term, advertiser name, or full URL
advertiserBizId	string	""	Optional advertiser business ID
maxAds	number	20	Maximum ads to collect
fetchDetails	boolean	true	Fetch targeting, sponsor, audience, spend, impressions
proxyConfiguration	object	Apify Proxy	Proxy settings

Input Example: Advertiser Name + ID

{
  "mode": "library",
  "region": "FR",
  "startDate": "2026-01-01",
  "endDate": "2026-06-01",
  "queryType": "2",
  "query": "LEVI STRAUSS & CO.",
  "advertiserBizId": "6886458055832109825",
  "maxAds": 10,
  "fetchDetails": true
}

Input Example: Keyword Search

{
  "mode": "library",
  "region": "GB",
  "startDate": "2025-01-01",
  "queryType": "1",
  "query": "football",
  "maxAds": 20,
  "fetchDetails": true
}

Input Example: Direct TikTok URL

{
  "mode": "library",
  "queryType": "url",
  "query": "https://library.tiktok.com/ads?region=FR&start_time=1777123937000&end_time=1779715937000&adv_name=LEVI%20STRAUSS%20%26%20CO.&adv_biz_ids=6886458055832109825&query_type=2&sort_type=last_shown_date,desc",
  "maxAds": 10,
  "fetchDetails": true
}

Output Example (Library)

{
  "AD ID": "1820020351685681",
  "Advertiser Name": "Bouazza Helmi",
  "AD Preview": "https://p21-ad-sg.ibyteimg.com/origin/...",
  "Ad Dates": [
    { "FirstShown": "2025-01-01", "FirstShownTimestamp": 1735689600 },
    { "LastShown": "2025-03-08", "LastShownTimestamp": 1741392000 }
  ],
  "Ad Audience": "100K-200K",
  "Ad Details": [
    { "Estimated Audience": "100K-200K" },
    { "Spent": "" },
    { "Impression": "" },
    { "Sponsor": "Digital Marketing Agency" },
    { "Target Audience Size": "5.2M-6.4M" }
  ],
  "Ad Media": [
    "Video 1: https://library.tiktok.com/api/v1/cdn/...",
    "Cover 1: https://p21-ad-sg.ibyteimg.com/origin/..."
  ],
  "Ad Targeting": {
    "regions": [{ "region": "FR", "impressions": "152K" }],
    "age": [{ "region": "FR", "18-24": true, "25-34": true, "35-44": true }],
    "gender": [{ "region": "FR", "female": true, "male": true }]
  },
  "Ad Sponsor": "Digital Marketing Agency",
  "Ad Target Audience Size": "5.2M-6.4M",
  "Ad Detail URL": "https://library.tiktok.com/ads/detail/?ad_id=1820020351685681"
}

Library Metrics (with fetchDetails enabled)

Field	Description
Ad Audience	Estimated audience reach (e.g. "100K-200K")
Impression	Number of impressions served
Spent	Estimated ad spend
Ad Sponsor	Name of the sponsoring entity
Ad Target Audience Size	Total estimated target audience (e.g. "5.2M-6.4M")
Ad Targeting	Breakdown by region (with impressions), age groups, and gender
Ad Media	Direct URLs to videos, cover images, and creatives

---

🎯 Top Ads Mode

Filters

• 🔍 Keyword: Search by brand, product, or topic
• 🌍 Countries: Multi-select from 80+ countries
• 🏷️ Industries: 21 parent categories + 200+ sub-industries
• 🎯 Objectives: Traffic, Conversions, App Installs, Video Views, Reach, Lead Gen, Product Sales
• 🗣️ Language: Filter by ad language (17 languages)
• ❤️ Likes percentile: Top 1-20%, 21-40%, etc.
• 📅 Time period: Last 7 days, 30 days, or 6 months
• 📊 Sort by: Likes, Reach, CTR, CVR, 2s/6s view rates

Input Parameters

Parameter	Type	Default	Description
mode	string	-	Set to "top_ads"
topAdsKeyword	string	""	Search keyword (leave empty to browse all)
topAdsCountryCode	array	[]	Country codes, e.g. ["FR", "DE"]
topAdsPeriod	string	"7"	"7", "30", or "180" days
topAdsOrderBy	string	"like"	Sort: like, impression, ctr, cvr, play_2s_rate, play_6s_rate
topAdsIndustry	array	[]	Industry IDs (parent or sub-industry)
topAdsObjective	array	[]	Objective IDs: 1=Traffic, 2=App, 3=Conversions, etc.
topAdsLanguage	string	""	Language code (fr, en, de, etc.)
topAdsLikeRange	string	""	Likes percentile: 1-5
topAdsMaxItems	number	100	Maximum ads to collect (up to 500)

Input Example: Top Ads in France (Education)

{
  "mode": "top_ads",
  "topAdsCountryCode": ["FR"],
  "topAdsPeriod": "30",
  "topAdsOrderBy": "like",
  "topAdsIndustry": ["10000000000"],
  "topAdsLanguage": "fr",
  "topAdsMaxItems": 50
}

Input Example: Keyword Search

{
  "mode": "top_ads",
  "topAdsKeyword": "netflix",
  "topAdsCountryCode": ["FR", "US"],
  "topAdsPeriod": "30",
  "topAdsOrderBy": "like",
  "topAdsMaxItems": 20
}

Input Example: Sub-industry Filter

{
  "mode": "top_ads",
  "topAdsCountryCode": ["FR"],
  "topAdsPeriod": "30",
  "topAdsIndustry": ["14103000000", "14104000000"],
  "topAdsObjective": ["3"],
  "topAdsMaxItems": 40
}

Output Example (Top Ads)

{
  "id": "7636363707227226130",
  "ad_title": "Des fiches prêtes à apprendre pour booster tes révisions CRPE",
  "brand_name": "Not Mention",
  "like": 585,
  "cost": 1,
  "cost_readable": "Medium",
  "ctr": 0.14,
  "ctr_readable": "Top 14%",
  "industry_key": "label_10101000000",
  "industry": "Primary & Secondary Education & K-12",
  "objective_key": "campaign_objective_conversion",
  "objective": "Conversions",
  "video_duration": 10.467,
  "video_cover": "https://p16-common-sign.tiktokcdn.com/...",
  "video_url_720p": "https://v16m-default.tiktokcdn.com/...",
  "video_width": 720,
  "video_height": 1280,
  "creative_center_url": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en?ad_id=7636363707227226130"
}

Top Ads Metrics

Field	Description
like	Number of likes on the ad
cost_readable	Budget level: Low, Medium, or High
ctr_readable	CTR percentile ranking (e.g. "Top 14%" = outperforms 86% of ads)
industry	Human-readable industry label (200+ categories)
objective	Campaign objective: Traffic, Conversions, App Installs, etc.
video_url_720p	Direct download URL for the ad video (720p)

---

💡 Use Cases & Ideas

🏢 For Marketing & Ad Agencies

• Creative swipe files: Build a library of top-performing TikTok ads in your client's industry. Filter by country, objective, and sub-industry to find exactly the right inspiration.
• Pitch preparation: Show clients what competitors are running and what's working best. Use budget and CTR data to benchmark performance.
• Ad spend monitoring: Track how much competitors invest across regions with Library mode's spend estimates.

🛍️ For E-Commerce & DTC Brands

• Competitor tracking: Monitor what ads your competitors are running in real-time across EU markets. Get notified when new campaigns launch.
• Creative inspiration: Find the highest-engagement ads in your product category (Skincare, Cosmetics, Fashion...) and study what makes them work.
• Market entry research: Before launching in a new country, analyze what ad formats, messages, and budgets work best in that market.

📊 For Data Analysts & Researchers

• Industry benchmarking: Collect hundreds of ads across industries to build performance benchmarks (CTR percentiles, budget tiers, engagement rates).
• Trend detection: Run weekly scrapes to track which industries, objectives, and ad formats are gaining traction over time.
• Academic research: Study advertising patterns, targeting strategies, and political ad transparency across the EU.

🎯 For Media Buyers & Performance Marketers

• Winning ad formats: Sort by CTR or conversion rate to find the highest-performing creative formats in your niche.
• Budget intelligence: Understand whether top performers are Low, Medium, or High budget, and find opportunities where low-budget ads outperform.
• Targeting insights: Use Library mode's age, gender, and regional targeting data to refine your own audience strategy.

🔗 Integration Ideas

• Feed into Google Sheets or Airtable: Use Apify integrations to automatically push new ads into your creative tracking spreadsheet.
• Build a Slack alert: Get notified when a competitor launches a new ad or when a top-performing ad appears in your industry.
• Power a dashboard: Connect the output to Looker Studio, Tableau, or any BI tool for real-time ad intelligence dashboards.
• Train AI models: Use the video URLs and ad copy to train creative analysis models or generate ad variations.

---

🤝 Support & Resources

Found a bug or want to request a feature? Open an issue.

❤️ Enjoying the scraper? Leave a review here