Actor - TikTok Comments Scraper

TikTok Comments Scraper

Extract comments and replies from any TikTok video with transparent, event-based pricing.

The TikTok Comments Scraper supports the following features:

• Extract comments from any public TikTok video by URL.

• Gather author info, timestamps, like counts, and reply totals for each comment.

• Optionally include replies for each comment with per-reply-thread pricing.

• Limit output by page count or total item count for cost control.

💰 Pricing

This actor uses event-based pricing — you only pay for what you use.

Event	Price	Notes
Comment Query	$0.003 per video	First ~15 comments included FREE
Reply Query	$0.003 per comment thread	First ~15 replies included FREE. Only charged when includeReplies is enabled.
Dataset Item	$0.0003 per item	Charged for each comment/reply beyond the free ~15

Cost Examples

Scenario	Charges	Calculation	Total
1 video, 15 comments	1 list query	$0.003	$0.003
1 video, 100 comments	1 list query + 85 items	$0.003 + ($0.0003 × 85)	$0.029
5 videos, 100 comments each	5 list queries + 425 items	($0.003 × 5) + ($0.0003 × 425)	$0.143
1 video, 50 comments + replies (10 threads, 20 replies each)	1 list + 35 items + 10 reply queries + 50 items	$0.003 + $0.011 + $0.030 + $0.015	$0.059

Bugs, fixes, updates and changelog

This actor is under active development. If you have any feature requests you can create an issue from here.

Input Parameters

The input of this actor should be JSON containing the list of TikTok video URLs. Possible fields are:

• startUrls: (Required) (Array) List of TikTok video URLs. You should only provide the URLs of videos.

• includeReplies: (Optional) (Boolean) Enable to scrape replies for each comment. Triggers a Reply Query charge per comment thread. Default is false.

• endPage: (Optional) (Number) The end page limitation for the comments. You can limit the number of pages you want to retrieve the comments from. The endPage affects each of the video URLs individually.

• maxItems: (Optional) (Number) You can limit scraped comments. This should be useful when you search through the videos where there are a lot of comments.

• customMapFunction: (Optional) (String) JavaScript function to transform each output comment/reply.

TikTok Comments Scraper Input example

{
  "startUrls": [
    "https://www.tiktok.com/@deborahyowa/video/7173615947603922181?is_copy_url=1&is_from_webapp=v1",
    "https://www.tiktok.com/@argenby/video/7171782248281165058?is_copy_url=1&is_from_webapp=v1",
    "https://www.tiktok.com/@cznburak/video/7161858444830461190?is_copy_url=1&is_from_webapp=v1"
  ],
  "includeReplies": false,
  "maxItems": 200,
  "endPage": 1
}

During the Run

During the run, the actor will output messages letting you know what is going on. Each message always contains a short label specifying which page from the provided list is currently specified. When items are loaded from the page, you should see a message about this event with a loaded item count and total item count for each page.

If you provide incorrect input to the actor, it will immediately stop with failure state and output an explanation of what is wrong.

TikTok Comments Export

During the run, the actor stores results into a dataset. Each item is a separate item in the dataset.

You can manage the results in any language (Python, PHP, Node JS/NPM). See the FAQ or our API reference to learn more about getting results from this TikTok Comments actor.

Other TikTok Scrapers

If you need different functionalities or all at once, we have solutions for each of them. You can check;

• TikTok Hashtag Scraper
• TikTok Search Scraper
• TikTok Video Scraper

Scraped TikTok Comments Properties

The structure of each comment looks like this:

Comment Detail

{
	"inputSource": "https://www.tiktok.com/@deborahyowa/video/7173615947603922181",
	"cid": "7173734747360674586",
	"text": "thanks for the tutorial debs",
	"create_time": 1670265312,
	"digg_count": 15,
	"reply_comment_total": 2,
	"comment_language": "en",
	"aweme_id": "7173615947603922181",
	"is_author_digged": false,
	"reply_id": "0",
	"user": {
		"uid": "6804848813665485826",
		"unique_id": "nescafepinggg",
		"nickname": "el",
		"signature": "foam clay crafting",
		"avatar_thumb": {
			"url_list": [
				"https://p16-common-sign.tiktokcdn-eu.com/..."
			]
		},
		"region": "MY",
		"language": "en",
		"has_email": false,
		"is_phone_binded": false,
		"cover_url": null
	}
}

Contact

Please visit us through epctex.com to see all the products that is available for you. If you are looking for any custom integration or so, please reach out to us through the chat box in epctex.com. In need of support? business@epctex.com is at your service.