TikTok Shop 商品詳細
TikTok Shop 商品詳細 API でEC データ API の連携を行えます。リクエストパラメーター、レスポンスのフィールド、実行可能なコード例を確認してください。
API データの例
このエンドポイントのリクエスト本文とレスポンス全体の構造を確認できます。
{
"marketplace": "US",
"productId": "1732733071713276641"
}{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"product_id": "1732733071713276641",
"title": "Protective Casing - Creative Curved Geometric Art Design, Shockproof Drop-Proof TPU, Magnetic Masked Metal Frameless Edge, Black Christmas Reindeer/Delight Tree Theme, For iPhone 18 17 16 15 14 13 Pro ProMax Plus & For Samsung Galaxy S26-21 Ultra Plus FE.",
"status": 1,
"currency": "USD",
"min_price": 3.94,
"max_price": 10.4,
"sold_count": 250,
"rating": 4.5,
"review_count": 13,
"images": [
"https://p16-oec-general.ttcdn-us.com/tos-alisg-i-aphluv4xwc-sg/590f1a6a583866b9a2418f15c6822df6~tplv-fhlh96nyum-crop-webp:800:800.webp",
"https://p16-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/d7a718ace2f34eba85f37cab0827be8a~tplv-fhlh96nyum-crop-webp:800:800.webp"
],
"specifications": [
{
"name": "Strap material",
"value": "Non-woven"
},
{
"name": "Feature",
"value": "Magnetic,Shockproof"
},
{
"name": "Finish",
"value": "Matte"
},
{
"name": "Style",
"value": "Fashion y2k"
}
],
"skus": [
{
"sku_id": "1732733071529317089",
"price": 10.4,
"original_price": 24.3,
"stock": 994,
"properties": [
{
"name": "Color",
"value": "1"
},
{
"name": "model",
"value": "iPhone 17 Pro Max/18 Pro Max"
}
]
},
{
"sku_id": "1732733071529710305",
"price": 10.4,
"original_price": 24.3,
"stock": 997,
"properties": [
{
"name": "Color",
"value": "1"
},
{
"name": "model",
"value": "iPhone 17 Pro/18 Pro"
}
]
}
],
"categories": [
{
"category_id": "601739",
"name": "Phones & Electronics"
},
{
"category_id": "909064",
"name": "Mobile Phone Accessories"
},
{
"category_id": "601925",
"name": "Cases, Screen Protectors & Stickers"
},
{
"category_id": "1126672",
"name": "Cases & Covers"
}
],
"seller": {
"seller_id": "7494702799291713249",
"shop_name": "CoreCover",
"sold_count": 37483,
"review_count": 2287,
"product_count": 559,
"follower_count": 3481,
"rating": 4.6
}
}
}このページでは 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/detail
The request and response fields below match the current public contract.
API マッピング
| Item | Value |
|---|---|
| MCP Code | tiktok_shop_products_detail |
クイック呼び出し
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/detail \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"productId": "1732733071713276641"
}'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 Details" 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-details
Endpoint: POST https://ecommercedataapi.com/v1/tiktok/shop/products/detail
API key environment variable: ECOMMERCE_DATA_API_KEY
Example request:
{
"marketplace": "US",
"productId": "1732733071713276641"
}
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.
Set the apiKey collection variable after import.Create API key
Node.js example
const response = await fetch(
'https://ecommercedataapi.com/v1/tiktok/shop/products/detail',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': process.env.ECOMMERCE_DATA_API_KEY,
},
body: JSON.stringify({
marketplace: 'US',
productId: '1732733071713276641',
}),
}
);
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/detail",
headers={
"Content-Type": "application/json",
"X-API-Key": os.environ["ECOMMERCE_DATA_API_KEY"],
},
json={
"marketplace": "US",
"productId": "1732733071713276641",
},
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. | 1732733071713276641 |
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 |
|---|---|---|---|
product_id | String | Product ID. | 1732733071713276641 |
title | String | Product title. | - |
status | Integer | Listing status; 1 means on sale. | 1 |
currency | String | Currency code. | USD |
min_price | Number | Lowest SKU price. | 3.94 |
max_price | Number | Highest SKU price. | 10.4 |
sold_count | Integer | Cumulative units sold. | 250 |
rating | Number | Average rating, 0–5. | 4.5 |
review_count | Integer | Number of reviews. | 13 |
images | Array | Image URLs. | - |
specifications | Array | Attribute name and value pairs. | - |
skus.sku_id | String | SKU ID. | - |
skus.price | Number | SKU selling price. | - |
skus.original_price | Number | SKU list price. | - |
skus.stock | Integer | Units in stock. | - |
skus.properties | Array | Variant attributes such as color and size. | - |
categories | Array | Category path from top level down; may be empty. | - |
seller.seller_id | String | Seller ID. | - |
seller.shop_name | String | Shop name. | - |
seller.sold_count | Integer | Units sold across the shop. | - |
seller.review_count | Integer | Reviews across the shop. | - |
seller.product_count | Integer | Products the shop lists. | - |
seller.follower_count | Integer | Shop followers. | - |
seller.rating | Number | Shop rating, 0–5. | - |
Response example
{
"request_id": "8fb43e59-4ff9-4dc8-a4b7-2ed164e45ab8",
"data": {
"product_id": "1732733071713276641",
"title": "Protective Casing - Creative Curved Geometric Art Design, Shockproof Drop-Proof TPU, Magnetic Masked Metal Frameless Edge, Black Christmas Reindeer/Delight Tree Theme, For iPhone 18 17 16 15 14 13 Pro ProMax Plus & For Samsung Galaxy S26-21 Ultra Plus FE.",
"status": 1,
"currency": "USD",
"min_price": 3.94,
"max_price": 10.4,
"sold_count": 250,
"rating": 4.5,
"review_count": 13,
"images": [
"https://p16-oec-general.ttcdn-us.com/tos-alisg-i-aphluv4xwc-sg/590f1a6a583866b9a2418f15c6822df6~tplv-fhlh96nyum-crop-webp:800:800.webp",
"https://p16-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/d7a718ace2f34eba85f37cab0827be8a~tplv-fhlh96nyum-crop-webp:800:800.webp"
],
"specifications": [
{
"name": "Strap material",
"value": "Non-woven"
},
{
"name": "Feature",
"value": "Magnetic,Shockproof"
},
{
"name": "Finish",
"value": "Matte"
},
{
"name": "Style",
"value": "Fashion y2k"
}
],
"skus": [
{
"sku_id": "1732733071529317089",
"price": 10.4,
"original_price": 24.3,
"stock": 994,
"properties": [
{
"name": "Color",
"value": "1"
},
{
"name": "model",
"value": "iPhone 17 Pro Max/18 Pro Max"
}
]
},
{
"sku_id": "1732733071529710305",
"price": 10.4,
"original_price": 24.3,
"stock": 997,
"properties": [
{
"name": "Color",
"value": "1"
},
{
"name": "model",
"value": "iPhone 17 Pro/18 Pro"
}
]
}
],
"categories": [
{
"category_id": "601739",
"name": "Phones & Electronics"
},
{
"category_id": "909064",
"name": "Mobile Phone Accessories"
},
{
"category_id": "601925",
"name": "Cases, Screen Protectors & Stickers"
},
{
"category_id": "1126672",
"name": "Cases & Covers"
}
],
"seller": {
"seller_id": "7494702799291713249",
"shop_name": "CoreCover",
"sold_count": 37483,
"review_count": 2287,
"product_count": 559,
"follower_count": 3481,
"rating": 4.6
}
}
}See Errors and rate limits for error payloads, request tracing, and rate-limit headers.