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

Scrape comments from TikTok videos in bulk. Returns each comment with author handle, nickname and user id, comment text, post time, like count, reply count, and the source video id. Automatic pagination through every page of comments.

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

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 Goat - Bulk Export Comments, Authors, Likes & Replies

Scrape comments from TikTok videos in bulk. Extract the comment text, author handle, author nickname, author user id, post time, like count, and reply count for every comment, all without a TikTok API key, login, or cookies.

### What this TikTok comments scraper does

Pass a list of TikTok video URLs (or numeric video ids, mix freely) and the actor returns one clean JSON record per comment. Pagination is handled automatically across every page of comments, so you can pull the first hundred or every comment a video has.

Perfect for **audience research, sentiment analysis, content strategy, community management, and trend research** on TikTok at scale.

### Why use this TikTok comments scraper

- **No API key, no login, no cookies** - works on any public TikTok video.
- **Bulk by video** - scrape one or many TikTok videos in a single run.
- **Auto-pagination** - request 100 comments or 100,000, the scraper fetches every page until your limit or the video runs out.
- **One flat JSON object per comment** with a `videoId` field, so multi-video runs are easy to group and filter.
- **Author identity included** - handle, nickname, and stable user id on every comment for de-duplication and audience mapping.
- **Engagement metrics** - per-comment like count and reply count.
- **Proxy support** built in (Apify Proxy or your own).

### What data you get per TikTok comment

| Field | Type | Description |
|---|---|---|
| `commentId` | string | Unique comment id |
| `authorHandle` | string | Author username (`@handle`) |
| `authorNickname` | string | Author display name |
| `authorUserId` | string | Stable numeric author id |
| `authorRegion` | string | Author region code (when available) |
| `authorVerified` | boolean | Whether the author is verified |
| `authorAvatarUrl` | string | Author profile picture URL |
| `text` | string | Full comment text (with emojis) |
| `createTime` | integer | When the comment was posted (unix epoch) |
| `diggCount` | integer | Number of likes on the comment |
| `replyCount` | integer | Number of replies to the comment |
| `videoId` | string | The TikTok video this comment belongs to |

### How to use the TikTok Comments Scraper

1. Click **Try for free** on the actor page.
2. Enter TikTok **video URLs or ids** in the `videos` input. Full URLs and bare numeric ids both work and are deduped.
3. Set `maxCommentsPerVideo` (default 100). Set to `0` to fetch all comments.
4. Tune `concurrency` (default 4) and `delayBetweenRequests` (default 1s) if you are chasing speed.
5. Click **Save & start**. Download the dataset in JSON, CSV, Excel, XML, or HTML.

### Top use cases

- **Sentiment analysis** - measure how an audience reacts to a video or campaign.
- **Audience research** - map who is commenting via stable author ids and handles.
- **Content strategy** - find the questions and themes your viewers raise most.
- **Community management** - surface top comments by like count for replies.
- **Trend research** - extract comment language and slang at scale across many videos.
- **AI training data** - build a clean comment corpus for model fine-tuning.

### Integrations

#### Apify API

```bash
curl "https://api.apify.com/v2/datasets/{DATASET_ID}/items?format=json"
````

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")

run_input = {
    "videos": [
        "https://www.tiktok.com/@example_user/video/1234567890123456789"
    ],
    "maxCommentsPerVideo": 100,
}

run = client.actor("tiktok-comments-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["authorHandle"], item["diggCount"], item["text"])
```

### Pricing

This actor charges per comment returned. You only pay for the comments you actually receive.

### FAQ

**Do I need a TikTok account or API key?**
No. The scraper works on any public TikTok video with no login or cookies.

**How many comments can I get per video?**
Set `maxCommentsPerVideo` to any value, or `0` for no limit. The scraper paginates through every page until your limit or the video runs out of comments.

**Can I pass plain video ids instead of full URLs?**
Yes. Full URLs and bare numeric video ids both work and are deduplicated.

**What input formats are accepted?**
Standard video URLs (`https://www.tiktok.com/@example_user/video/1234567890123456789`) and bare numeric ids.

### Related actors

Part of the scraper suite by goat255:

- [TikTok Profile Scraper](https://apify.com/goat255/tiktok-profile-scraper) - public profiles in bulk.
- [TikTok Video Scraper](https://apify.com/goat255/tiktok-video-scraper) - videos by profile or URL.

# Actor input Schema

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

List of TikTok video URLs or numeric video ids. Mix formats freely: https://www.tiktok.com/@example\_user/video/1234567890123456789 or 1234567890123456789.

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

Maximum number of comments to return per video. The scraper paginates through every page until this limit is reached or the video runs out of comments. Use 0 for no limit (fetch all comments).

## `concurrency` (type: `integer`):

Maximum number of videos processed in parallel.

## `delayBetweenRequests` (type: `number`):

Seconds to wait between page fetches inside a single video pipeline. A small delay reduces the chance of rate limiting on videos with many comments.

## `proxyConfiguration` (type: `object`):

Proxy settings. Apify Proxy is configured by default and is recommended for large bulk runs.

## Actor input object example

```json
{
  "videos": [
    "https://www.tiktok.com/@tiktok/video/7106594312292453675"
  ],
  "maxCommentsPerVideo": 100,
  "concurrency": 4,
  "delayBetweenRequests": 1,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

# 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/@tiktok/video/7106594312292453675"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("goat255/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/@tiktok/video/7106594312292453675"] }

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

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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/@tiktok/video/7106594312292453675"
  ]
}' |
apify call goat255/tiktok-comments-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=goat255/tiktok-comments-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TikTok Comments Scraper Goat",
        "description": "Scrape comments from TikTok videos in bulk. Returns each comment with author handle, nickname and user id, comment text, post time, like count, reply count, and the source video id. Automatic pagination through every page of comments.",
        "version": "0.0",
        "x-build-id": "L4BYrxdyIOD14MnV2"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/goat255~tiktok-comments-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-goat255-tiktok-comments-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/goat255~tiktok-comments-scraper/runs": {
            "post": {
                "operationId": "runs-sync-goat255-tiktok-comments-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/goat255~tiktok-comments-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-goat255-tiktok-comments-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "videos"
                ],
                "properties": {
                    "videos": {
                        "title": "TikTok Video URLs or IDs",
                        "type": "array",
                        "description": "List of TikTok video URLs or numeric video ids. Mix formats freely: https://www.tiktok.com/@example_user/video/1234567890123456789 or 1234567890123456789.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxCommentsPerVideo": {
                        "title": "Max comments per video",
                        "minimum": 0,
                        "maximum": 100000,
                        "type": "integer",
                        "description": "Maximum number of comments to return per video. The scraper paginates through every page until this limit is reached or the video runs out of comments. Use 0 for no limit (fetch all comments).",
                        "default": 100
                    },
                    "concurrency": {
                        "title": "Concurrency",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Maximum number of videos processed in parallel.",
                        "default": 4
                    },
                    "delayBetweenRequests": {
                        "title": "Delay Between Requests (seconds)",
                        "minimum": 0,
                        "type": "number",
                        "description": "Seconds to wait between page fetches inside a single video pipeline. A small delay reduces the chance of rate limiting on videos with many comments.",
                        "default": 1
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings. Apify Proxy is configured by default and is recommended for large bulk runs.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```