# TikTok Comments Scraper (`seemuapps/tiktok-comments-scraper`) Actor

Scrape comments and nested replies from any public TikTok video and export them to a dataset.

- **URL**: https://apify.com/seemuapps/tiktok-comments-scraper.md
- **Developed by:** [Andrew](https://apify.com/seemuapps) (community)
- **Categories:** Social media, Videos, Lead generation
- **Stats:** 3 total users, 0 monthly users, 88.9% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 comment scrapeds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## TikTok Comments Scraper

Extract comments and nested replies from any public TikTok video - no login required.

### What you get

- Comment text, author username, display name, and TikTok sec UID
- Like count and reply count per comment
- Full nested replies for each comment, included in the same record
- Timestamps in both ISO 8601 and Unix formats
- Export to JSON, CSV, Excel, or Google Sheets directly from the Apify console

### Limits

TikTok's API caps the total number of retrievable comments per video at **1,000**, regardless of how many are shown in the app. This is a platform-level restriction - setting `maxComments` above 1,000 will not return more results. For most use cases (sentiment analysis, research, moderation) 1,000 comments is more than sufficient.

### Use cases

- Sentiment analysis and brand monitoring on TikTok content
- Competitive research - see how audiences respond to competitor videos
- Influencer vetting - assess comment quality and engagement authenticity
- Content research - find recurring questions or pain points in comment sections
- Academic research on social media behaviour

### How to use

1. Paste the full TikTok video URL (e.g. `https://www.tiktok.com/@username/video/1234567890`)
2. Set **Max Comments** (default 1,000 - see limits above)
3. Toggle **Include Replies** on or off (default: on)
4. Optionally set **Max Replies Per Comment** to cap reply depth (default: 100)
5. Run the actor - results appear in the **Dataset** tab
6. Export to your preferred format

### Output format

Each dataset record represents one top-level comment with its replies nested inside:

```json
{
  "videoId": "7613574458594331911",
  "commentId": "7613713773107692296",
  "text": "this is incredible 🔥",
  "authorUsername": "johndoe",
  "authorNickname": "John Doe",
  "authorSecUid": "MS4wLjABAAAA...",
  "likeCount": 142,
  "replyCount": 3,
  "createdAt": "2025-07-01T14:23:00.000Z",
  "createdAtTimestamp": 1751379780,
  "replies": [
    {
      "commentId": "7613720000000000000",
      "text": "agreed!!",
      "authorUsername": "janedoe",
      "authorNickname": "Jane Doe",
      "authorSecUid": "MS4wLjABAAAA...",
      "likeCount": 12,
      "createdAt": "2025-07-01T14:45:00.000Z",
      "createdAtTimestamp": 1751381100
    }
  ]
}
```

### Pricing

$0.002 per comment scraped (~$2.00 per 1,000 comments). Replies are included.

### Related TikTok actors

Part of a complete TikTok toolkit - explore the rest of the suite:

- [TikTok User Scraper](https://apify.com/seemuapps/tiktok-user-scraper) - Profile data - followers, stats, bio, metadata
- [TikTok Video Scraper](https://apify.com/seemuapps/tiktok-video-scraper) - Video data by URL - stats, music, download links
- [TikTok Hashtag Scraper](https://apify.com/seemuapps/tiktok-hashtag-scraper) - Videos from any hashtag with stats and music
- [TikTok Following Scraper](https://apify.com/seemuapps/tiktok-following-scraper) - Full following list of any public profile
- [TikTok MCP Server](https://apify.com/seemuapps/tiktok-mcp) - All TikTok tools for AI agents via MCP

# Actor input Schema

## `videoUrl` (type: `string`):

Full TikTok video URL, e.g. https://www.tiktok.com/@username/video/1234567890123456789

## `maxComments` (type: `integer`):

Maximum number of top-level comments to scrape.

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

Fetch replies for each comment and nest them in the output record.

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

Maximum replies to fetch per comment. Only used when Include Replies is enabled.

## Actor input object example

```json
{
  "videoUrl": "https://www.tiktok.com/@australia/video/7632203705881824520",
  "maxComments": 1000,
  "includeReplies": true,
  "maxRepliesPerComment": 100
}
```

# Actor output Schema

## `results` (type: `string`):

Each record contains commentId, text, authorUsername, authorNickname, authorSecUid, likeCount, replyCount, createdAt, createdAtTimestamp, videoId, and a replies array with the same fields (minus replyCount).

# 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 = {
    "videoUrl": "https://www.tiktok.com/@australia/video/7632203705881824520"
};

// Run the Actor and wait for it to finish
const run = await client.actor("seemuapps/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 = { "videoUrl": "https://www.tiktok.com/@australia/video/7632203705881824520" }

# Run the Actor and wait for it to finish
run = client.actor("seemuapps/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 '{
  "videoUrl": "https://www.tiktok.com/@australia/video/7632203705881824520"
}' |
apify call seemuapps/tiktok-comments-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,seemuapps/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/AVbWcgbJOVe3ZNA5O/builds/xfzNGsbf9chPkLGtm/openapi.json