TikTok Comment API. Send a video or post link, or an ID.
Comment or reply with its likes and author. We handle the proxies, blocks and platform changes.
TikTok Comment API at a glance
Returns one public comment or reply on a TikTok video or photo post, from a comment link or the post's link and comment_id. You get its text, exact posting time and like count, the reply count of a top-level comment, and the commenter's username, name, ID, avatar and verified badge. It also says its language, which comment it answers, and whether the creator wrote, liked or pinned it.
GET /v1/tiktok/comment
- 1 credit per request, $0.75–$1.97 per 1,000 requests
- 16 typed fields null when unknown
urlis all it needs, e.g.https://m.tiktok.com/v/6718335390845095173.html?share_comment_id=6718335906996502534&share_item_id=6718335390845095173- 100 credits free when you sign up, no card, so you can build before you spend
Send one request. Get 16 fields back.
Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.
$ npm install socialtapurl = https://m.tiktok.com/v/6718335390845095173.html?share_comment_id=6718335906996502534&share_item_id=6718335390845095173const params = new URLSearchParams({
comment_id: "7047599416228234031",
url: "https://www.tiktok.com/@hankgreen1/video/7047596209028074758",
});
const res = await fetch(`https://socialtap.dev/v1/tiktok/comment?${params}`, {
headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/tiktok/comment",
params={"comment_id": "7047599416228234031", "url": "https://www.tiktok.com/@hankgreen1/video/7047596209028074758"},
headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/tiktok/comment")
uri.query = URI.encode_www_form('comment_id' => '7047599416228234031', 'url' => 'https://www.tiktok.com/@hankgreen1/video/7047596209028074758')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]<?php
$query = http_build_query([
'comment_id' => '7047599416228234031',
'url' => 'https://www.tiktok.com/@hankgreen1/video/7047596209028074758',
]);
$ch = curl_init('https://socialtap.dev/v1/tiktok/comment?' . $query);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;package main
import (
"encoding/json"
"fmt"
"log"
"net/http"
"net/url"
"os"
)
func main() {
q := url.Values{}
q.Set("comment_id", "7047599416228234031")
q.Set("url", "https://www.tiktok.com/@hankgreen1/video/7047596209028074758")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/comment?"+q.Encode(), nil)
if err != nil {
log.Fatal(err)
}
req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
log.Fatal(err)
}
defer res.Body.Close()
var body struct {
Data json.RawMessage `json:"data"`
Meta map[string]any `json:"meta"`
Error *struct {
Code string `json:"code"`
Message string `json:"message"`
} `json:"error"`
}
if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
log.Fatal(err)
}
if body.Error != nil {
log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
}
fmt.Println(string(body.Data), body.Meta["credits_charged"])
}curl -G 'https://socialtap.dev/v1/tiktok/comment' \
--data-urlencode 'comment_id=7047599416228234031' \
--data-urlencode 'url=https://www.tiktok.com/@hankgreen1/video/7047596209028074758' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": {
"approximate_fields": [],
"author": {
"avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/da69f59aaa61f643bbccadcd2c1f5b17~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=1cff171d&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5",
"display_name": "tyler oakley",
"id": "52902558817587200",
"is_verified": true,
"url": "https://www.tiktok.com/@tyleroakleyish",
"username": "tyleroakleyish"
},
"edited_at": null,
"id": "7047599416228234031",
"is_by_post_author": false,
"is_edited": null,
"is_liked_by_author": false,
"is_pinned": true,
"metrics": {
"like_count": 28253,
"reply_count": 49
},
"parent_id": null,
"platform": "tiktok",
"platform_specific": {
"tiktok": {
"author_sec_uid": null,
"language": "en",
"thread_id": null
}
},
"post_id": "7047596209028074758",
"published_at": "2021-12-30T20:45:17Z",
"text": "fine I’ll be both",
"unknown_fields": [],
"url": "https://m.tiktok.com/v/7047596209028074758.html?share_comment_id=7047599416228234031&share_item_id=7047596209028074758"
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "tiktok",
"source": "api",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 393,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "video",
"id": "7047599416228234031",
"url": "https://m.tiktok.com/v/7047596209028074758.html?share_comment_id=7047599416228234031&share_item_id=7047596209028074758"
},
"credits_remaining": 9999,
"client_request_id": null,
"warnings": []
}
}import { SocialTap } from "socialtap";
const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY
const res = await client.tiktok.comment.get({ url: "https://www.tiktok.com/@hankgreen1/video/7047596209028074758", comment_id: "7047599416228234031" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class Main {
public static void main(String[] args) throws Exception {
String query = "comment_id=" + encode("7047599416228234031")
+ "&url=" + encode("https://www.tiktok.com/@hankgreen1/video/7047596209028074758");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/tiktok/comment?" + query))
.header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
// An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
if (response.statusCode() >= 400) throw new RuntimeException(response.body());
System.out.println(response.body());
}
static String encode(String value) {
return URLEncoder.encode(value, StandardCharsets.UTF_8);
}
}using System.Text.Json;
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));
var query = string.Join("&",
"comment_id=" + Uri.EscapeDataString("7047599416228234031"),
"url=" + Uri.EscapeDataString("https://www.tiktok.com/@hankgreen1/video/7047596209028074758"));
var res = await http.GetAsync("https://socialtap.dev/v1/tiktok/comment?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
var error = body.RootElement.GetProperty("error");
throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let res = reqwest::blocking::Client::new()
.get("https://socialtap.dev/v1/tiktok/comment")
.query(&[("comment_id", "7047599416228234031"), ("url", "https://www.tiktok.com/@hankgreen1/video/7047596209028074758")])
.header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
.send()?;
let ok = res.status().is_success();
let body: serde_json::Value = res.json()?;
if !ok {
return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
}
println!("{} {}", body["data"], body["meta"]["credits_charged"]);
Ok(())
}200 OK · GET https://socialtap.dev/v1/tiktok/commentDocs One schema on 9 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field TikTok doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
The TikTok video or photo post the comment is on: a tiktok.com/@user/video/<id> or /@user/photo/<id> link, m.tiktok.com/v/<id>.html, embed and player URLs, vm.tiktok.com/<code>, vt.tiktok.com/<code>, tiktok.com/t/<code> or a numeric video ID; or a comment link, which names the comment too: TikTok's comment share link with share_comment_id, a video link with comment_id or cid, or the app's share link of a comment (vm.tiktok.com/<code>, resolved on TikTok).
Write one parser
TikTok, Instagram, Facebook and 6 more platforms answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktok, youtube, …).
idstring- Platform-native comment ID (string; Reddit with its t1_ prefix).
post_idstring- ID of the post commented on (equals post.id).
parent_idstring- ID of the comment this replies to; null for top-level comments.
urlstring- Permalink, when the platform has one.
textstring- Comment body as plain text.
authorobject- The commenting account. An account the platform no longer names (a deleted account) has a null id and username and the platform's label as display_name (Reddit: [deleted]).
published_atstring- When the comment was posted, RFC 3339 UTC. Where the platform shows only a relative time ("3 weeks ago"), the latest time that label allows (the fetch time minus the stated amount), listed in approximate_fields.
Live data from 33 platforms.
What teams build with the TikTok Comment API.
Check likes and replies on a tracked comment
Resolve a shared comment link to its author
Verify that a comment is still up
Good to know before you build.
- A comment that was deleted or hidden, or isn't on the post you sent, returns not_found.
- Private posts and posts with comments off return private_or_unavailable.
- reply_count is set on top-level comments only, because TikTok counts replies per thread.
1 credit per request. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful request | Per 1,000 requests |
|---|---|---|
Platform API api | 1 credit | $0.75–$1.97 |
- Cache hits are free.
- Credits from packs and top-ups never expire.
- A monthly plan's credits are spent first, and what is left of them ends at each renewal.
- Prices exclude tax: sales tax is added at checkout where it applies.
- Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.
Questions about the TikTok Comment API.
More in the API reference.
How much does the TikTok Comment API cost?
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
- No credit card
- Failed requests are free
- Works on all 218 endpoints