🎬 TikTok Data Scraper

Extract public TikTok data at scale — creator profiles, videos, favourites, followers, following, comments & replies, hashtag feeds, music feeds, playlist feeds and full single-video details — and get clean, structured records in one standalone Apify Actor.

No login, no cookies, no browser automation headaches. Just paste what you want and press Start.

---

✨ Why Choose This Actor?

• 🧩 8 data types in one place — videos, favourites, followers, following, user info, search, comments/replies, hashtags, music, playlists and video details.
• 🌊 Unlimited or capped — grab the first N items or scrape everything available.
• 🛡️ Smart proxy ladder — starts on a fast direct connection and only escalates to datacenter → residential proxies when TikTok pushes back, then sticks with residential.
• 💾 Live results — every record is saved the moment it's collected, so you never lose a long run.
• 📊 Tidy output — a consistent envelope (section, category, input, user, userType, data) that's easy to filter, join and export.
• 🪄 Friendly input — clearly grouped sections with emojis; fill in only what you need.

---

🚀 Key Features

Section	What you get
👥 User data	Videos, favourite videos, followers, following, user info, in-profile search
💬 Comments	Comments and (optionally) nested replies for any video
#️⃣ Hashtags	Top/recent videos for any hashtag, with region localization
🎵 Music	Videos using a given sound/track
▶️ Playlists	Videos inside a playlist (mix)
📹 Video details	Full HD detail record for individual videos

---

🧾 Input

You only need to fill the section(s) you care about — leave the rest empty.

{
  "userUrls": ["https://www.tiktok.com/@taylorswift"],
  "categories": ["videos"],
  "maxUserResults": 100,
  "scrapeAllUserResults": false,

  "videoUrlsComments": ["https://www.tiktok.com/@user/video/7300000000000000000"],
  "commentsPerUrl": 100,
  "repliesPerComment": 0,

  "hashtags": ["dance"],
  "videosPerHashtag": 100,
  "hashtagRegion": "US",

  "musicUrls": [],
  "playlistIDs": [],
  "videoDetailsList": [],

  "minRequestInterval": 1.2,
  "maxRetries": 3,
  "proxyConfiguration": { "useApifyProxy": false }
}

Field reference

Field	Type	Description
userUrls	array	Profile URLs, @handles, usernames or numeric user IDs.
categories	array	Which user data to collect: videos, favourite_videos, followers, following, user_playlists, search, user_info.
maxUserResults	integer	Max items per profile/section (min 40).
scrapeAllUserResults	boolean	Ignore the limit and fetch everything.
videoUrlsComments	array	Video URLs/IDs to scrape comments from.
commentsPerUrl / scrapeAllComments	integer / boolean	Comment cap or "all".
repliesPerComment / scrapeAllReplies	integer / boolean	Replies per comment (0 = skip) or "all".
hashtags	array	Hashtag names or URLs.
videosPerHashtag / scrapeAllHashtagVideos	integer / boolean	Hashtag video cap or "all".
hashtagRegion	string	Two-letter country code (e.g. US, GB, IN).
musicUrls	array	Music URLs/IDs.
videosPerMusic / scrapeAllMusicVideos	integer / boolean	Music video cap or "all".
playlistIDs	array	Numeric playlist (mix) IDs.
videosPerPlaylist / scrapeAllPlaylistVideos	integer / boolean	Playlist video cap or "all".
videoDetailsList	array	Video IDs/URLs for full detail records.
minRequestInterval	number	Seconds between requests (pacing).
maxRetries	integer	Retries per request before giving up.
apiKey	string	Optional premium key that lifts the rate limit.
proxyConfiguration	object	Proxy settings. Default: no proxy with automatic escalation.

---

📦 Output

Every record uses the same envelope so different sections sit happily in one dataset:

{
  "section": "users",
  "category": "videos",
  "input": "https://www.tiktok.com/@taylorswift",
  "user": "taylorswift",
  "userType": "unique_id",
  "data": {
    "aweme_id": "7647758735229635871",
    "video_id": "7647758735229635871",
    "region": "US",
    "title": "…",
    "duration": 25,
    "play_count": 13686605,
    "digg_count": 2579867,
    "comment_count": 34525,
    "share_count": 115161,
    "create_time": 1780632608,
    "music_info": { "id": "…", "title": "…", "author": "Taylor Swift" },
    "author": { "id": "…", "unique_id": "taylorswift", "nickname": "Taylor Swift", "avatar": "…" }
  }
}

Envelope field	Meaning
section	users, videos, hashtags, music, playlists, search
category	The specific data type (videos, comments, replies, user_info, …)
input	The exact input string you provided
user	Resolved username / id / hashtag / music id / playlist id
userType	unique_id, user_id, video_id, hashtag, music_id, mix_id, keywords
data	The full record (video, comment, follower, profile, …)

The Output tab ships with ready-made table views: 🗂️ Overview, 📹 Videos, 💬 Comments & Replies, and 👥 Users & Followers.

---

🚀 How to Use (Apify Console)

1. Log in at console.apify.com → Actors.
2. Open TikTok Data Scraper.
3. Fill in the section(s) you need (e.g. paste a profile URL under 👥 Scrape User Data).
4. Click Start.
5. Watch the live log fill up with collection progress. 🎬
6. Open the Output tab and export to JSON / CSV / Excel.

🤖 Use via API

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"userUrls":["https://www.tiktok.com/@taylorswift"],"categories":["videos"],"maxUserResults":40}'

---

💡 Best Use Cases

• 📈 Creator & competitor analytics (engagement, posting cadence).
• 🔎 Hashtag / sound trend discovery.
• 💬 Audience & sentiment research from comments.
• 🗂️ Building datasets for dashboards and ML.

💳 Pricing

This Actor uses the pay-per-event model. You're billed per result item saved to the dataset, so your cost scales directly with the data you collect. Capped runs (maxUserResults, commentsPerUrl, …) give you predictable spend; enable the 🌊 Scrape all toggles for full coverage.

❓ FAQ

Do I need to fill every section? No — fill only the ones you need; leave the rest empty.

Why a minimum of 40 results? Data is fetched in pages; 40 is the smallest sensible batch. Use the Scrape all toggle for everything.

It says my direct connection was blocked — is that bad? No. The Actor automatically escalates to datacenter then residential proxies and keeps going. You'll see clear 🛡️/🏠 log lines when this happens.

Is this legal? Only public data is collected. You are responsible for complying with TikTok's Terms, GDPR/CCPA and any applicable laws.

🛟 Support & Feedback

Found a bug or want a new field? Open an issue on the Actor's Issues tab — feedback is welcome and shapes the roadmap.