TikTok Ad Library Scraper

What data can you scrape from TikTok Ad Library?

Extract structured data from TikTok Ad Library including listings, prices, and details.

• Structured output — Clean, normalized records ready for spreadsheets, BI tools or databases
• Flexible filters — Narrow your scrape by category, keyword, or other parameters
• Export anywhere — JSON, CSV, Excel, or via the Apify API and integrations

---

Output: TikTok Ad Library data structure

The Actor returns structured records with all available fields from TikTok Ad Library listings.

Example output (one record)

{
  "contentId": "abc123",
  "creatorUsername": "creator_handle",
  "contentLabel": "paid_partnership",
  "brandNames": ["Nike"],
  "postedTime": "2025-06-01T12:00:00Z",
  "videoViews": "1.2M",
  "videoUrl": "https://...",
  "videoCover": "https://..."
}

---

🚀 Quick start

1. Click Start with the default input to test with a small sample.
2. Open the Output tab to preview results.
3. Export as CSV / Excel / JSON, or connect via API.

---

How to scrape TikTok Ad Library — input options

Field	Description	Default
TikTok Ad Library URL	Paste a URL from TikTok Ad Library and the actor will extract all parameters automatically.Example: https://library.t...	https://library.tiktok.com/ads?region=ES&search_key=nike&query_type=1
Scraping mode	Choose what to scrape:• Search Ads — search paid ads by keyword or advertiser name• Discover Advertisers — fi...	search_ads
Search query	Type a keyword (e.g. running shoes) or an advertiser name (e.g. Nike).Leave empty to browse all ads in the selected r...	nike
Query type	How to interpret the search query.• Keyword: searches in ad text and titles• Advertiser name: finds the adver...	keyword
Region	Filter ads shown in a specific country. Select 'All regions' to search across all 33 EU/EEA regions.⚡ Ignored if a UR...	all
Max results	Maximum number of results to return.Tip: Start with 20 for your first test. TikTok limits searches to ~3,600 ads ...	100
Start date	Only show ads first displayed after this date.Accepts YYYY-MM-DD or relative like 30 days. Default: 31 days ago.⚡ Ign...	31 days
End date	Only show ads last displayed before this date. Default: today.⚡ Ignored if a URL is provided above.	0 days
Include ad details	Fetch full details for each ad: advertiser info, targeting by location/age/gender, audience size, and sponsor data.⚠️...	false
Sort by	Sort order for search results.	last_shown_date,desc
Ad IDs (direct lookup)	Paste comma-separated ad IDs to fetch them directly.Example: 1848459287600130, 1820197122833570⚡ When provided, all s...	—
Advertiser IDs	Optional comma-separated advertiser business IDs.Use Discover Advertisers mode to find these, or copy from TikTok...	—
Discovery prefixes	Only for Discover Advertisers mode.Comma-separated prefixes to search (e.g. a, b, nike, adi).Leave empty to use f...	—
Proxy configuration	Optional. Residential proxies recommended for best results.	Apify auto
Request delay	Delay between API requests in milliseconds. Increase to 1000-2000 if you get rate-limited.	500

---

🔍 How it works

This Actor uses HTTPX async to extract data from TikTok Ad Library. It navigates search results or catalog pages, extracts structured data from each listing, and normalizes the output into a consistent schema.

---

How much does it cost to scrape TikTok Ad Library?

This Actor uses Pay-Per-Event pricing — you pay only for results delivered, not for compute time.

Plan	What you get
Free tier	$5/month of platform credits — enough for thousands of results
Paid plans	Scale to tens of thousands of results per run

---

🔄 Integrations & scheduling

• Schedule daily/weekly runs from the Apify Console for automated data collection.
• Push results to Google Sheets, Slack, Zapier, Make, webhooks or any database.
• Fetch datasets via the Apify REST API or the official JavaScript/Python clients.

---

Is it legal to scrape TikTok Ad Library?

This Actor collects only publicly available data. It does not log in, bypass paywalls, or access private information. You are responsible for using the extracted data in compliance with the site's Terms of Service and applicable data protection laws (including GDPR where relevant).

---

❓ FAQ

Can I access the data via API? Yes. Every run stores its dataset on Apify. Fetch it via REST API or use the official JavaScript/Python clients.

What export formats are supported? JSON, CSV, Excel (XLSX), XML, and HTML table. You can also push data directly to Google Sheets or any webhook endpoint.

Do I need proxies? Not required for standard usage. Enable proxies only for very large scraping jobs.

Related Actors from Rastriq

• Google Ads Scraper