TikTok Ads Library Scraper — Ad Reach, Dates & Creatives avatar

TikTok Ads Library Scraper — Ad Reach, Dates & Creatives

Pricing

from $4.00 / 1,000 tiktok ad records

Go to Apify Store
TikTok Ads Library Scraper — Ad Reach, Dates & Creatives

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

Muhammad Afzal

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

18 days ago

Last modified

Features

Limited permissions

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.

FieldWhat it contains
adIdTikTok Ad Library ad ID
advertiserAdvertiser name shown in the library
advertiserBusinessIdAdvertiser business ID, when TikTok returns one
firstShown, lastShownFirst and last date the ad was shown (YYYY-MM-DD)
uniqueUsersSeenTikTok's published reach range, for example 1K-10K (a range, not an exact count)
captionAd caption
objectiveCampaign objective, for example Traffic (with details enabled)
destinationUrlLanding page the ad links to (with details enabled)
adCategoryTikTok's ad category, for example Food & Beverage
targetCountriesCountry codes the ad targeted, for example ["FR"] (with details enabled)
videoUrls, imageUrlsCreative media links; these expire after a while
adUrlPublic ad page, https://library.tiktok.com/ads/detail/?ad_id=<adId>
searchUrlLibrary search link for your query
scrapedAtCollection 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, or lastShown.
  • 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.

InputUse
queryKeyword or advertiser name, 1–100 characters; default coffee
searchModekeyword (default) or advertiser
advertiserBusinessIdOptional numeric ID that pins one advertiser; advertiser mode only, with the matching name in query
maxResultsUnique ads to save, 1–100, default 10
includeDetailsDefault 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 os
from apify_client import ApifyClient
client = 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.

EventFREEBRONZESILVERGOLD, PLATINUM, DIAMOND
TikTok ad record (per ad saved)USD 0.005USD 0.004875USD 0.00475USD 0.004
Actor start (per started GB of allocated memory)USD 0.01USD 0.00975USD 0.0095USD 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 blocked or failed, 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.

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