🎵 TikTok Comment Scraper – Bulk Top-Level Comment Extractor

This Apify actor extracts top-level comments from any TikTok video with high accuracy.

It supports bulk URLs, uses Playwright to access TikTok’s publicly available endpoints to retrieve comments, auto-handles pagination, and outputs a clean, flat dataset matching your schema. Replies are not scraped, but the actor includes replyCount for each top-level comment.

Free users are limited to 10 comments per video, while paid users can extract unlimited comments using the minCommentsPerVideo setting.

---

🚀 What It Does

For every TikTok video, the actor extracts:

• 🆔 Comment ID

• ▶️ Video ID (awemeId)

• ⏱️ Created At (datetime)

• 💬 Comment text

• ❤️ Like count

• 🔁 Reply count

• 🌍 Language (detected by TikTok API)

• 👍 isAuthorLiked

• 👤 User info:

  • user.id
  • user.username
  • user.displayName
  • user.url
  • user.avatarUrl

---

⚡ It Handles

• ✅ Bulk TikTok video URLs
• 🔢 Pagination until required number of comments is reached
• 🔄 Retry logic
• ⚙️ Uses TikTok’s publicly available endpoints to retrieve comments.
• 🧹 Dataset cleaning before each run
• 🧠 Free-tier limit enforcement (10 comments)
• 🌐 Automatic proxy usage (no input field required)

---

🧠 How It Works

1. Loads your TikTok video URLs

2. Opens each video with Playwright

3. Extracts the awemeId

4. Calls the TikTok’s publicly available endpoints to retrieve comments.

5. Fetches comments page-by-page

6. Stops when:

   • free user: 10 comments, or
   • paid user: minCommentsPerVideo reached, or
   • all comments exhausted

7. Saves them into the dataset with your exact output fields

---

⚙️ Input Configuration

Field	Type	Description	Example Value
videoUrls	Array	List of TikTok video URLs to scrape	["https://www.tiktok.com/@billieeilish/video/7050551461734042926"]
minCommentsPerVideo	Number	Minimum comments per video (ignored for free users, capped to 10)	20

---

🧩 Example Input

{
  "videoUrls": [
    "https://www.tiktok.com/@billieeilish/video/7050551461734042926"
  ],
  "minCommentsPerVideo": 20
}

---

📊 Example Output

Matches your dataset → comments view:

{
  "id": "7132239819939980037",
  "awemeId": "7050551461734042926",
  "createdAt": "2024-01-25T12:30:12.000Z",
  "text": "This song is insane 🔥🔥",
  "likeCount": 1423,
  "replyCount": 12,
  "commentLanguage": "en",
  "isAuthorLiked": false,
  "user": {
    "id": "6837712345678123458",
    "username": "musiclover101",
    "displayName": "Music Lover",
    "url": "https://www.tiktok.com/@musiclover101",
    "avatarUrl": "https://p16-sign.tiktokcdn-us.com/avatar.jpeg"
  }
}

If video has no comments:

{
  "awemeId": "7050551461734042926",
  "message": "No comments found"
}

If video fails:

{
  "awemeId": "7050551461734042926",
  "error": "Failed to load TikTok video or API blocked."
}

---

🧠 Features

• 🎵 Scrapes top-level comments only
• 🔁 Includes reply count
• ⚡ Uses TikTok’s publicly available endpoints to retrieve comments.
• 🚀 Fast scraping with parallel processing
• 🌐 Automatic proxy rotation (no setup needed)
• 🧹 Dataset cleaned before each run
• 🛡️ Anti-ban retry logic
• 📦 Output fully matches your Apify schema

---

💡 Use Cases

• Sentiment analysis
• Creator analytics
• Trend research
• Influencer monitoring
• Data aggregation tools
• Automation workflows

---

❓ FAQs

1. Does it scrape replies?

No — only top-level comments are collected. replyCount is included.

2. Do I need to configure a proxy?

No — the actor uses Apify Proxy automatically.

3. How many comments can I scrape?

• Free users: 10 comments per video
• Paid users: unlimited, controlled by minCommentsPerVideo

4. Does it use TikTok’s API?

Yes — it uses TikTok’s publicly available endpoints to retrieve comments.

5. Does this work for private or restricted videos?

No — TikTok blocks the API.

---

🧑‍💻 Developer Info

Author: codescraper Email: codescraper011@gmail.com

---

🏷️ Tags

tiktok · tiktok-comment-scraper · tiktok-comments · tiktok-api scraper · apify · playwright · comment-extractor automation · crawlee · social-media-scraper