Replies

Replies to one comment. Use `limit` to say how many you want.

POST /api/public/v1/scrape/tiktok/replies

Returns comment_reply_api

Parameters#

video_id string required

Numeric id from the video URL.

Example: 7212345678901234567

comment_id string required

Numeric id of the comment, from a `comments` run.

Example: 7213456789012345678

limit integer optional

How many results you want. The run is sized from it, and you are billed for exactly that many.

Results#

GET /runs/:id/results answers with this once the run has finished — one reply per row.

Every row also carries raw_json — the platform's own object for that row, exactly as it arrived, with nothing removed. It is left out of the example for length.

This endpoint errs towards returning more rather than less, so expect a few extra rows alongside what you asked for. Everything still comes back typed and parsed the same way.

curl -X POST https://socialholmes.com/api/public/v1/scrape/tiktok/replies \
  -H "Authorization: Bearer $SOCIALHOLMES_KEY" \
  -H "Content-Type: application/json" \
  -d '{"parameters": {"video_id": "7212345678901234567", "comment_id": "7213456789012345678"}, "limit": 25}'

import os
import requests

run = requests.post(
    "https://socialholmes.com/api/public/v1/scrape/tiktok/replies",
    headers={"Authorization": f"Bearer {os.environ['SOCIALHOLMES_KEY']}"},
    json={"parameters": {"video_id": "7212345678901234567", "comment_id": "7213456789012345678"}, "limit": 25},
).json()

print(run["id"], run["status"])

const response = await fetch("https://socialholmes.com/api/public/v1/scrape/tiktok/replies", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SOCIALHOLMES_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ parameters: { video_id: "7212345678901234567", comment_id: "7213456789012345678" }, limit: 25 }),
})

const run = await response.json()
console.log(run.id, run.status)

require "net/http"
require "json"

response = Net::HTTP.post(
  URI("https://socialholmes.com/api/public/v1/scrape/tiktok/replies"),
  { parameters: { video_id: "7212345678901234567", comment_id: "7213456789012345678" }, limit: 25 }.to_json,
  "Authorization" => "Bearer #{ENV.fetch('SOCIALHOLMES_KEY')}",
  "Content-Type" => "application/json"
)

run = JSON.parse(response.body)
puts run["id"], run["status"]

<?php

$ch = curl_init("https://socialholmes.com/api/public/v1/scrape/tiktok/replies");

curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("SOCIALHOLMES_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode(["parameters" => ["video_id" => "7212345678901234567", "comment_id" => "7213456789012345678"], "limit" => 25]),
]);

$run = json_decode(curl_exec($ch), true);

echo $run["id"], " ", $run["status"];

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"os"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"parameters": map[string]string{"video_id": "7212345678901234567", "comment_id": "7213456789012345678"},
		"limit":      25,
	})

	req, _ := http.NewRequest("POST", "https://socialholmes.com/api/public/v1/scrape/tiktok/replies", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer "+os.Getenv("SOCIALHOLMES_KEY"))
	req.Header.Set("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	var run map[string]any
	json.NewDecoder(res.Body).Decode(&run)

	fmt.Println(run["id"], run["status"])
}

202 Accepted

{
  "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
  "status": "queued",
  "platform": "tiktok",
  "endpoint": "replies",
  "target": "7212345678901234567",
  "url": "https://www.tiktok.com/video/7212345678901234567?comment_id=7213456789012345678",
  "result_count": 0,
  "created_at": "2026-08-28T16:21:04Z"
}

example

{
  "run": {
    "id": "8f14e45f-ceea-467a-9c2e-1b0f5a4c7d21",
    "status": "succeeded",
    "platform": "tiktok",
    "endpoint": "replies",
    "target": "7212345678901234567",
    "url": "https://www.tiktok.com/video/7212345678901234567?comment_id=7213456789012345678",
    "result_count": 2,
    "requested": 25,
    "estimated_cost": 125,
    "captures": 1,
    "created_at": "2026-08-22T09:11:03Z",
    "started_at": "2026-08-22T09:12:03Z",
    "finished_at": "2026-08-22T09:14:03Z"
  },
  "unit": "comment",
  "results": [
    {
      "id": "7213456789012345678",
      "text": "The sound delay at that distance is unreal.",
      "created_at": "2026-08-22T09:21:52Z",
      "like_count": 8841,
      "reply_count": 46,
      "video_id": "7212345678901234567",
      "language": "en",
      "author": {
        "id": "6800000000000000001",
        "username": "orbitalmech",
        "url": "https://www.tiktok.com/@orbitalmech",
        "full_name": "Orbital Mechanics",
        "is_verified": false,
        "profile_pic_url": "https://tiktok.example/img/orbitalmech.jpeg"
      }
    },
    {
      "id": "7213456789012345679",
      "text": "Watched this forty times.",
      "created_at": "2026-08-22T09:15:20Z",
      "like_count": 1204,
      "reply_count": 3,
      "video_id": "7212345678901234567",
      "language": "en",
      "author": {
        "id": "6800000000000000002",
        "username": "padcam",
        "url": "https://www.tiktok.com/@padcam",
        "full_name": "Pad Cam",
        "is_verified": false,
        "profile_pic_url": "https://tiktok.example/img/padcam.jpeg"
      }
    }
  ],
  "page": {
    "limit": 2,
    "offset": 0,
    "returned": 2,
    "total": 2
  }
}

Try it