TikTok Ads Library Scraper

Scrape TikTok Commercial Content Library ads by keyword, advertiser, advertiser business ID, country, date range, or direct ad URL. This Actor extracts structured TikTok ad data including advertiser names, business IDs, sponsors, registry locations, first and last shown dates, estimated audience buckets, creative image URLs, video URLs, and targeting metadata.

Use it to monitor competitor TikTok ads, collect winning ad creatives, research paid social hooks, audit advertising activity, track sponsor relationships, and export TikTok ad intelligence to CSV, JSON, Excel, Google Sheets, Make, Zapier, or your own API workflow.

What can this TikTok Ads scraper do?

• Search TikTok ads by keyword or phrase
• Search by advertiser name
• Search exact advertisers by TikTok advertiser business ID
• Enrich direct TikTok Ad Library URLs or numeric ad IDs
• Filter by one or more country codes
• Pass TikTok date-range filters
• Sort by last shown date, first shown date, or audience size
• Post-filter by creative format, target region, and estimated audience bucket
• Use quick search mode when you only need search-card fields
• Fetch paginated search results from TikTok's public ad library API
• Fetch detail pages for sponsor, registry, targeting, and richer media fields
• Export structured ad data to Apify datasets
• Run on schedules for competitor ad monitoring
• Use Apify residential proxies on every run for production reliability

What data can you extract from TikTok Commercial Content Library?

Field	Description
adId	TikTok Commercial Content Library ad ID
adUrl	Direct TikTok Ad Library detail URL
advertiserName	Advertiser shown by TikTok
advertiserBusinessId	TikTok advertiser business ID from detail pages
advertiserRegistryLocation	Advertiser registry location when available
sponsorName	Sponsor or agency shown on the ad detail page
firstShownAt	First shown timestamp
lastShownAt	Last shown timestamp
estimatedAudience	TikTok estimated audience bucket
estimatedAudienceLower	Parsed lower bound of the audience bucket
estimatedAudienceUpper	Parsed upper bound of the audience bucket
adFormat	Video, Image, or Live Room when detectable
imageUrls	Creative image URLs
videos	Video URL and cover image URL pairs
targetLocations	Targeted countries and impression buckets
targetAges	Age targeting flags by region
targetGenders	Gender targeting flags by region
targetAudienceSize	Estimated targetable audience size
daysActive	Derived number of days between first and last shown dates
resultPosition	Position in search results
countries	Country filters used for the run
scrapedAt	Timestamp when the row was saved

How to scrape TikTok ads

1. Choose your search method: keywords, advertiser names, advertiser business IDs, or direct ad URLs.
2. Add one or more country codes such as GB, DE, FR, NL, ES, IT, or CH.
3. Set dateFrom and dateTo if you want a specific last-shown window.
4. Set maxAds and maxPages to control result size.
5. Keep includeDetails enabled if you want sponsor, registry, advertiser business ID, and targeting metadata.
6. Run the Actor and export the dataset in JSON, CSV, Excel, XML, RSS, or HTML from Apify.

Input examples

Search competitor ads by keyword

{
  "keywords": ["nike", "running shoes"],
  "countries": ["GB"],
  "maxAds": 100,
  "maxPages": 5,
  "adFormats": ["Video"],
  "includeDetails": true
}

Search by advertiser

{
  "advertiserNames": ["NIKE Retail B.V.", "JD SPORTS FASHION PLC"],
  "countries": ["GB"],
  "dateFrom": "2026-04-27",
  "dateTo": "2026-05-27",
  "regionFilter": ["GB"],
  "minAudienceLower": 100000,
  "maxAds": 250,
  "includeDetails": true
}

Enrich specific TikTok ad URLs

{
  "adUrls": [
    "https://library.tiktok.com/ads/detail/1850594343314561",
    "1850594317256754"
  ],
  "includeDetails": true
}

Output example

{
  "sourceType": "search",
  "query": "nike",
  "countries": ["GB"],
  "resultPosition": 4,
  "adId": "1850594343314561",
  "adUrl": "https://library.tiktok.com/ads/detail/1850594343314561",
  "advertiserName": "NIKE Retail B.V.",
  "advertiserBusinessId": "6876453864464188162",
  "advertiserRegistryLocation": "Netherlands",
  "sponsorName": "INITIATIVE MEDIA B.V.",
  "firstShownAt": "2025-12-05T00:00:00.000Z",
  "lastShownAt": "2026-05-26T00:00:00.000Z",
  "estimatedAudience": "400K-500K",
  "estimatedAudienceLower": 400000,
  "estimatedAudienceUpper": 500000,
  "adFormat": "Video",
  "videos": [
    {
      "videoUrl": "https://library.tiktok.com/api/v1/cdn/...",
      "coverImageUrl": "https://p16-common-sign.tiktokcdn.com/..."
    }
  ],
  "targetAudienceSize": "15.9M-19.5M",
  "daysActive": 173,
  "detailFetched": true,
  "scrapedAt": "2026-05-27T22:56:02.374Z"
}

Search methods and filters

Capability	Supported
Keyword search	Yes
Advertiser name search	Yes
Advertiser business ID search	Yes
Direct ad URL enrichment	Yes
Numeric ad ID enrichment	Yes
Country filters	Yes
Date range filters	Yes
Ad type filter	Yes
Sort order	Yes
Creative format post-filter	Yes
Target region post-filter	Yes
Audience bucket post-filter	Yes
Quick search mode	Yes
Search pagination	Yes
Full detail-page enrichment	Yes
Video creative URLs	Yes
Image creative URLs	Yes
Sponsor and registry metadata	Yes
Targeting metadata	Yes
Forced Apify Residential Proxy	Yes

Pricing and cost expectations

This Actor is designed for pay-per-result pricing. A typical run can scrape the first 100 fully enriched TikTok ads for a keyword or advertiser in a few minutes. Detail enrichment makes one extra request per ad, so disabling includeDetails can make preview-only runs faster and cheaper.

The Actor always uses Apify residential proxies. For small tests, lower maxAds to 10 or 25. For scheduled monitoring, run daily with the same keyword or advertiser inputs and deduplicate by adId in your downstream workflow.

Why use this Actor?

TikTok ad research is valuable for performance marketers, agencies, ecommerce teams, SaaS founders, and creative strategists who need to understand which hooks, offers, products, and creatives are currently active.

This scraper helps answer questions like:

• What TikTok ads are competitors running?
• Which advertisers and sponsors are active in a category?
• Which creatives are videos vs images?
• Which ads have broad or narrow estimated reach?
• Which audiences, ages, genders, and countries are being targeted?
• Which campaigns are still active or recently shown?

Because it runs on Apify, you also get scheduling, API access, datasets, webhooks, proxy rotation, and integrations without maintaining your own server.