TikTok Ad Library Scraper

TikTok Ad Library Scraper extracts ads from the TikTok Commercial Content Library into clean, structured data you can download as JSON, CSV, Excel, or HTML. Type an advertiser name or keyword, or paste a TikTok ad library URL, and get the advertiser, caption, video, first and last shown dates, unique users seen, landing page, and full audience targeting by country, age, and gender for every ad. No account or login required.

Introduction

The TikTok Commercial Content Library is TikTok's public ad library. It lists the ads shown to users in Europe (the EU, the UK, Switzerland, Norway, Iceland, Liechtenstein, and Turkey), together with who paid for them, how many people saw them, and which audiences they targeted.

This TikTok ad library scraper collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can use it as a TikTok ads API alternative: run it once, schedule it to run daily, or connect it to your own tools.

What data can you extract from the TikTok ad library?

• 🆔 Ad ID and direct link to each ad
• 🏢 Advertiser name, advertiser ID, who paid for the ad, registered location, and a link to all ads of the advertiser
• 📝 Ad caption, ad category, advertising objective, call to action, and landing page URL
• 🎬 Ad videos with cover images, and ad images
• 📅 First shown and last shown dates
• 👥 Unique users seen, in total and per country
• 🎯 Targeting: countries, age groups, genders, reach per age and gender, target audience size, provinces, cities, languages, operating systems, devices, interests, and custom audiences
• 🚫 Whether the ad was removed by TikTok

Use Cases

• 📈 Market research: see which brands advertise on TikTok in each European country, and how big their campaigns are.
• 🕵️ Competitor monitoring: follow every new ad of a competitor, with its creative, landing page, and target audience.
• 🎨 Creative inspiration: collect ad videos and captions in your industry to find what works.
• 🤝 Lead generation: build a list of advertisers active on TikTok, with their registered country.
• 🤖 AI and automation: feed clean, structured ad data into spreadsheets, dashboards, or AI workflows.

How to scrape the TikTok ad library step by step

1. Type advertiser names or keywords into Search queries, or paste TikTok ad library URLs into Start URLs.
2. Optionally pick the Ad target country, the date range, and other filters for your search queries.
3. Set Maximum number of results to how many ads you want per query or per URL.
4. Click Start and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the Output tab.

Input

• Search queries: advertiser names or keywords, one per line. Wrap a query in double quotes (for example "adidas") for an exact phrase match. Each query is scraped separately.
• Start URLs: TikTok ad library search URLs (library.tiktok.com/ads?...) or single ad URLs (library.tiktok.com/ads/detail/?ad_id=...). All filters in a search URL are kept, including the advertiser pages opened from "See all ads".
• Ad target country: the European country where the ads were shown, or all countries.
• Last shown from and Last shown until: date range of the ads. By default the last 12 months are searched. The range can be at most 365 days.
• Ad type: all ads, video, image, or text.
• Ad status: all, active, or inactive ads.
• Target age: only ads targeting these age groups.
• Target gender: only ads targeting women or men.
• Unique users seen: only ads with this reach (under 10K, 10K to 100K, over 100K).
• Sort by: last shown date, published date, or unique users seen.
• Include ad details: adds the advertiser ID, payer, registered location, ad category, objective, landing page, and full targeting. Turn it off for a faster run with the search result data only.
• Maximum number of results: how many ads to collect for each search query or start URL. Use 0 for no limit.
• Proxy configuration: Apify Proxy is enabled by default for stable results.

The country, date, type, status, age, gender, reach, and sort filters apply to search queries. Start URLs keep the filters in the URL. You can use search queries, start URLs, or both in the same run.

Input Examples

Search ads by advertiser name or keyword:

{
  "searchQueries": ["nike"],
  "country": "all",
  "adType": "all",
  "adStatus": "all",
  "gender": "all",
  "sortBy": "lastShownNewest",
  "includeDetails": true,
  "maxResults": 5,
  "proxyConfiguration": { "useApifyProxy": true }
}

Scrape a TikTok ad library search URL:

{
  "startUrls": [
    {
      "url": "https://library.tiktok.com/ads?region=FR&start_time=1761955200000&end_time=1793059200000&adv_name=adidas&adv_biz_ids=&query_type=1&sort_type=last_shown_date,desc&ad_type=0&ad_status=0&ages=all&ad_reach=all&gender=ALL"
    }
  ],
  "includeDetails": true,
  "maxResults": 5,
  "proxyConfiguration": { "useApifyProxy": true }
}

Output

Each ad is saved as one item in the dataset. Here is an example of a single item:

{
  "url": "https://library.tiktok.com/ads/detail/?ad_id=1870887754684786",
  "adId": "1870887754684786",
  "advertiserName": "Snipes SE",
  "advertiserId": "6876496928549372673",
  "paidBy": "SNIPES SE",
  "advertiserRegisteredLocation": "Germany",
  "advertiserUrl": "https://library.tiktok.com/ads?adv_name=Snipes+SE&region=all&query_type=2&adv_biz_ids=6876496928549372673",
  "caption": "Retrouve les derniers articles adidas sur SNIPES",
  "adCategory": "Apparel & Accessories",
  "advertisingObjective": "Sales",
  "callToAction": "Buy now",
  "externalUrl": "https://www.snipes.com/fr-fr/b/femmes/new-balance-391?utm_source=tiktok&utm_id=__CAMPAIGN_ID__&utm_campaign=__CAMPAIGN_NAME__&utm_medium=social_paid_pf",
  "firstShownDate": "2026-07-16T00:00:00.000Z",
  "lastShownDate": "2026-09-15T00:00:00.000Z",
  "uniqueUsersSeen": "10K-100K",
  "isRemoved": false,
  "videos": [],
  "imageUrls": [],
  "targetCountries": ["FR"],
  "targetAudienceSize": "14.5M-17.8M",
  "targetingByCountry": [
    {
      "country": "FR",
      "uniqueUsersSeen": "57K",
      "ages": ["18-24", "25-34", "35-44", "45-54", "55+"],
      "genders": ["female"],
      "breakdown": [
        { "age": "18-24", "gender": "female", "uniqueUsersSeen": "20K" },
        { "age": "25-34", "gender": "female", "uniqueUsersSeen": "25K" },
        { "age": "35-44", "gender": "female", "uniqueUsersSeen": "8K" },
        { "age": "45-54", "gender": "female", "uniqueUsersSeen": "5K" },
        { "age": "55+", "gender": "female", "uniqueUsersSeen": "2K" }
      ]
    }
  ],
  "targetProvinces": [],
  "targetCities": [],
  "targetLanguages": [],
  "targetOperatingSystems": ["ALL"],
  "targetDeviceModels": [],
  "interestTargeting": null,
  "videoInteractionTargeting": null,
  "creatorInteractionTargeting": null,
  "customAudience": "No",
  "excludedAudience": "No",
  "highSpendingPower": "No"
}

Video ads include their video link and cover image in videos, for example { "videoUrl": "https://library.tiktok.com/...", "coverImageUrl": "https://p16-common-sign.tiktokcdn.com/..." }.

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

Notes

• The library only covers ads shown in Europe (the EU, the UK, Switzerland, Norway, Iceland, Liechtenstein, and Turkey). Other TikTok pages and websites are skipped.
• TikTok returns at most 5,000 ads per search. For bigger advertisers, split the search by country, date range, or other filters.
• The date range of one search can be at most 365 days. A start URL without dates uses the library default of the last month.
• With Include ad details turned off, the advertiser ID, payer, category, objective, landing page, and targeting fields are empty.
• Ads removed by TikTok for a policy violation are marked with isRemoved: true and have no advertiser name, video, or caption.
• Reach numbers are ranges or rounded values, exactly as TikTok shows them. Small age and gender segments are hidden by TikTok and left out of breakdown.
• Video and image links are signed by TikTok and expire after some time, so download the media soon after the run if you need it.
• The same ad found by two queries in one run is saved only once.

Why use the TikTok Ad Library Scraper?

• ✅ No login needed: works with public data only, so there is no account to manage.
• 🎯 All library filters: country, date range, ad type, status, age, gender, reach, and sort order, or paste any search URL from your browser.
• 🧾 Full targeting in one item: reach per country, age, and gender, plus audience settings, without extra steps.
• 🧹 Clean data: dates use one standard format and every item has the same fields.
• 🔄 Ready for automation: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

FAQ

How many ads can I scrape?

You can set any number in Maximum number of results. The actor keeps going until it reaches your limit or runs out of ads. See Notes for the limits set by TikTok.

Do I need a TikTok account?

No. The actor only collects publicly available data from the TikTok ad library. You do not need to log in or provide any account details.

Can I get all ads of one advertiser?

Yes. Open the advertiser's "See all ads" page in the library and paste its URL into Start URLs, or use the advertiserUrl value from a previous run.

Can I scrape ads on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh ads automatically.

Can I request a new feature or filter?

Yes. Right now the actor supports search queries, start URLs, and all filters of the ad library. If you need something else, such as other TikTok commercial content, get in touch and it can be added.

Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

---

Need help or want a custom solution?

• 📧 Email: aboo.script@gmail.com
• 🧩 More scrapers: Apify profile

Image Credit

Image credit: TikTok Commercial Content Library