TikTok Ad Library Scraper (TikTok Ads Library)
Pricing
from $1.50 / 1,000 ad scrapeds
TikTok Ad Library Scraper (TikTok Ads Library)
Extract ads from TikTok's Commercial Content Library: advertiser, ad video, run dates, estimated audience and category for ads shown in Europe.
Pricing
from $1.50 / 1,000 ad scrapeds
Rating
0.0
(0)
Developer
PulseData
Maintained by CommunityActor stats
0
Bookmarked
4
Total users
2
Monthly active users
2 hours ago
Last modified
Categories
Features
Share
This actor extracts ads from TikTok's official Commercial Content Library, the ad repository TikTok publishes for Europe. You search by advertiser or by what the ad says and get one JSON item per ad with the advertiser, the ad video, run dates, estimated audience and the ad's category. It costs $1.50 per 1,000 ads plus a run start fee of $0.005 per GB of memory, which is $0.01 per run at the default 2 GB.
No TikTok account, cookies or login are needed.
Features
- Scrape all TikTok ads of a competitor by advertiser name.
- Search TikTok ads by keyword in the ad content, with double quotes for an exact phrase.
- Download TikTok ad videos: a direct MP4 link and cover image for each creative.
- Get TikTok ads for one European country with
countryCode. - Filter TikTok ads by the date they were shown with
startDateandendDate. - Track new TikTok ads of a competitor with a scheduled run that returns only ads not delivered before.
- Export TikTok Ad Library data to CSV, Excel or JSON through the Apify dataset.
Use cases
- Competitor and creative research: which videos a brand runs right now, how long each has been live, the estimated audience, and the videos for a swipe file.
- Category overview: search a keyword and see which advertisers push that product type in a country.
- Agency pitches and brand monitoring: what a prospect's competitors run on TikTok, or which ads use your brand name.
Input
{"queries": ["Nike", "\"running shoes\""],"countryCode": "DE","startDate": "2026-06-01","endDate": "2026-09-20","maxAdsPerQuery": 200}
| Field | Type | Default | Meaning |
|---|---|---|---|
queries | array | (required) | Advertiser names or keywords, one per line. The library matches both. Wrap a phrase in double quotes for an exact match |
countryCode | string | DE | Which country's library to search: DE, FR, ES, IT, NL, PL, GB and other EU/EEA countries plus the UK and Switzerland |
startDate | date | 90 days before endDate | Start of the period an ad was shown, YYYY-MM-DD |
endDate | date | today | End of that period |
maxAdsPerQuery | integer | 100 | 0 means no limit |
onlyNewAds | boolean | false | Monitor mode: output and charge only ads not delivered on an earlier run |
monitorStoreName | string | empty | Key-value store that remembers delivered ads. Empty means a name derived from the queries, country and dates |
proxyConfiguration | object | Apify residential | TikTok challenges datacenter IPs. The Unblocker also works. If the browser cannot get through the group you pick, the run tries new exit IPs and then switches between RESIDENTIAL and UNBLOCKER on its own |
debugDump | boolean | false | Saves a screenshot and the page HTML to the key-value store, only for bug reports |
Output
One item per ad:
{"query": "Nike","region": "DE","adId": "1876613526161602","url": "https://library.tiktok.com/ads/detail/?ad_id=1876613526161602®ion=DE","advertiserName": "Unisport A/S","title": "#sneakers #custom #nike","subject": "Apparel & Accessories","firstShown": "2026-09-17","lastShown": "2026-09-19","daysShown": 3,"estimatedAudience": "10K-100K","impressions": null,"spent": null,"videoUrl": "https://library.tiktok.com/api/v1/cdn/.../video/...mp4","coverImageUrl": "https://p16-common-sign.tiktokcdn.com/...","videoUrls": ["https://library.tiktok.com/api/v1/cdn/.../video/...mp4"],"imageUrls": [],"adStatus": "approved","rejectionInfo": null,"scrapedAt": "2026-09-25T08:00:00.000Z"}
title is the ad caption with hashtags, subject is TikTok's category, and estimatedAudience is TikTok's range of unique users reached. impressions and spent are filled only where TikTok publishes them. adStatus is TikTok's review status for the ad (in our tests always approved). Where TikTok restricted the ad in one or more countries, rejectionInfo holds the reason and the affected regions.
Track new TikTok ads of a competitor
Turn on onlyNewAds to get only the ads an advertiser launched since your last run:
{ "queries": ["Nike"], "countryCode": "DE", "maxAdsPerQuery": 0, "onlyNewAds": true }
The actor stores the ID of every delivered ad in a key-value store in your Apify account; on later runs those ads are neither output nor charged. The first run returns every ad up to maxAdsPerQuery and fills the store. Save the input as a task, add an Apify schedule and an integration (email, Slack, Google Sheets, Make, Zapier or a webhook).
maxAdsPerQuerysets how far down the list a run looks, and ads seen before count towards it. Use0to watch every ad.- Without
monitorStoreNameeach different input keeps its own history; the run log names the store. - Leave
startDateandendDateempty for a monitor, so the default window moves with each run while the store name stays the same. - An ad cut off by the run timeout or the maximum cost per run is not remembered and comes on the next run.
- Schedule one run per store; two parallel runs can both deliver the same new ad.
Coverage and limits
TikTok publishes this library for the EU and EEA plus the UK and Switzerland. Ads that only ran outside those countries are not in it. One run searches one country.
The date filter matches the period an ad was shown, not when it was created. TikTok keeps ads in the library for a limited time, so a long lookback can return less than you expect. Results are sorted by last shown date, newest first.
The library signs its API calls in the browser, so the actor uses a headless browser and runs with 2 GB of memory by default. A query of 200 ads takes roughly a minute.
Pricing
| Event | Price |
|---|---|
ad-scraped, per ad returned | $0.0015 |
apify-actor-start, per run | $0.005 per GB of run memory ($0.01 at the default 2 GB) |
Worked example: 200 ads of one advertiser at the default memory cost 200 × $0.0015 + $0.01 = $0.31.
In monitor mode (onlyNewAds) only new ads are charged. A daily run that finds 10 new ads costs 10 × $0.0015 + $0.01 = $0.025, and a run with nothing new costs only the $0.01 start.
FAQ
Do I need a TikTok account? No. The Commercial Content Library is public and the actor never logs in.
Can I download the videos?
videoUrl is a direct MP4 link from TikTok's CDN. The links are signed and expire after a few hours, so download them soon after the run.
Does the search look at the advertiser or at the ad text? Both. TikTok's library has one search box for advertiser name or keyword, and so does this actor.
Why do I get fewer ads than the total in the log?
maxAdsPerQuery caps each query, and TikTok sometimes returns the same ad on two pages. The actor removes those duplicates.
Does it return every ad in the library, or only active ones?
Every ad in the library that matches the query and the date range, including ads TikTok moderated in another country, with the reason and the affected regions in rejectionInfo.
Does it return targeting or spend?
No targeting fields. spent and impressions are passed through only when TikTok includes them.
Can I schedule it or call it via API? Yes. Save a task, add an Apify schedule, and fetch the dataset through the API, or send it to Google Sheets, Make, Zapier or n8n.
Use it from Claude, ChatGPT or Cursor (Apify MCP server)
Any AI assistant that speaks the Model Context Protocol can call this actor. Add the Apify MCP server with this URL:
https://mcp.apify.com?tools=pulsedata/tiktok-ad-library-scraper
Then ask in plain language, for example "list the TikTok ads Zalando ran in France since September", and the assistant fills the input, runs the actor and reads the ads back. Billing is the same as a normal run.
Paying from an AI agent without an Apify account (x402 and Skyfire)
An agent can buy a prepaid, spend-capped Apify token at Apify AGI, paid in USDC through x402 or from a Skyfire wallet, and use it for both the API and the MCP server. This actor runs with limited permissions, so it works with these tokens. The smallest token is $1, tokens expire 14 days after purchase, and Apify marks agentic payments as experimental.
Example pages
- Find TikTok ads about a product or topic
- Download the ad videos a brand runs on TikTok
- See every TikTok ad a competitor runs
- TikTok ads shown in France
- What a brand advertised on TikTok last quarter
- TikTok ads shown in Germany
- TikTok ads shown in Italy
- Track the TikTok ads of several competitors
Related actors
- LinkedIn Ad Library Scraper: B2B ads with impressions per country and the advertiser's targeting.
- Google Ads Transparency Center Scraper: Search, YouTube, Shopping, Maps and Play ads of the same brands.
- Website Tech Stack Detector: the ad and analytics tags on an advertiser's landing pages.
- App Store & Google Play Scraper: app listings and reviews for the apps behind the ads.