Pricing

Rating

Developer

Actor stats

Categories

Share

🔍 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

👁 TikTok Ads Scraper

🎯 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

💡 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

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)

🎯 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

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

💡 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