TikTok comment replies API
TikTok comment replies: GET /v1/tiktok/video/comment/replies. 1 credit per request.
GET /v1/tiktok/video/comment/replies
GET /v1/tiktok/video/comment/replies
TikTok comment replies.
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
url | URL | one of | Video URL (www.tiktok.com/@user/video/..., vm.tiktok.com/..., vt.tiktok.com/...). Accepted hosts: tiktok.com. |
id | string | one of | Numeric video id. Also accepted as aweme_id, video_id. |
comment_id | string | yes | TikTok comment id (the cid from the comments list). Also accepted as commentId, cid. |
Send at least one of url, id. If you send several, the first listed is used and the rest are ignored.
Every request also accepts:
cursor: the cursor from the previous page (Pagination).trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/tiktok/video/comment/replies" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "url=https://www.tiktok.com/@khaby.lame/video/7137423965982592302" \4 --data-urlencode "comment_id=7137510823549272878"1import os2import requests34params = {5 "url": "https://www.tiktok.com/@khaby.lame/video/7137423965982592302",6 "comment_id": "7137510823549272878",7}8res = requests.get(9 "https://api.socialscrape.dev/v1/tiktok/video/comment/replies",10 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},11 params=params,12)13body = res.json()1415if body["ok"]:16 print(body["data"])17else:18 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/tiktok/video/comment/replies");2url.search = new URLSearchParams({3 "url": "https://www.tiktok.com/@khaby.lame/video/7137423965982592302",4 "comment_id": "7137510823549272878"5}).toString();6const res = await fetch(url, {7 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },8});9const body = await res.json();1011if (body.ok) {12 console.log(body.data);13} else {14 console.error(body.error.code, body.error.message);15}1{2 "nodes": [3 {4 "name": "SocialScrape TikTok comment replies",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/tiktok/video/comment/replies",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "url",19 "value": "https://www.tiktok.com/@khaby.lame/video/7137423965982592302"20 },21 {22 "name": "comment_id",23 "value": "7137510823549272878"24 }25 ]26 },27 "sendHeaders": true,28 "headerParameters": {29 "parameters": [30 {31 "name": "x-api-key",32 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"33 }34 ]35 }36 }37 }38 ],39 "connections": {}40}Example response#
This is a sample from a recorded response, lists and long text are shortened, other people's names and handles are replaced. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_402b275b29c787f9a06f164c",8 "data": {9 "object": "list",10 "items": [11 {12 "object": "comment",13 "platform": "tiktok",14 "id": "7137827034517406506",15 "url": null,16 "post_id": "7137423965982592302",17 "parent_id": "7137510823549272878",18 "author": {19 "id": "1000000001",20 "handle": "sample_user",21 "name": "Sample User",22 "url": null,23 "avatar_url": null,24 "verified": false25 },26 "text": "No",27 "published_at": "2022-08-31T00:14:37Z",28 "stats": {29 "likes": 16,30 "replies": null,31 "dislikes": null32 },33 "is_pinned": null,34 "is_by_creator": null,35 "extra": {36 "language": "en",37 "liked_by_creator": false38 }39 },40 {41 "object": "comment",42 "platform": "tiktok",43 "id": "7137949642306994946",44 "url": null,45 "post_id": "7137423965982592302",46 "parent_id": "7137510823549272878",47 "author": {48 "id": "1000000001",49 "handle": "sample_user",50 "name": "Sample User",51 "url": null,52 "avatar_url": null,53 "verified": false54 },55 "text": "Chandon Barker",56 "published_at": "2022-08-31T08:11:28Z",57 "stats": {58 "likes": 6,59 "replies": null,60 "dislikes": null61 },62 "is_pinned": null,63 "is_by_creator": null,64 "extra": {65 "language": "en",66 "liked_by_creator": false67 }68 }69 ],70 "cursor": "c20",71 "has_more": true,72 "parent": null73 },74 "cursor": "c20",75 "has_more": true76}Response#
A list of Comment objects in data.items, with data.cursor and data.has_more.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
unsupported_url | 400 | no | The URL is not one this endpoint accepts (wrong platform or form). |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints#
- TikTok profile (
GET /v1/tiktok/profile) - TikTok profile videos (
GET /v1/tiktok/profile/videos) - TikTok collection videos (
GET /v1/tiktok/collection/videos) - TikTok video details (
GET /v1/tiktok/video) - TikTok video transcript (
GET /v1/tiktok/video/transcript) - TikTok video comments (
GET /v1/tiktok/video/comments) - TikTok user search (
GET /v1/tiktok/search/users) - TikTok search suggestions (
GET /v1/tiktok/search/suggestions)