🎵 TikTok Scraper

Extract videos, profiles, hashtags, and search results from TikTok - the world's most popular short-video platform.

---

🚀 How to scrape TikTok in 5 steps

1. Create a free Apify account using your email.
2. Open TikTok Scraper.
3. Add hashtags, profiles, video URLs, or search queries.
4. Click "Start" and wait for the data to be extracted.
5. Download your data in JSON, XML, CSV, Excel, or HTML.

---

✨ What You Get

📹 Video Data

Field	Description
videoId	Unique TikTok video ID
description	Video caption with hashtags
createTime	Unix timestamp
createTimeISO	Human-readable date
duration	Video length in seconds
videoUrl	Direct link to video
downloadUrl	Video download URL
playUrl	Streaming URL
coverUrl	Thumbnail image

📊 Engagement Stats

Field	Description
likes	Heart count
comments	Comment count
shares	Share count
views	View count
saves	Bookmark count

👤 Author Info

Field	Description
authorUniqueId	Username
authorNickname	Display name
authorSignature	Bio text
authorVerified	Blue checkmark
authorAvatarUrl	Profile picture

🎵 Music Info

Field	Description
musicTitle	Sound name
musicAuthor	Artist/creator
musicCoverUrl	Album art

🏷️ Extra

Field	Description
hashtags	Array of hashtag names
isPinned	Pinned to profile
downloadedVideoUrl	KV Store link (if downloaded)
downloadedCoverUrl	KV Store link (if downloaded)

---

🚀 Quick Start

#️⃣ Scrape Hashtags

Get trending videos from any hashtag:

{
  "hashtags": ["fyp", "viral", "trending"],
  "resultsPerPage": 20
}

---

👤 Scrape Profiles

Get all videos from a creator:

{
  "profiles": ["tiktok", "charlidamelio"],
  "profileSorting": "popular",
  "resultsPerPage": 50
}

---

🔍 Search TikTok

Find videos or users by keyword:

{
  "searchQueries": ["funny cats", "cooking recipes"],
  "searchSection": "/video",
  "resultsPerPage": 30
}

---

🔗 Scrape Specific Videos

Paste URLs or just video IDs:

{
  "postURLs": [
    "https://www.tiktok.com/@user/video/1234567890",
    "7578160501549567288"
  ]
}

---

📥 Download Videos Without Watermark

{
  "profiles": ["tiktok"],
  "resultsPerPage": 10,
  "shouldDownloadVideos": true,
  "downloadWithoutWatermark": true
}

---

⚙️ Input Options

📍 Scraping Sources

Parameter	Description
hashtags	Hashtags to scrape (fyp, #viral, or full URL)
profiles	Usernames to scrape (tiktok, @user, or full URL)
searchQueries	Search terms
postURLs	Video URLs or numeric IDs

👤 Profile Options

Parameter	Default	Description
profileSorting	latest	Sort: latest, popular, oldest
excludePinnedPosts	false	Skip pinned videos

🔍 Search Options

Parameter	Default	Description
searchSection	Top	Search: Top, /video, or /user

🎛️ Filters

Parameter	Description
resultsPerPage	Max videos per input (1-1000)
oldestPostDate	Only posts after this date
newestPostDate	Only posts before this date
minLikes / maxLikes	Filter by likes
minViews / maxViews	Filter by views

📥 Media Downloads

Parameter	Default	Description
shouldDownloadVideos	false	Download video files
downloadWithoutWatermark	false	Remove TikTok watermark
shouldDownloadCovers	false	Download thumbnails
shouldDownloadAvatars	false	Download profile pics
shouldDownloadMusicCovers	false	Download music art
mediaKvStoreName	default	Custom KV Store name

🌍 Proxy

Parameter	Default	Description
proxyCountryCode	None	Country for geo-restricted content

---

💡 Tips

• 🎯 Flexible input - Enter tiktok, @tiktok, or full URL - all work!
• 🔢 Video IDs - Just paste the number, no URL needed
• 📅 Date filters - Use 2024-01-15 or 7 days (relative)
• 📌 Skip pinned - Enable to get organic content only
• ✨ No watermark - Works on most videos, may fail on protected content
• 🌐 Geo-blocked? - Use proxy country to access regional content

---

🎯 Who is this for?

Marketers — Find trending content, track hashtag performance, discover influencers worth partnering with.

Researchers — Collect data for academic studies, sentiment analysis, or trend forecasting.

Brands — Monitor competitors, analyze what content performs, plan your TikTok strategy.

Developers — Feed TikTok data into your apps, dashboards, or AI models via API.

Agencies — Deliver TikTok insights to clients, automate reporting, scale your services.

---

💰 Pricing

This Actor uses pay-per-event pricing. You only pay for what you use:

What you pay for	When it's charged
🚀 Actor start	Each time you run the scraper
📄 Result	Per video added to your dataset
🎛️ Filters	When filtering by date, likes, or views
📥 Video download	When saving videos to storage
🌍 Country proxy	When using location-specific proxy

---

🔌 Works with your stack

Export data directly to Google Sheets, Slack, Airtable, or your own database. Connect via Zapier, Make, webhooks, or the Apify API.

---

⚠️ Good to know

• TikTok has rate limits — the scraper handles retries automatically
• Private or deleted videos are skipped
• No-watermark downloads use TikTok's internal endpoints (may change)
• Only public data is collected — no private user info

---

📞 Need help?

Open an issue on GitHub