🔍 TikTok Ads Library Scraper

Transform your ad intelligence with our TikTok Ads Library scraper! Whether you're analyzing competitor strategies, monitoring brand campaigns, or conducting market research, this tool efficiently collects and structures advertising data from TikTok's Ad Library.

💎 Why Choose Our TikTok Ads Scraper?

• 🎯 Advanced Search Options: Find ads by keyword, advertiser name, optional advertiser ID, or paste TikTok URLs directly
• 🚀 High-Volume Collection: Gather up to hundreds of ads in a single run with optimized pagination and intelligent proxy rotation
• 🌐 Global Coverage: Access ads from multiple regions with support for all TikTok-supported countries
• 📊 Rich Ad Details: Extract comprehensive ad information including media URLs, dates, performance metrics, advertiser profile, and per-country reach
• 🗺️ Country-Level Reach: Get impressions per country and the age × gender breakdown for each market
• 🔢 Parsed Numbers: Every numeric range (audience size, reach, impressions) is returned with both the readable text and clean integer min/max values, ready to sort and aggregate
• 🖼️ Media Access: Capture links to all ad creative assets including videos and images

🔮 How to Power Up Your Search Queries?

• 1. 🔤 Keyword Search : Search for ads containing specific words or phrases in their content
• 2. 🎯 Exact Match Search : For precise targeting, wrap your search term in quotes to find exact matches
• 3. 🏢 Advertiser Name Search : Search by advertiser name (e.g. "LEVI STRAUSS & CO."). You can optionally add the Advertiser ID for more precise results
• 4. 🌐 Direct URL: Paste any TikTok Ads Library URL and the scraper will automatically extract all parameters (timestamps, advertiser name, ID, region, etc.)

✨ What You'll Get

🔢 Number format: Fields like Ad Audience, Ad Target Audience Size and every reach/impressions value are returned as an object { "raw": "11.7M-14.2M", "min": 11700000, "max": 14200000 }. Keep the human-readable text in raw, and sort/filter/aggregate directly on min / max. For single values, min equals max; empty values return null.

📰 Ads Data Structure

Field	Description
AD ID	Unique identifier for the ad
Advertiser Name	Name of the company/entity running the ad
Ad Title	Title/headline of the ad creative
AD Preview	URL to the preview image/thumbnail of the ad
Ad Dates	First and last shown dates with timestamps
Ad Audience	Estimated audience as { raw, min, max } (e.g. "1M-10M")
Ad Details	Comprehensive details: estimated audience, spend, type, audit status, impressions, sponsor, target audience size, advertising objective, call to action, and external (landing) URL
Ad Media	URLs to all creative assets (videos, images, cover images)
Ad Targeting	Detailed targeting: regions, enabled age groups, gender, languages, cities, provinces, operating systems, device models, high spending power, audience, interests, and interaction signals
Ad Reach	Per-country reach: total regions, total impressions, and for each country the impressions plus a full age × gender breakdown (every impressions value is a { raw, min, max } object)
Advertiser	Advertiser profile: name, business IDs, registry location, sponsor, and linked TikTok account (username, display name, follower count, account type, profile link, avatar)
Ad Sponsor	Sponsor information from ad details
Ad Target Audience Size	Estimated target audience size as { raw, min, max } (e.g. "11.7M-14.2M")
Ad Detail URL	Direct link to the ad on TikTok Ads Library

🚀 Performance Features

⚡️ Lightning Fast:

• Pipelined pagination (the next page is fetched while the current page's details are being collected)
• Concurrent ad-detail fetching
• Efficient proxy rotation and optimized resource usage
• Smart retry mechanism

🛠️ Smart Handling:

• Automatic URL standardization
• Automatic date-window paging to go beyond the per-window result cap
• Proxy/session health monitoring with automatic token refresh
• Resilient to transient network drops (empty/invalid responses are retried, never crash the run)

🌍 Global Coverage:

• Works with any TikTok-supported region
• Standardizes output format

📋 Quick Start

Input Parameters

Parameter	Type	Default	Description
region	string	"all"	Region code for which you want to scrape ads
startDate	string	"2025-01-01"	Start date for ads (format: YYYY-MM-DD)
endDate	string	""	End date for ads (empty for current date)
queryType	string	"2"	Query type (1=Keyword, 2=Advertiser Name, url=Direct URL)
query	string	""	Search query: keyword, advertiser name, or full TikTok Ads Library URL
advertiserBizId	string	""	Optional advertiser business ID (only for Advertiser Name mode). Found in TikTok URL as adv_biz_ids
maxAds	number	20	Maximum number of ads to scrape
fetchDetails	boolean	true	Fetch detailed ad information including reach & advertiser profile (set to false for faster, lighter scraping)
detailConcurrency	number	6	Number of ad-detail requests fetched in parallel
proxyConfiguration	object	{useApifyProxy: true, apifyProxyGroups: []}	Proxy configuration (datacenter by default)

Input Example — Advertiser Name + ID

{
  "region": "FR",
  "startDate": "2026-01-01",
  "endDate": "2026-05-25",
  "queryType": "2",
  "query": "LEVI STRAUSS & CO.",
  "advertiserBizId": "6886458055832109825",
  "maxAds": 10,
  "fetchDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}

Input Example — Keyword Search

{
  "region": "GB",
  "startDate": "2025-01-01",
  "endDate": "2026-01-01",
  "queryType": "1",
  "query": "football",
  "maxAds": 20,
  "fetchDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}

Input Example — Direct TikTok URL

{
  "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,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": []
  }
}

Output Example

[
  {
    "AD ID": "1867625146670401",
    "Advertiser Name": "COCA COLA HBCO",
    "Ad Title": "Wygrywaj!",
    "AD Preview": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/ogeDXpFKBIDvN8CAZcQgfBE5qTQpNiQBQaPYDB~tplv-tiktokx-origin.jpeg",
    "Ad Dates": [
      {
        "FirstShown": "2026-06-12",
        "FirstShownTimestamp": 1781222400
      },
      {
        "LastShown": "2026-06-14",
        "LastShownTimestamp": 1781395200
      }
    ],
    "Ad Audience": { "raw": "1M-10M", "min": 1000000, "max": 10000000 },
    "Ad Details": [
      { "Estimated Audience": "1M-10M" },
      { "Spent": "" },
      { "Type": "2" },
      { "Audit Status": "1" },
      { "Impression": "" },
      { "Sponsor": "MEDIACOM UK LIMITED" },
      { "Target Audience Size": "11.7M-14.2M" },
      { "Advertising Objective": "Reach" },
      { "Call To Action": "Learn more" },
      { "External URL": "https://cokeurl.com/KuM89D?utm_source=tiktok&utm_medium=paid" }
    ],
    "Ad Media": [
      "Video 1: https://library.tiktok.com/api/v1/cdn/1782079373/video/...",
      "Image 1: https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/ogeDXpFKBIDvN8CAZcQgfBE5qTQpNiQBQaPYDB~tplv-tiktokx-origin.jpeg"
    ],
    "Ad Targeting": {
      "regions": ["PL"],
      "age": ["18-24", "25-34", "35-44", "45-54", "55+"],
      "gender": ["female", "male", "unknown"],
      "languages": [],
      "cities": [],
      "provinces": [],
      "operating_systems": ["ALL"],
      "device_models": [],
      "high_spending_power": "No",
      "audience": "No",
      "audience_exclude": "No",
      "interest": "",
      "video_interactions": "",
      "creator_interactions": ""
    },
    "Ad Reach": {
      "total_region": 1,
      "total_impressions": { "raw": "1M-10M", "min": 1000000, "max": 10000000 },
      "by_country": [
        {
          "region": "PL",
          "impressions": { "raw": "1.5M", "min": 1500000, "max": 1500000 },
          "breakdowns": [
            { "age": "18-24", "gender": "MALE", "impressions": { "raw": "159K", "min": 159000, "max": 159000 } },
            { "age": "18-24", "gender": "FEMALE", "impressions": { "raw": "252K", "min": 252000, "max": 252000 } },
            { "age": "25-34", "gender": "MALE", "impressions": { "raw": "273K", "min": 273000, "max": 273000 } },
            { "age": "25-34", "gender": "FEMALE", "impressions": { "raw": "352K", "min": 352000, "max": 352000 } },
            { "age": "35-44", "gender": "MALE", "impressions": { "raw": "87K", "min": 87000, "max": 87000 } },
            { "age": "35-44", "gender": "FEMALE", "impressions": { "raw": "122K", "min": 122000, "max": 122000 } },
            { "age": "45-54", "gender": "MALE", "impressions": { "raw": "45K", "min": 45000, "max": 45000 } },
            { "age": "45-54", "gender": "FEMALE", "impressions": { "raw": "72K", "min": 72000, "max": 72000 } },
            { "age": "55-100", "gender": "MALE", "impressions": { "raw": "22K", "min": 22000, "max": 22000 } },
            { "age": "55-100", "gender": "FEMALE", "impressions": { "raw": "44K", "min": 44000, "max": 44000 } }
          ]
        }
      ]
    },
    "Advertiser": {
      "name": "COCA COLA HBC POLSKA SP Z O O",
      "adv_biz_ids": "6876461641299395330",
      "registry_location": "United Kingdom",
      "sponsor": "MEDIACOM UK LIMITED",
      "tiktok_account": {
        "username": "cocacola",
        "display_name": "Coca-Cola",
        "follower_count": "4.2M",
        "account_type": "BLUEV_BA",
        "avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/952fe5a47bd6d42729cbc4918730e2b5~tplv-tiktokx-cropcenter:168:168.jpeg",
        "profile_web_link": "https://www.tiktok.com/share/user/6808618235111736326?source=ad_review"
      }
    },
    "Ad Sponsor": "MEDIACOM UK LIMITED",
    "Ad Target Audience Size": { "raw": "11.7M-14.2M", "min": 11700000, "max": 14200000 },
    "Ad Detail URL": "https://library.tiktok.com/ads/detail/?ad_id=1867625146670401"
  }
]

🤝 Support & Resources

Need help? Have questions? We're here to help! If you encounter any issues or have feature requests, please don't hesitate to open an issue.

❤️ Love our scraper? Please leave a review here