# TikTok Comment Analysis: Replies, Questions & Sentiment (`precious_bathmat/tiktok-comments-scraper`) Actor

For brands, creators and social media managers: TikTok comments and replies from any video with text, likes, date, language, pinned and liked-by-creator flags, plus a report per video with top comments, questions, sentiment and keywords. No login.

- **URL**: https://apify.com/precious_bathmat/tiktok-comments-scraper.md
- **Developed by:** [Mariam Ahmed](https://apify.com/precious_bathmat) (community)
- **Categories:** Social media, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.50 / 1,000 comments

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Comment Analysis: Replies, Questions & Sentiment

Scrape **comments and replies from any TikTok video**, with no login, no cookies and no API key, and get a **report for every video** with what viewers say, ask and complain about:

- **Every comment**: text, likes, number of replies, exact date, language, pinned, **liked by the creator**, **replied to by the creator**, written by the creator, photo or sticker comments
- **Replies** (optional): read under each comment, linked to their parent
- **Report per video**: plays, likes, **comments per 1,000 plays**, top comments, **top questions**, top negative comments, most-used **keywords, phrases and emoji**, languages, sentiment, how much the creator engages, and when people commented
- **Thousands of comments per video**: 3,000 comments from one video in under a minute

### What does this TikTok comments scraper do?

```
@garyvee · parenting advice video (2022) · 20.3M plays · 9,406 comments
 Top comment: "This is actually very usefull" (22,272 likes)
 Top question: "Ok now how do you build their self esteems?"
 Phrases: self esteem · great advice · best advice · good advice
 Positive 48.8% · negative 2.0% · 83% English
```

1. Paste **TikTok video links** (or short `vm.tiktok.com` links, or video ids).
2. Choose how many **comments per video**, and whether to read **replies**.
3. You get **one row per comment** and **one report per video**.

```mermaid
flowchart LR
    A[TikTok<br/>video links] --> B[Video page<br/>plays, likes,<br/>caption]
    A --> C[Comment feed<br/>50 per request]
    C --> D[Replies<br/>optional]
    C --> E[Comments<br/>text, likes,<br/>date, language]
    D --> E
    B --> F[Report<br/>top comments,<br/>questions,<br/>keywords,<br/>sentiment]
    E --> F
```

### Who is it for?

- **Brands and agencies**: read what people say under your videos and your competitors', find complaints and product questions
- **Creators and social media managers**: the questions your audience asks, the comments that get the most likes, and whether you engage enough
- **Influencer marketing teams**: check that an influencer's comments are real conversations, not emoji spam, before you pay them
- **Market researchers and analysts**: viewer opinions on products, launches and trends, in bulk
- **Data scientists and AI teams**: labelled comment text (language, sentiment, questions) for training and analysis

### What data do you get?

**Comments** (dataset, one row per comment or reply)

| Field | What it tells you |
|---|---|
| `text` | The comment, with @mentions replaced by `@user` |
| `likes`, `replies` | Likes and number of replies |
| `createdAt`, `language` | Exact date and time, and the language TikTok detected |
| `isPinned`, `likedByCreator`, `creatorReplied`, `isByCreator` | How the creator treated the comment |
| `isReply`, `parentCommentId` | Replies and the comment they answer |
| `hasPhoto`, `isSticker` | Photo comments and sticker-only comments |
| `sentiment`, `isQuestion` | Positive / negative / neutral, and whether it asks something |
| `videoId`, `videoUrl`, `commentId` | Where it comes from |

**Report** (`REPORTS`, and `REPORT_<videoId>` for each video)

| Field | What it tells you |
|---|---|
| `plays`, `likes`, `shares`, `saves`, `totalComments` | The video's own numbers |
| `commentsPer1kPlays`, `likesPer1kPlays` | How much the video makes people talk |
| `topComments`, `topQuestions`, `topNegative` | The comments that matter, ranked by likes |
| `topKeywords`, `topPhrases`, `topEmoji`, `languages` | What people talk about, and in which language |
| `sentiment` | Share of positive, negative and neutral comments |
| `creator` | Pinned comment, comments liked and replied to by the creator, the creator's own comments |
| `commentAge`, `medianHoursAfterPosting` | When people commented: last 24 hours, 7 days, 30 days, a year, older |
| `medianCommentLikes`, `top10LikeSharePercent` | Whether a few comments get all the attention |

### Example: 20 October 2026

Two videos, up to 3,000 comments each: **4,591 comments and 2 reports in 63 seconds, 112 requests, none failed**.

| Video | Plays | Comments | Comments per 1,000 plays | Positive | Most-liked comment |
|---|---|---|---|---|---|
| @garyvee, parenting advice (2022) | 20.3M | 9,406 | 0.46 | 48.8% | "This is actually very usefull" (22,272) |
| @nasa, "Something big just landed on TikTok" | 1.7M | 3,104 | 1.83 | 16.9% | "Howdy partners! 🚀✨" (7,253) |

- On the NASA video, people **asked questions** ("U gonna film a tiktok on the moon?", "why did you stop investigating the ocean?"), and NASA liked 14 of the comments that were read. Only 63% of the comments were in English, followed by Tagalog and Indonesian.
- The Gary Vee video was posted in 2022, and it **still gets new comments every week**.
- Another run read 4 videos with replies on (up to 10 per comment): **2,447 comments in 186 seconds**, and found NASA replying to a fan in the threads.

### Pricing

**$0.0005 per comment** (replies included) and **$0.02 per video report**.

- 100 comments from one video, with its report: **$0.07**
- 1,000 comments with a report: **$0.52**
- The run above (4,591 comments, 2 reports): **$2.34**
- Reports only (comments not saved): **$0.02 per video**

### Good to know

- **Order**: comments come in TikTok's own order (the most engaging first); TikTok has no "newest first" option for this feed.
- **Counts**: `totalComments` is TikTok's own number and includes replies; TikTok hides some comments (spam, filtered words), so a little fewer can be read.
- **Privacy**: no commenter names, usernames, profile photos or ids are collected, and @mentions in the text become `@user`.
- **Sentiment** uses a simple English word and emoji rule, including TikTok's own emoji codes like `[Tears of joy]`. Good for trends across many comments, not for judging one.
- **Unavailable videos** (deleted, private, comments turned off) are listed in `RUN_SUMMARY` and not charged.
- Data comes from **TikTok's public web pages**, the comment feed tiktok.com shows under a video. **Not affiliated with TikTok.**

### Input

| Field | Meaning |
|---|---|
| **TikTok videos** | Video links, short links or video ids, one per line |
| **Comments per video** | 1 to 20,000 (default 100) |
| **Include replies** | Off by default; replies are saved and charged as comments |
| **Replies per comment** | 1 to 1,000 (default 20) |
| **Save comments** | On by default; turn off to get only the reports |

### Integrations

Export to JSON, CSV, Excel or Google Sheets, or connect through the Apify API, webhooks, Make, Zapier and n8n. **Schedule it daily** on your latest videos to catch new questions and complaints, or pair it with the [TikTok Profile & Video Scraper](https://apify.com/precious_bathmat/tiktok-profile-video-scraper) to get the video links of any account.

### Related tools

Other tools from the same publisher that pair well with this one:

- [TikTok Transcripts: Video Captions to Text & Hooks](https://apify.com/precious_bathmat/tiktok-transcript-scraper)
- [X (Twitter) Profile Tracker: Followers & Latest Posts](https://apify.com/precious_bathmat/x-twitter-scraper)
- [Pinterest Pin & Profile Analytics: Saves, Boards & Links](https://apify.com/precious_bathmat/pinterest-scraper)
- [Snapchat Creator Stats: Subscribers, Stories & Spotlight](https://apify.com/precious_bathmat/snapchat-profile-scraper)

# Actor input Schema

## `videos` (type: `array`):

Video links (https://www.tiktok.com/@user/video/123..., short vm.tiktok.com links) or video ids, one per line.

## `maxCommentsPerVideo` (type: `integer`):

Most top-level comments to read per video (1 to 20,000), in TikTok's own order (most engaging first).

## `includeReplies` (type: `boolean`):

Also read the replies under each comment. Each reply is saved and charged as a comment.

## `maxRepliesPerComment` (type: `integer`):

Most replies to read under one comment (1 to 1,000), when replies are on.

## `saveComments` (type: `boolean`):

Save every comment to the dataset. Turn off to get only the video reports.

## Actor input object example

```json
{
  "videos": [
    "https://www.tiktok.com/@nasa/video/7665075736742530317"
  ],
  "maxCommentsPerVideo": 100,
  "includeReplies": false,
  "maxRepliesPerComment": 20,
  "saveComments": true
}
```

# Actor output Schema

## `comments` (type: `string`):

One row per comment or reply: text, likes, replies, date, language, pinned, liked by creator, sentiment, question.

## `reports` (type: `string`):

Per video: plays, likes, comments per 1,000 plays, top comments, questions, negative comments, keywords, phrases, emoji, languages, sentiment and creator engagement.

## `reportsCsv` (type: `string`):

One flat row per video.

## `summary` (type: `string`):

Requests, problems and the limits of the data.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "videos": [
        "https://www.tiktok.com/@nasa/video/7665075736742530317"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("precious_bathmat/tiktok-comments-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "videos": ["https://www.tiktok.com/@nasa/video/7665075736742530317"] }

# Run the Actor and wait for it to finish
run = client.actor("precious_bathmat/tiktok-comments-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "videos": [
    "https://www.tiktok.com/@nasa/video/7665075736742530317"
  ]
}' |
apify call precious_bathmat/tiktok-comments-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,precious_bathmat/tiktok-comments-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dynXGW95Ix2Fm5fdC/builds/qrWmf0Vg8CcQxuN2h/openapi.json
