InsightSocial API
TikTok Shop

TikTok Shop Product Reviews API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/tiktokshop/product/reviews?url=https%3A%2F%2Fwww.tiktok.com%2Fshop%2Fpdp%2Fcat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats%2F1731578642912612516" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/tiktokshop/product/reviews

Returns reviews on a TikTok Shop product: rating, text, author, buyer country, verified-purchase and incentivized-review flags, the purchased SKU, and a timestamp.

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Schema 2.

Use it when you have a product URL or ID and want what buyers say; use product for the listing itself.

10 credits per call.

Paginates by cursor: see Pagination.

Authorization

apiKey
x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

url?string

Full URL of the TikTok Shop product page. Provide this or product_id. Provide at least one of: url, product_id.

product_id?string

The ID of the product (required if url is not provided). Provide at least one of: url, product_id.

region?string

ISO 3166-1 alpha-2 region for the product (e.g. US). Important when the product is regionally scoped.

Value in

  • "US"
  • "GB"
  • "DE"
  • "FR"
  • "IT"
  • "ID"
  • "MY"
  • "MX"
  • "PH"
  • "SG"
  • "ES"
  • "TH"
  • "VN"
  • "BR"
  • "JP"
  • "IE"
page?integer

Page number to retrieve, 10 reviews per page. Prefer passing back pagination.next_cursor, which carries the same position and stays correct if the underlying paging mechanism changes.

Range1 <= value
dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"
cursor?string

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/tiktokshop/product/reviews"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}

Videos › Popular GET

Returns TikTok's Top Videos board for the US, Japan, Vietnam, Thailand or Indonesia over 7 or 30 days: each video's rank, lifetime and window views, organic views, engagement rate and creator.

Product GET

Returns one TikTok Shop product in full: description, price and discount, rating, review count, brand, specs, stock, seller details, shipping estimate, and images.