TikTok Ads Library Scraper — Ad Reach, Dates & Creatives
Pricing
from $4.00 / 1,000 tiktok ad records
TikTok Ads Library Scraper — Ad Reach, Dates & Creatives
Search the TikTok Ads Library by keyword or advertiser. Export reach ranges, first and last shown dates, captions, landing pages and media. USD 5 per 1,000 ads.
Pricing
from $4.00 / 1,000 tiktok ad records
Rating
0.0
(0)
Developer
Muhammad Afzal
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
18 days ago
Last modified
Categories
Features
Share
TikTok Ads Library Scraper searches TikTok's public Ad Library (the Commercial Content Library) by keyword or advertiser name and returns each ad's advertiser, first and last shown dates, unique-users reach range, caption, objective, landing page, target countries, and media links. It is built for performance marketers, agencies, and ad researchers, and it costs USD 5.00 per 1,000 ads on the Apify Free tier plus a USD 0.01 start fee.
No TikTok login, cookies, browser, or proxy setup is needed. The Actor handles data access, follows result pages for you, and only charges for ads it saves.
What data does the TikTok Ads Library Scraper return?
It returns one dataset row per unique ad. Missing values are null or an empty array.
| Field | What it contains |
|---|---|
adId | TikTok Ad Library ad ID |
advertiser | Advertiser name shown in the library |
advertiserBusinessId | Advertiser business ID, when TikTok returns one |
firstShown, lastShown | First and last date the ad was shown (YYYY-MM-DD) |
uniqueUsersSeen | TikTok's published reach range, for example 1K-10K (a range, not an exact count) |
caption | Ad caption |
objective | Campaign objective, for example Traffic (with details enabled) |
destinationUrl | Landing page the ad links to (with details enabled) |
adCategory | TikTok's ad category, for example Food & Beverage |
targetCountries | Country codes the ad targeted, for example ["FR"] (with details enabled) |
videoUrls, imageUrls | Creative media links; these expire after a while |
adUrl | Public ad page, https://library.tiktok.com/ads/detail/?ad_id=<adId> |
searchUrl | Library search link for your query |
scrapedAt | Collection time (ISO 8601) |
The Actor does not return spend, impressions, clicks, likes, or conversion data, and it does not invent them.
When should I use it, and when not?
Use it when you want TikTok ads as structured rows instead of browsing the library page by page:
- See which ads a brand ran, when they started and stopped, and their reach range.
- Collect captions, objectives, and landing pages for a product category or keyword.
- Build a swipe file of video creatives with their dates.
- Check which European countries a competitor targeted.
Do not use it for:
- TikTok Creative Center "Top Ads". This Actor reads the Ad Library, not Top Ads, and has no CTR or likes.
- Country or date filters. The search has no country or date filter; filter the exported rows by
targetCountries,firstShown, orlastShown. - A full worldwide record. TikTok's Ad Library is a transparency database focused on ads shown in Europe, so it is not a complete list of every campaign, including US-only ones.
- TikTok Shop products and sales. Use TikTok Shop Scraper.
- LinkedIn or Meta ads. Use LinkedIn Ads Library Scraper or Facebook Ads Library Scraper.
How do I search the TikTok Ads Library by keyword or advertiser?
Put your term in query and pick a searchMode. Keyword mode (the default) matches ads by search term, which can include ads whose caption contains the word. Advertiser mode resolves the advertiser by name.
| Input | Use |
|---|---|
query | Keyword or advertiser name, 1–100 characters; default coffee |
searchMode | keyword (default) or advertiser |
advertiserBusinessId | Optional numeric ID that pins one advertiser; advertiser mode only, with the matching name in query |
maxResults | Unique ads to save, 1–100, default 10 |
includeDetails | Default true; adds objective, landing page, target countries, and extra video links with one more lookup per ad |
Keyword search:
{ "searchMode": "keyword", "query": "coffee", "maxResults": 10, "includeDetails": true }
Advertiser search:
{ "searchMode": "advertiser", "query": "Gymshark", "maxResults": 25 }
The default input finished in about 45 seconds on 2026-10-26 and returned 10 ads with details. Turn includeDetails off for faster runs when you only need dates, reach ranges, captions, and media. A run reads up to 10 result pages and stops new work after about two minutes, keeping every ad already saved.
Use it from an AI assistant
TikTok Ads Library Scraper works from Claude, ChatGPT, Cursor, or any MCP client through Apify's MCP server. Add this single-tool URL to your client: https://mcp.apify.com/?tools=muhammadafzal/tiktok-ads-library-scraper. Then ask, for example: "Find 20 TikTok ads for 'protein powder', list each advertiser's landing page and reach range, and tell me which ran longest."
How do I call it from the API?
JavaScript (apify-client):
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: process.env.APIFY_TOKEN });const run = await client.actor('muhammadafzal/tiktok-ads-library-scraper').call({searchMode: 'keyword',query: 'skincare',maxResults: 25,});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items.map((ad) => [ad.advertiser, ad.firstShown, ad.uniqueUsersSeen]));
Python (apify-client 3.x):
import osfrom apify_client import ApifyClientclient = ApifyClient(os.environ["APIFY_TOKEN"])run = client.actor("muhammadafzal/tiktok-ads-library-scraper").call(run_input={"searchMode": "advertiser", "query": "Gymshark", "maxResults": 25})for ad in client.dataset(run.default_dataset_id).iterate_items():print(ad["advertiser"], ad["firstShown"], ad["lastShown"], ad["destinationUrl"])
What does the output look like?
Two rows from the default coffee search (second row and media links shortened):
[{"adId": "1878615302877297","advertiser": "Miss Cookies Coffee","advertiserBusinessId": null,"firstShown": "2026-10-09","lastShown": "2026-10-22","uniqueUsersSeen": "1K-10K","caption": "Le grand retour de votre coffee shop Miss Cookies Coffee...","objective": "Traffic","destinationUrl": "https://misscookies.com","adCategory": "Food & Beverage","targetCountries": ["FR"],"videoUrls": [],"imageUrls": ["https://p19-common-sign.tiktokcdn.com/..."],"adUrl": "https://library.tiktok.com/ads/detail/?ad_id=1878615302877297","searchUrl": "https://library.tiktok.com/ads?adv_name=coffee","scrapedAt": "2026-10-26T07:45:06.359Z"},{"adId": "1878615307041938","advertiser": "Miss Cookies Coffee","firstShown": "2026-10-11","lastShown": "2026-10-22","uniqueUsersSeen": "0-1K","objective": "Traffic","targetCountries": ["FR"],"videoUrls": ["https://library.tiktok.com/api/v1/cdn/..."],"adUrl": "https://library.tiktok.com/ads/detail/?ad_id=1878615307041938"}]
The default key-value store also holds an OUTPUT record with the status (data, empty, rejected, blocked, or failed), delivered count, stop reason, and warnings.
Pricing: how much does TikTok ad data cost?
You pay per ad saved plus a small start fee. Platform usage is included in these prices.
| Event | FREE | BRONZE | SILVER | GOLD, PLATINUM, DIAMOND |
|---|---|---|---|---|
| TikTok ad record (per ad saved) | USD 0.005 | USD 0.004875 | USD 0.00475 | USD 0.004 |
| Actor start (per started GB of allocated memory) | USD 0.01 | USD 0.00975 | USD 0.0095 | USD 0.008 |
Worked totals on the FREE tier with the default 256 MB memory (one start event):
- 10 ads: 10 × USD 0.005 + USD 0.01 = USD 0.06
- 100 ads: 100 × USD 0.005 + USD 0.01 = USD 0.51 (USD 0.408 on GOLD)
The detail lookup is included in the per-ad price. An empty search or rejected input costs only the start fee.
How reliable is it, and what are the limits?
- Maximum 100 ads per run, 10 result pages, and about two minutes of active lookups.
- If a detail lookup fails for one ad, the ad is still saved with the search fields and a warning is added to
OUTPUT. - Access errors are reported as
blockedorfailed, never as an empty success. - Media links expire; download the creatives you need soon after the run.
FAQ
Does TikTok have an ads library?
Yes. TikTok's Ad Library (part of its Commercial Content Library at library.tiktok.com) is public. This Actor searches it and exports results as JSON, CSV, or Excel.
Can I see how many people saw a TikTok ad?
Partly. Each row has uniqueUsersSeen, TikTok's published reach range such as 1K-10K. Exact counts and spend are not published.
Can I filter by country or date?
Not in the search itself. Export the rows, then filter on targetCountries, firstShown, and lastShown.
Is this the same as TikTok Creative Center Top Ads?
No. Top Ads is a separate TikTok tool with engagement metrics. This Actor reads the Ad Library only.
How do I get every ad from one advertiser?
Use searchMode: "advertiser" with the advertiser's name. If several advertisers share the name, add advertiserBusinessId from a previous run's results to pin the right one.
Can I run it from an AI agent or on a schedule?
Yes. Use the MCP URL above from an AI assistant, or save the input as an Apify Task and attach a Schedule for weekly competitor checks.
Related Actors
- LinkedIn Ads Library Scraper: B2B ads from LinkedIn's Ad Library with copy, format, and payer label.
- Facebook Ads Library Scraper: ads from the Meta Ad Library for Facebook and Instagram.
- TikTok Shop Scraper: TikTok Shop products, sold counts, and sellers.
Legal and responsible use
This Actor collects only ads that TikTok publishes in its public Ad Library. It is not affiliated with or endorsed by TikTok. Follow TikTok's terms and applicable laws, respect creative copyright when you reuse media, and do not use the output for spam or harassment.
Last verified: 2026-10-27