↑ ↓ to move ↵ to open
TikTok API reference

TikTok Video Comments

tiktok.video.comments

Read the public comments on a video, page by page, each checked to belong to that video.

At a glance

Endpoint ID
tiktok.video.comments
Price
0.75 credits per call; failed calls are free
Runs for up to
45 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
tiktok__video__comments
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "tiktok.video.comments",  "input": {    "count": 5,    "video_id": "7680721699171601694"  }}'

Input

FieldTypeRequiredWhat it doesExample
url string one of The video's link.
video_id string one of The video's ID, as an alternative to the link. 7680721699171601694
count integer no About how many comments to return. TikTok can send a few more or fewer. 5
cursor integer no Pass cursor from the last response to get the next page.
handle string no The creator's handle, sent with the video ID.

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

No sample response is published for this endpoint yet.

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other TikTok endpoints

Something missing or unclear? Ask the team that builds the TikTok endpoints.