# 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.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktokshop.reviews)

## 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`

[Read the API reference](https://socialtap.dev/docs/reference/tiktokshop/reviews/index.md)

- **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)
- **`url`** is 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 socialtap`

`url = https://shop.tiktok.com/us/pdp/root-labs-liposomal-magnesium-gummies-stress-relief-sleep/1729477768109462617`

[Open in playground](https://socialtap.dev/playground/?endpoint=tiktokshop.reviews)

cURL:

```shell
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"
```

TypeScript SDK:

```typescript
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);
```

Node.js (fetch):

```javascript
const 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);
```

Python (requests):

```python
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"])
```

Go (net/http):

```go
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"])
}
```

200 OK:

```json
{
  "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": []
  }
}
```

Long arrays and strings are shortened here. Real responses are complete.

## One schema on 2 platforms.

The [response reference](https://socialtap.dev/docs/reference/tiktokshop/reviews/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/review/index.md).

- ### 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.

- **`platform`string**: Platform ID (tiktokshop, …).
- **`id`string**: Platform-native review ID (string).
- **`product_id`string**: ID of the product reviewed (equals product.id); null only for a review of something other than a product.
- **`url`string**: Permalink, when the platform has one (TikTok Shop reviews have none).
- **`rating`integer**: Star rating, 1 to 5; null when the review gives none.
- **`title`string**: The review's headline; null when it has none.
- **`text`string**: Review body as plain text; null for a rating without text.
- **`language`string**: BCP-47 language of text, when the platform states it.

Live data from 33 platforms.

[TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md)

## 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.

[Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/tiktokshop/reviews/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| 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](https://socialtap.dev/docs/reference/tiktokshop/reviews/index.md).

**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.

Other platforms

## Reviews on 1 more platform.

- [Amazon Reviews API](https://socialtap.dev/apis/amazon/reviews/index.md) (1 credit / page · `GET /v1/amazon/reviews`)

More TikTok Shop

## TikTok Shop API. 4 endpoints, one key.

- [TikTok Shop Product API](https://socialtap.dev/apis/tiktokshop/product/index.md) (1 credit · `GET /v1/tiktokshop/product`)
- [TikTok Shop Search API](https://socialtap.dev/apis/tiktokshop/search_products/index.md) (1 credit / page · `GET /v1/tiktokshop/search_products`)
- [TikTok Shop Store Products API](https://socialtap.dev/apis/tiktokshop/products/index.md) (1 credit / page · `GET /v1/tiktokshop/products`)

## 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

[Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md)

---

[HTML version](https://socialtap.dev/apis/tiktokshop/reviews/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)