TikTok Shop Reviews API. Star ratings, text and photos, page by page.
Star ratings, text and photos for a product. We handle the proxies, blocks and platform changes.
TikTok Shop Reviews API at a glance
Returns the reviews a public TikTok Shop product page shows, from the product's link or ID, with star ratings, text and photos. Each review has the variant bought, when and from which country it was posted, whether the purchase is verified or the review incentivized, and the reviewer as TikTok Shop shows them: a masked name, and their TikTok user ID and avatar unless the review is anonymous.
GET /v1/tiktokshop/reviews
- 1 credit per page, $0.75–$1.97 per 1,000 pages
- 19 typed fields null when unknown
- 5 star ratings, text and photos per page, TikTok Shop's recommended order (the order its product page shows reviews in)
urlis all it needs, e.g.https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617
Send one request. Get up to 5 star ratings, text and photos 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://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617const params = new URLSearchParams({
url: "https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617",
});
const res = await fetch(`https://socialtap.dev/v1/tiktokshop/reviews?${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, page, meta } = body;
console.log(data, meta.credits_charged);import os
import requests
res = requests.get(
"https://socialtap.dev/v1/tiktokshop/reviews",
params={"url": "https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617"},
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, page, meta = body["data"], body["page"], body["meta"]
print(data, meta["credits_charged"])require "json"
require "net/http"
uri = URI("https://socialtap.dev/v1/tiktokshop/reviews")
uri.query = URI.encode_www_form('url' => 'https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617')
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([
'url' => 'https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617',
]);
$ch = curl_init('https://socialtap.dev/v1/tiktokshop/reviews?' . $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("url", "https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617")
req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktokshop/reviews?"+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"`
Page json.RawMessage `json:"page"`
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/tiktokshop/reviews' \
--data-urlencode 'url=https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617' \
-H "x-api-key: $SOCIALTAP_API_KEY"{
"data": [
{
"approximate_fields": [],
"author": {
"avatar_url": null,
"display_name": "🌈**😂",
"id": null,
"is_verified": null,
"url": null,
"username": null
},
"country_code": "US",
"id": "7643069466080282382",
"is_incentivized": false,
"is_verified_purchase": true,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fec693639a5e4f23b2a073abe6aaafcd~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
},
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/caac5b714ac94c09b42b4447d29af5ad~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
},
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/d48509acfcff48e986d8a65d34b1bdaa~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
}
],
"metrics": {
"helpful_count": null
},
"platform": "tiktokshop",
"platform_specific": {},
"product_id": "1729477768109462617",
"published_at": "2026-05-23T12:53:11Z",
"rating": 1,
"text": "Terrible experience cuz the nerve 2 charge my card and never deLiver package IS not OK❗️I will never order from these ppl and trynna get replacement,return and/or refund has been denied-6x🤬‼️🧐🧐Im sick & tired of sellers like this one & am obviously a very dissatisfied customer🛑Af…",
"title": null,
"unknown_fields": [],
"url": null,
"variant_id": "1732274509536399449",
"variant_title": "60s x 4"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/fcefca9f7b252860d895d397be45c2a2~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=e81fcc75&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5",
"display_name": "M**s L**a L**a 🐲**🫶",
"id": "6813476641236632581",
"is_verified": null,
"url": null,
"username": null
},
"country_code": "US",
"id": "7686563692952684301",
"is_incentivized": false,
"is_verified_purchase": true,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/7bf0bd8ba0984350823b7491ff499ade~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
},
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/8edda6e8ce3e48b4be07c0e1d8139529~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
},
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e79176ec2ed94d0693dda8a1699c89a2~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
}
],
"metrics": {
"helpful_count": null
},
"platform": "tiktokshop",
"platform_specific": {},
"product_id": "1729477768109462617",
"published_at": "2026-09-17T17:52:59Z",
"rating": 5,
"text": "My first purchase I did the two packs and I didn’t think I was going to like them, but I absolutely fell in love with you. Don’t eat more than two a day but they are sweet eat white candy. I have ADHD 52 years old. I’m never sleepy melatonin never work this melatonin actually abs…",
"title": null,
"unknown_fields": [],
"url": null,
"variant_id": "1732274543402061913",
"variant_title": "60s x 1"
},
{
"approximate_fields": [],
"author": {
"avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/12c5eb38039e055d47d0b131bccf0d88~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=08b28932&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=5f8d3399&idc=useast5",
"display_name": "S**e B**e",
"id": "7480343496907211818",
"is_verified": null,
"url": null,
"username": null
},
"country_code": "US",
"id": "7640667122487297806",
"is_incentivized": false,
"is_verified_purchase": true,
"language": null,
"media": [
{
"alt_text": null,
"duration_ms": null,
"expires_at": null,
"height": null,
"thumbnail_url": null,
"type": "image",
"url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fe8c90c12f854650987caf0dbe6b48ff~tplv-fhlh96nyum-crop-webp:300:300.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
"width": null
}
],
"metrics": {
"helpful_count": null
},
"platform": "tiktokshop",
"platform_specific": {},
"product_id": "1729477768109462617",
"published_at": "2026-05-17T01:31:10Z",
"rating": 5,
"text": "The product bag was bigger than I expected\nFlavor: Is really good I dont feel anyone would be disappointed with the flavor\nPerformance: Ill be starting tonight so we shall see. Ive used ashwaganda before, worked like a charm. So Im assure this will be a hit as well",
"title": null,
"unknown_fields": [],
"url": null,
"variant_id": "1732274543402061913",
"variant_title": "60s x 1"
}
],
"page": {
"has_more": false,
"next_cursor": null,
"next_cursor_expires_at": null,
"end_reason": "platform_limit"
},
"meta": {
"request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
"platform": "tiktokshop",
"source": "page",
"is_cached": false,
"credits_charged": 1,
"latency_ms": 1507,
"fetched_at": "2026-10-25T12:00:00Z",
"input": {
"kind": "product",
"id": "1729477768109462617",
"url": "https://shop.tiktok.com/us/pdp/1729477768109462617"
},
"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.tiktokshop.reviews.list({ url: "https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617" });
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 = "url=" + encode("https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617");
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://socialtap.dev/v1/tiktokshop/reviews?" + 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("&",
"url=" + Uri.EscapeDataString("https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617"));
var res = await http.GetAsync("https://socialtap.dev/v1/tiktokshop/reviews?" + 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/tiktokshop/reviews")
.query(&[("url", "https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617")])
.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/tiktokshop/reviewsLong arrays and strings are shortened here. Real responses are complete.Docs One schema on 2 platforms.
The response reference lists every field, its type and when it is null. See the full schema.
Null means unknown
A field TikTok Shop doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
A TikTok Shop product link (shop.tiktok.com/us/pdp/<slug>/<id>, www.tiktok.com/shop/pdp/<id>, or the app's /view/product/<id> link) or the product ID. US products.
Write one parser
TikTok Shop and Amazon answer in these fields, so the code that reads one reads them all.
platformstring- Platform ID (tiktokshop, …).
idstring- Platform-native review ID (string).
product_idstring- ID of the product reviewed (equals product.id); null only for a review of something other than a product.
urlstring- Permalink, when the platform has one (TikTok Shop reviews have none).
ratinginteger- Star rating, 1 to 5; null when the review gives none.
titlestring- The review's headline; null when it has none.
textstring- Review body as plain text; null for a rating without text.
languagestring- BCP-47 language of text, when the platform states it.
Live data from 33 platforms.
What teams build with the TikTok Shop Reviews API.
Read what buyers say before sourcing a product
Collect review photos for product research
Monitor the top reviews on a competitor's product
Good to know before you build.
- Logged out, TikTok Shop serves only the first page of a product's reviews, in its recommended order, so the list ends there with page.end_reason platform_limit when the product has more.
- The review count, the average rating and the star breakdown belong to the product and come from the TikTok Shop Product API.
- TikTok Shop masks reviewer names, and an anonymous review has no reviewer ID or avatar.
- US products only: TikTok Shop serves each market's products only inside that market.
1 credit per page. Failed requests are free.
Buy credits once and spend them on any endpoint, on any platform.
| Source | Price per successful page | Per 1,000 pages |
|---|---|---|
Public page page | 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 Shop Reviews API.
More in the API reference.
How much does the TikTok Shop Reviews API cost?
A page of up to 5 star ratings, text and photos costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.
How do I get the next page?
Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.
Try it on a link you already have.
Paste it in the playground, or copy the request into your code.
100free credits
- No credit card
- Failed requests are free
- Works on all 218 endpoints