Commercial Content LibraryCollect TikTok ads in the EU/EEA, UK and Switzerland. Watch the videos, compare offers and advertiser activity, and use what you find to plan tests for your own audience.
Try these examples for marketing, growth and competitor research.
For a beauty campaign in France, collect ads in the category and watch the available videos. Tag opening hooks, demonstrations and offers yourself, then choose angles to test with your audience.
Use a research sheet to keep the references and shortlist storyboard ideas.
Compare public ads in Germany and Spain. Check which advertisers appear, the assets they use and the languages in the creatives before deciding what to produce locally.
Keep source videos in a market brief, along with the localization questions you still need to answer.
Search a brand name and check whether each record belongs to the brand's registered entity or a creator handle. Keep both identities when you save the results.
Use the advertiser and creator list for partnership research.
FROM FIRST RUN TO REPEATABLE WORKFLOW
{
"searchTerms": ["Nike"],
"regions": ["FR"],
"maxAds": 50,
"adStatus": "all",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Paste this into the Actor’s JSON input editor. Replace the example targets with yours before running.
Check the current input form on ApifyThis is TikTok’s Commercial Content Library, covering the EU/EEA, the UK and Switzerland. It is the right tool for advertiser research in those markets. For US creative inspiration, use the Creative Center scraper instead.
| Search method | When to use it | What changes |
|---|---|---|
| Advertiser or brand name | When to use itYou have a competitor watchlist. | What changesSearch advertiser names, often registered legal entities rather than brand labels. Partial names, TikTok profiles and websites can resolve to a brand. A name with no ads may fall back to a keyword search. |
| Keyword discovery | When to use itYou want to find relevant results before choosing specific targets. | What changesSearch ad content for themes such as running shoes, independently of advertiser identity. Use this to discover companies you do not already track. |
| Advertiser IDs | When to use itYou know the exact entity you want to collect. | What changesTikTok’s numeric business identifiers. Use these for exact advertiser tracking without name matching. Copy an ID from a verified source record; do not substitute a TikTok username. |
| Ad Library URLs | When to use itYou already configured the search on the source website. | What changesPaste search links from library.tiktok.com. Their countries, dates, status and audience filters take precedence; the separate input fields fill missing values. |
Only the 32 listed markets are covered: EU/EEA, UK and Switzerland. Explicit countries run separately. An empty regions list searches all covered markets together; ["all"] searches each country separately. Unsupported countries are skipped. If none remain, the search covers all supported markets.
Compare the related scraperUse the exact field names below in JSON. In Apify’s form, enter list items separately, choose filters, and keep numbers and booleans in their proper types.
Default and prefill are different. A default applies when you omit a setting; a prefill is an example already entered in Apify’s form. Review prefilled targets and limits before every run. Some settings have no schema default. You still need to supply at least one supported target.
searchTermsSearch advertiser names, often registered legal entities rather than brand labels. Partial names, TikTok profiles and websites can resolve to a brand. A name with no ads may fall back to a keyword search.
searchTermOne advertiser name instead of a searchTerms list. Use the list for several competitors and an advertiserBusinessIds value when the exact entity is already known.
keywordsSearch ad content for themes such as running shoes, independently of advertiser identity. Use this to discover companies you do not already track.
advertiserBusinessIdsTikTok’s numeric business identifiers. Use these for exact advertiser tracking without name matching. Copy an ID from a verified source record; do not substitute a TikTok username.
adLibraryUrlsPaste search links from library.tiktok.com. Their countries, dates, status and audience filters take precedence; the separate input fields fill missing values.
regionsOnly the 32 listed markets are covered: EU/EEA, UK and Switzerland. Explicit countries run separately. An empty regions list searches all covered markets together; ["all"] searches each country separately. Unsupported countries are skipped. If none remain, the search covers all supported markets.
regionOne country alongside or instead of regions. Unlike Google Ads, this single-country field is combined with the list rather than only filling an empty list.
minDateFilters the date an ad was last shown, server-side. It is not a creation-date filter. Use YYYY-MM-DD; empty dates cover the library’s available archive rather than its website’s default 30-day view.
maxDateLast-shown dates must be on or before this day. Combine with minDate for a last-delivery window; an ad first launched months earlier can still match.
adTypeChoose all, video, image or text. This filters the creative format; it does not choose political versus commercial ads.
all video image textadStatusactive means running now, inactive means stopped, all includes both. Status and last-shown dates answer different questions, so set both deliberately.
all active inactivesortByChoose last-shown date, publication date or unique reach, ascending or descending. With a maxAds cap, sorting changes which portion of the matching ads you collect first.
last_shown_date,desc last_shown_date,asc create_time,desc create_time,asc impression,desc impression,ascgenderFilters the advertiser’s declared target gender: ALL, FEMALE or MALE. This is targeting metadata, not a measured breakdown of the people who actually watched the ad.
ALL FEMALE MALEagesTarget-age bands, as a list of strings. Use the comma-separated band values below, for example 18,24. Empty means every age; these are declared targets rather than measured viewers.
all 13,17 18,24 25,34 35,44 45,54 55,100adReachKeep ads in selected public reach bands: 0-10K, 10K-100K or 100K+. Empty means all bands. Do not read a band as an exact impression or conversion count.
all 0-10K 10K-100K 100K+proxyConfigurationResidential proxies are required. Datacenter exits can fail during session setup without an obvious blocking message. Keep the default RESIDENTIAL group before changing filters or dates to diagnose a failed run.
maxAdsA hard cap on unique ads across the whole run, including all targets and markets. Start with 50. Leaving it empty removes this cap; a broad search can then become much larger.
maxPagesLimits pages for each country-search job. The effective page size is at most 12 ads, even if older descriptions mention larger batches. Clear for full pagination within your result cap.
pageSize1-12 ads per request. Values above 12 are read as 12 because TikTok caps its page size. Increasing maxPages changes depth; increasing pageSize beyond 12 does not.
delayMsPause between page requests, in milliseconds. Increase it when the source throttles you; reducing it does not remove network delays or the source’s rate limits.
rawReturns TikTok’s untouched records. Unlike the normal output, dates are not converted and encoded media URLs are not decoded. Keep false for a spreadsheet-ready dataset.
proxyRotationsRetries refused work with a new proxy session. More retries can recover temporary blocks but add time and traffic. Keep the default until the log shows a reason to change it.
resumeSaves progress about every 30 seconds so an Apify restart or migration can continue the current run. Leave it on for normal use.
continueFromLastRunContinues unfinished work from the previous run with matching input. Earlier results remain in that run’s dataset. Keep false for a fresh collection or a recurring snapshot.
This reference follows the Actor’s published input fields. Check the live form before changing a production workflow. Check the current input form on Apify.
Each example is a separate run. Start small, inspect the results, then increase coverage. Update the targets, countries and dates to match your question.
Collect up to 50 active ads shown in the UK. Check legal advertiser names in the output before scheduling. Keep the same country and filters for each weekly snapshot.
{
"searchTerms": ["Nike"],
"regions": ["GB"],
"adStatus": "active",
"maxAds": 50,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Look for skincare video ads in France targeting ages 25 to 34 with the 100K+ reach band. These filters can produce a small or empty sample. Remove reach and age filters one at a time if you need broader discovery.
{
"keywords": ["skincare"],
"regions": ["FR"],
"adType": "video",
"ages": ["25,34"],
"adReach": ["100K+"],
"sortBy": "last_shown_date,desc",
"maxAds": 50,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Search Germany and France with a last-shown date window. The same ad can appear in both searches and is kept once. Do not add up country counts from this deduplicated output as though they were separate ad inventories.
{
"searchTerms": ["Nike"],
"regions": ["DE", "FR"],
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 100,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": ["RESIDENTIAL"]
}
}Keep the ad ID, legal advertiser name, source URL, media and first/last shown dates. Reach may be a band, while spend and impression fields may be empty. These records do not show conversions or prove an ad worked. Save media references promptly because URLs can expire, and keep country-search context when building comparisons.
resume protects the current run if Apify restarts it. continueFromLastRun continues an earlier run with the same configuration; earlier records stay in the earlier dataset. Combine both datasets for the complete collection, and raise a previously reached result cap when continuing. Start fresh when you want to see what changed today.
Save one configuration above as input.json. Set APIFY_TOKEN to your Apify API token in your terminal, then send the file as the request body.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~tiktok-ad-library-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonThe response contains a run ID and defaultDatasetId, not finished results. Wait for the run to succeed, set DATASET_ID to that dataset ID, then fetch its items. For large datasets, use limit and offset to page through the export.
curl --fail-with-body \
--url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
--header "Authorization: Bearer $APIFY_TOKEN"Change one setting at a time, keep a small cap, and check the run summary before scaling up.
Only the 32 listed markets are covered: EU/EEA, UK and Switzerland. Explicit countries run separately. An empty regions list searches all covered markets together; ["all"] searches each country separately. Unsupported countries are skipped. If none remain, the search covers all supported markets.
Residential proxies are required. Datacenter exits can fail during session setup without an obvious blocking message. Keep the default RESIDENTIAL group before changing filters or dates to diagnose a failed run.
Keep the ad ID, legal advertiser name, source URL, media and first/last shown dates. Reach may be a band, while spend and impression fields may be empty. These records do not show conversions or prove an ad worked. Save media references promptly because URLs can expire, and keep country-search context when building comparisons.
Success means the Actor finished handling the request, not that the source returned data. Check SUMMARY.inputProblem, SUMMARY.problem and the log for missing targets, unsupported filters or refused requests. Test one known target with fewer filters.
Check the global limit, per-search or per-page limits, platform coverage and deduplication. Several searches can find the same record. A source’s headline count can include records the public endpoint does not return. Review unfinished jobs before treating the dataset as complete.
Append ad_id, advertiser_name, scraped_region, first_shown, last_shown and media_url. Watch the videos before adding labels for hooks, formats and product angles.
Read the setupAsk Claude to organize the metadata and cite the source records. For video analysis, give it the media or a transcript through a supported workflow. Metadata alone won't show the opening hook.
Read the setupCompare ad activity by advertiser and region. Keep reach as a band, and don't add repeated regional observations together as though they were unique people.
Read the setupKeep raw observations and a creative table keyed by ad_id. Store regional observations separately and retain the original reach bands.
Read the setup
Check the schema of jmlp/tiktok-ad-library-scraper and collect up to 50 Nike-related records in FR. Separate advertiser entities from creator handles, summarize delivery dates and available reach bands, and cite ad_library_url. Flag unavailable spend and impression data. Do not describe video content you have not inspected.Keep the collection time and original IDs with your records. You’ll need them to check where a result came from or compare it with a later run.
This scraper covers 32 supported markets in the EU/EEA, UK and Switzerland. Spend and impression fields can be empty; estimated_audience contains available reach bands. Those bands and dates do not show conversions or ROAS. Media links can expire.
This Actor targets the official Commercial Content Library’s supported markets in the EU/EEA, UK and Switzerland. It does not provide US or worldwide ad coverage.
The scraper returns media links and metadata. Video-content analysis needs access to the actual media or a transcript and a compatible analysis workflow.
Source and current product details: JMLP’s TikTok Ad Library Actor on Apify.
Facebook & Instagram01See what your competitors are advertising.
Save competitor ads in one place. Compare their copy, offers and timing before planning your next campaign.
Search, YouTube & Display02See a brand's ads across Google.
Collect advertiser creatives from Search, YouTube and Display. Compare formats and markets to plan where your own campaign might fit.
Tell me what you need to collect or understand. I can help with a custom scraper, a pipeline or the analysis.
Start a project