TikTok Ads Library Scraper

TikTok Ads Library and commercial content scraper — scrape paid TikTok ads, advertiser transparency data, creator partnerships, branded posts, and disclosed promos from library.tiktok.com. Paste a filtered Ads Library URL or build a search in Advanced mode. Export advertiser names, ad creatives, targeting, reach, creator usernames, brand names, video URLs, and post dates to JSON, CSV, Excel, or the Apify API.

---

🤩 Features

• 🔗 URL-first workflow — copy a filtered TikTok Ads Library link and run
• 📢 TikTok Ads Library — paid ads by advertiser, keyword, country, and date range
• 🤝 Other commercial content — creator partnerships and branded TikTok posts
• 🎯 Deep ad intel — optional extra fields: targeting, reach, demographics, interests
• 🌍 EU, UK, Switzerland & Turkey — the same countries TikTok exposes in the library
• 🧰 Advanced mode — build searches without a URL when you need full control
• 📊 Export-ready rows — JSON, CSV, Excel, or pull via Apify API
• ⚡ Speed and reliability are built into our DNA 😉

---

📚 How to use

1. Register for a free Apify account — no credit card required.
2. Open the actor, fill in Input, start a run.
3. Open TikTok Ads Library, pick Ad Library or Other commercial content, set filters, and copy the URL into Library URL — or use Advanced (power users) without a URL.
4. Set Max items and run.

---

🤔 Why scrape TikTok Ads Library?

• Spy on competitor TikTok ad creatives and messaging
• Track which brands are running paid ads in your market
• Build swipe files for creative and UGC research
• Monitor disclosed creator partnerships and paid collaborations
• Feed dashboards, alerts, CRM, or research pipelines with fresh ad data
• Cover transparency markets: EU/EEA, UK, Switzerland, and Turkey

---

🤑 Cost / Pricing

$0.50 per 1,000 results (ad or commercial content row).

Extract ad details (extractDetails: true, Ad Library only): +$0.50 per 1,000 → $1.00 per 1,000 total.

Results scraped	Base only	With extractDetails
100	$0.05	$0.10
500	$0.25	$0.50
1,000	$0.50	$1.00
5,000	$2.50	$5.00
10,000	$5.00	$10.00

Examples

• 250 TikTok ads (summary only) → $0.13
• 250 TikTok ads with targeting & reach details → $0.25
• 1,000 branded creator posts → $0.50 (extractDetails ignored)

---

🆓 Free tier limitations

Free users are typically limited to:

• 5 items per run
• 5 runs per day (UTC)
• 30 minutes between runs

Upgrade to a paid Apify plan to drop these caps and run at volume.

---

🛠️ Input

Field	Type	Description	Default / Example
startUrl	string	TikTok Ads Library URL from library.tiktok.com/ads or library.tiktok.com/other-commercial-content	https://library.tiktok.com/ads?...
maxItems	integer	Maximum rows to scrape. Budget and free-tier caps still apply.	100
extractDetails	boolean	Ad Library only. Fetches extra targeting and reach fields per ad (+$0.50 / 1K when enabled).	false
sourceType	enum	Advanced only. ad_library or other_commercial_content when no URL is provided.	ad_library
region	enum	Country filter — use all for every country on Other commercial content.	DE
dateFrom	string	Start of publication / posted date range.	2025-01-01
dateTo	string	End of publication / posted date range.	today
searchQuery	string	Ad Library: advertiser / keyword. Other commercial content: creator username.	adidas
sortBy	enum	8 options — shared publication/posted date sorts; mode-only options labeled in UI	last_shown_newest

---

🧐 Output

Each row includes sourceType, region, dateFrom, dateTo, scrapedAt, and libraryUrl.

Ad Library example

{
  "sourceType": "ad_library",
  "region": "FR",
  "dateFrom": "2025-01-01",
  "dateTo": "2025-07-03",
  "scrapedAt": "2026-07-03T15:30:00.000Z",
  "libraryUrl": "https://library.tiktok.com/ads?region=FR&start_time=1735689600&end_time=1751587200&adv_name=adidas&adv_biz_ids=&query_type=1&sort_type=last_shown_date%2Cdesc&ad_type=1",
  "adDetailUrl": "https://library.tiktok.com/ads/detail/?ad_id=7318291038472910337",
  "adId": "7318291038472910337",
  "advertiserName": "adidas",
  "advertiserBusinessId": "7123456789012345",
  "adPaidForBy": "adidas AG",
  "auditStatus": "ACTIVE",
  "firstShownDate": "2025-02-10",
  "lastShownDate": "2025-03-28",
  "estimatedAudience": "10K-100K",
  "showMode": 1,
  "videoUrl": "https://v19-webapp.tiktok.com/...",
  "thumbnailUrl": "https://p19-sign.tiktokcdn.com/.../cover.jpg",
  "imageUrls": [],
  "rejectionInfo": null,
  "uniqueUsersSeen": "10K-100K",
  "uniqueUsersSeenByCountry": [
    {
      "countryCode": "FR",
      "uniqueUsersSeen": "5K-10K"
    }
  ],
  "targetCountries": ["FR", "BE"],
  "targetAgeGroups": ["18-24", "25-34"],
  "targetGender": "ALL",
  "targetInterests": ["Sports", "Fashion"],
  "targetBehaviors": ["Shopper"],
  "targetAudienceType": "Custom audience",
  "usersTargetedEstimate": "50K-100K"
}

Ad Library example without extra details

{
  "sourceType": "ad_library",
  "region": "FR",
  "dateFrom": "2025-01-01",
  "dateTo": "2025-07-03",
  "scrapedAt": "2026-07-03T15:30:00.000Z",
  "libraryUrl": "https://library.tiktok.com/ads?...",
  "adDetailUrl": "https://library.tiktok.com/ads/detail/?ad_id=7318291038472910337",
  "adId": "7318291038472910337",
  "advertiserName": "adidas",
  "advertiserBusinessId": null,
  "adPaidForBy": null,
  "auditStatus": "ACTIVE",
  "firstShownDate": "2025-02-10",
  "lastShownDate": "2025-03-28",
  "estimatedAudience": "10K-100K",
  "showMode": 1,
  "videoUrl": "https://v19-webapp.tiktok.com/...",
  "thumbnailUrl": "https://p19-sign.tiktokcdn.com/.../cover.jpg",
  "imageUrls": [],
  "rejectionInfo": null,
  "uniqueUsersSeen": null,
  "uniqueUsersSeenByCountry": [],
  "targetCountries": [],
  "targetAgeGroups": [],
  "targetGender": null,
  "targetInterests": [],
  "targetBehaviors": [],
  "targetAudienceType": null,
  "usersTargetedEstimate": null
}

Other commercial content example

{
  "sourceType": "other_commercial_content",
  "region": "all",
  "dateFrom": "2026-06-03",
  "dateTo": "2026-07-03",
  "scrapedAt": "2026-07-03T16:20:56.750Z",
  "libraryUrl": "https://library.tiktok.com/other-commercial-content?region=all&start_time=1780444800&end_time=1783123199&username=queen_kachinja&sort_type=posted_date%2Cdesc",
  "contentId": "v24044gl0000d93pocvog65pq38uiqpg",
  "creatorUsername": "queen_kachinja",
  "brandNames": [""],
  "contentLabel": "1",
  "postedDate": "2026-07-03",
  "videoViews": "0-1K",
  "videoUrl": "https://library.tiktok.com/api/v1/cdn/..."
}

---

❓ FAQ

Does the actor support every TikTok library tab?

No. Ad Library and Other commercial content only. All ads report is not supported.

Does extractDetails work for Other commercial content?

No. Ad Library only — ignored for creator commercial content.

How much does extractDetails cost?

+$0.50 per 1,000 ads on top of the base row price ($0.50 / 1K). You are only charged for details when the extra fetch succeeds.

Can I run without a URL?

Yes. Use Advanced (power users) and set mode, country, dates, search text, and sort.

Are video URLs permanent?

No. TikTok links can expire. Download or store media soon after the run if you need to keep it.

---

📬 Contact & Support

Need a custom solution? Have a feature request?
We'd love to hear from you!

• 💬 Discord: @azzouzana
• 📧 Email: labs@azzouzana.com

---

⚠️ Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by TikTok, ByteDance, or any of their subsidiaries or affiliates. All trademarks mentioned are the property of their respective owners.

The scraper reads only publicly available transparency data shown on TikTok Ads Library and its linked commercial content surfaces — no logged-in areas or private accounts. Users are responsible for ensuring their use complies with TikTok's Terms of Service, applicable data-protection law (GDPR, UK GDPR, CCPA, etc.), and any contractual obligations of their own organisation. See Apify's overview of web scraping legality for general guidance.