TikTok Shop 商品レビュー

TikTok Shop 商品レビュー API でEC データ API の連携を行えます。リクエストパラメーター、レスポンスのフィールド、実行可能なコード例を確認してください。

このページでは Ecommerce Data API の公開契約を説明します。フィールド名、パス、技術例はそのまま保持しているため、そのまま統合できます。

Availability: Available

This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 1 billing unit.

POST /v1/tiktok/shop/products/reviews

The request and response fields below match the current public contract.

API マッピング

Item	Value
MCP Code	`tiktok_shop_products_reviews`

クイック呼び出し

First create an API key, then store it in a server-side environment variable:

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/tiktok/shop/products/reviews \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "US",
  "productId": "1732307789426299610",
  "sort": "recent"
}'

Integrate with an AI CLI

Copy for your AI CLI

Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.

Integrate the "TikTok Shop Product Reviews" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.

API documentation: https://ecommercedataapi.com/en/docs/tiktok/shop/product-reviews
Endpoint: POST https://ecommercedataapi.com/v1/tiktok/shop/products/reviews
API key environment variable: ECOMMERCE_DATA_API_KEY

Example request:
{
"marketplace": "US",
"productId": "1732307789426299610",
"sort": "recent"
}

Requirements:
1. Read the API documentation first, then inspect the repository's language, framework, HTTP client, directory structure, and environment-variable conventions.
2. Reuse the existing API client and error-handling patterns. If none exist, add the smallest reusable Ecommerce Data API client and an endpoint-specific wrapper.
3. Read the key from the server-side ECOMMERCE_DATA_API_KEY environment variable and send Content-Type: application/json plus the X-API-Key header. Never write a real key into source code, browser code, logs, test snapshots, or Git.
4. If the environment variable is missing, tell me to configure ECOMMERCE_DATA_API_KEY myself. Do not request, print, or invent the real key, and continue implementing code and tests that do not require a live request.
5. Implement request and response types from the documentation. Handle non-2xx responses, request_id, error.code, error.message, and 429 rate limits.
6. Add a minimal usage example or test that follows the repository's conventions. Run one minimal live request only when the key is already configured and external requests are allowed; otherwise use mocks or static validation.
7. Run the relevant formatter, type checker, and tests. Report changed files, usage, verification results, and any environment variable I still need to configure.

Need an API key?Create API key

Open this request in Postman

Download the preconfigured collection for this endpoint, then import it into Postman.

Download Postman config

Set the apiKey collection variable after import.Create API key

Node.js example

const response = await fetch(
  'https://ecommercedataapi.com/v1/tiktok/shop/products/reviews',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      productId: '1732307789426299610',
      sort: 'recent',
    }),
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
}

console.log(result.data);

Python example

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/tiktok/shop/products/reviews",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
    },
    json={
        "marketplace": "US",
        "productId": "1732307789426299610",
        "sort": "recent",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["data"])

Request body

Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.

Field	Type	Required	Description	Example
`marketplace`	String	No	Marketplace. Supported: US, SG, MY. Available values (Table 1.2): US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU, AE	US
`productId`	String	Yes	TikTok Shop product ID, 16–20 digits.	1732307789426299610
`sort`	String	No	Order: `recent` (newest first) or `recommended`.	recent
`rating`	Integer	No	Only reviews with this star rating, 1–5. Omit for all.	5
`cursor`	String	No	Opaque cursor from the previous response's `next_cursor`. Omit for the first page.	eyJwYWdlIjoyfQ

Response structure

Field	Type	Description
`request_id`	String	Unique identifier for this request.
`data`	Object	Endpoint business data.

The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].

Response fields

Field	Type	Description	Example
`total_reviews`	Integer	Total reviews of the product.	744
`reviews.review_id`	String	Review ID.	-
`reviews.rating`	Integer	Star rating, 1–5.	5
`reviews.text`	String	Review text; may be empty.	-
`reviews.sku_id`	String	SKU the reviewer bought.	-
`reviews.sku_specification`	String	Variant the reviewer bought.	-
`reviews.country`	String	Reviewer country.	US
`reviews.verified_purchase`	Boolean	Whether the purchase is verified.	true
`reviews.incentivized`	Boolean	Whether the review was incentivized.	false
`reviews.reviewed_at`	String	Review time, ISO 8601.	-
`reviews.image_urls`	Array	Images attached to the review.	-
`has_more`	Boolean	Whether another page is available.	true
`next_cursor`	String	Pass as `cursor` to get the next page; null on the last page.	-

Response example

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "total_reviews": 744,
    "reviews": [
      {
        "review_id": "7703674785525778190",
        "rating": 4,
        "text": "Very thick material but im 4’11 and its a bit too long",
        "sku_id": "1732315284744934106",
        "sku_specification": "Pink, S",
        "country": "US",
        "verified_purchase": true,
        "incentivized": false,
        "reviewed_at": "2026-11-02T20:32:59.471Z",
        "image_urls": []
      },
      {
        "review_id": "7703645980658370318",
        "rating": 4,
        "text": "Sooo cute! I love wearing it to the gym and it’s true to size",
        "sku_id": "1732307789427086042",
        "sku_specification": "Black, S",
        "country": "US",
        "verified_purchase": true,
        "incentivized": true,
        "reviewed_at": "2026-11-02T18:41:09.240Z",
        "image_urls": []
      }
    ],
    "has_more": true,
    "next_cursor": "eyJwYWdlIjoyfQ"
  }
}

See Errors and rate limits for error payloads, request tracing, and rate-limit headers.

このページでは Ecommerce Data API の公開契約を説明します。フィールド名、パス、技術例はそのまま保持しているため、そのまま統合できます。

Availability: Available

This endpoint is active in the v1 gateway, OpenAPI, and subscription catalog. A successful call consumes 1 billing unit.

POST /v1/tiktok/shop/products/reviews

The request and response fields below match the current public contract.

API マッピング

Item	Value
MCP Code	`tiktok_shop_products_reviews`

クイック呼び出し

First create an API key, then store it in a server-side environment variable:

export ECOMMERCE_DATA_API_KEY="your_api_key"

curl --request POST \
  --url https://ecommercedataapi.com/v1/tiktok/shop/products/reviews \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
  "marketplace": "US",
  "productId": "1732307789426299610",
  "sort": "recent"
}'

Integrate with an AI CLI

Copy for your AI CLI

Paste this task into Codex, Claude Code, Gemini CLI, or another coding agent.

Integrate the "TikTok Shop Product Reviews" endpoint from Ecommerce Data API into the current repository. Make the changes directly instead of only returning sample code.

Example request:
{
"marketplace": "US",
"productId": "1732307789426299610",
"sort": "recent"
}

Need an API key?Create API key

Open this request in Postman

Download the preconfigured collection for this endpoint, then import it into Postman.

Download Postman config

Set the apiKey collection variable after import.Create API key

Node.js example

const response = await fetch(
  'https://ecommercedataapi.com/v1/tiktok/shop/products/reviews',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
    },
    body: JSON.stringify({
      marketplace: 'US',
      productId: '1732307789426299610',
      sort: 'recent',
    }),
  }
);

const result = await response.json();

if (!response.ok) {
  throw new Error(`${result.error?.code}: ${result.error?.message}`);
}

console.log(result.data);

Python example

import os
import requests

response = requests.post(
    "https://ecommercedataapi.com/v1/tiktok/shop/products/reviews",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
    },
    json={
        "marketplace": "US",
        "productId": "1732307789426299610",
        "sort": "recent",
    },
    timeout=30,
)

response.raise_for_status()
print(response.json()["data"])

Request body

Send the fields below directly in the JSON body without an extra wrapper. Undefined fields are rejected.

Field	Type	Required	Description	Example
`marketplace`	String	No	Marketplace. Supported: US, SG, MY. Available values (Table 1.2): US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU, AE	US
`productId`	String	Yes	TikTok Shop product ID, 16–20 digits.	1732307789426299610
`sort`	String	No	Order: `recent` (newest first) or `recommended`.	recent
`rating`	Integer	No	Only reviews with this star rating, 1–5. Omit for all.	5
`cursor`	String	No	Opaque cursor from the previous response's `next_cursor`. Omit for the first page.	eyJwYWdlIjoyfQ

Response structure

Field	Type	Description
`request_id`	String	Unique identifier for this request.
`data`	Object	Endpoint business data.

The fields below are inside data. For array endpoints they describe one array item; for paginated endpoints they describe one record in items[].

Response fields

Field	Type	Description	Example
`total_reviews`	Integer	Total reviews of the product.	744
`reviews.review_id`	String	Review ID.	-
`reviews.rating`	Integer	Star rating, 1–5.	5
`reviews.text`	String	Review text; may be empty.	-
`reviews.sku_id`	String	SKU the reviewer bought.	-
`reviews.sku_specification`	String	Variant the reviewer bought.	-
`reviews.country`	String	Reviewer country.	US
`reviews.verified_purchase`	Boolean	Whether the purchase is verified.	true
`reviews.incentivized`	Boolean	Whether the review was incentivized.	false
`reviews.reviewed_at`	String	Review time, ISO 8601.	-
`reviews.image_urls`	Array	Images attached to the review.	-
`has_more`	Boolean	Whether another page is available.	true
`next_cursor`	String	Pass as `cursor` to get the next page; null on the last page.	-

Response example

{
  "request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
  "data": {
    "total_reviews": 744,
    "reviews": [
      {
        "review_id": "7703674785525778190",
        "rating": 4,
        "text": "Very thick material but im 4’11 and its a bit too long",
        "sku_id": "1732315284744934106",
        "sku_specification": "Pink, S",
        "country": "US",
        "verified_purchase": true,
        "incentivized": false,
        "reviewed_at": "2026-11-02T20:32:59.471Z",
        "image_urls": []
      },
      {
        "review_id": "7703645980658370318",
        "rating": 4,
        "text": "Sooo cute! I love wearing it to the gym and it’s true to size",
        "sku_id": "1732307789427086042",
        "sku_specification": "Black, S",
        "country": "US",
        "verified_purchase": true,
        "incentivized": true,
        "reviewed_at": "2026-11-02T18:41:09.240Z",
        "image_urls": []
      }
    ],
    "has_more": true,
    "next_cursor": "eyJwYWdlIjoyfQ"
  }
}

See Errors and rate limits for error payloads, request tracing, and rate-limit headers.

API データの例

API マッピング

クイック呼び出し

Integrate with an AI CLI

Copy for your AI CLI

Open this request in Postman

Node.js example

Python example

Request body

Response structure

Response fields

Response example

このページの内容

TikTok Shop 商品レビュー

API データの例

API マッピング

クイック呼び出し

Integrate with an AI CLI

Copy for your AI CLI

Open this request in Postman

Node.js example

Python example

Request body

Response structure

Response fields

Response example

このページの内容