TikTok Shop商品详情 API (V1)
获取选定区域内商品 ID 的公开 TikTok Shop 商品详情。使用该接口在搜索或目录发现后检查已知的区域商品。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
token | query | string | 是 | - | 此API服务的鉴权令牌。 |
productId | query | string | 是 | - | TikTok Shop 产品 ID。 |
region | query | string | 否 | US | 商品详情的目标区域。 可选值: - US:美国- GB:英国- FR:法国- SG:新加坡- MY:马来西亚- PH:菲律宾- TH:泰国- VN:越南- ID:印度尼西亚 |
代码示例
curl --max-time 120 -X GET 'https://api.justoneapi.com/api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE'我想使用 JustOneAPI 提供的“商品详情 (V1)”接口。
接入地址: https://api.justoneapi.com。
接口路径: /api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE
接口地址: BASE_URL + /api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE
HTTP 方法: GET
身份验证: 在 URL 中传入 token 查询参数。
OpenAPI 定义: https://docs.justoneapi.com/openapi/tiktok-shop/product-details-v1-zh.json
请求参数说明:
- token (query): 此API服务的鉴权令牌。 (必填)
- productId (query): TikTok Shop 产品 ID。 (必填)
- region (query): 商品详情的目标区域。
可选值:
- `US`:美国
- `GB`:英国
- `FR`:法国
- `SG`:新加坡
- `MY`:马来西亚
- `PH`:菲律宾
- `TH`:泰国
- `VN`:越南
- `ID`:印度尼西亚
返回格式: 请根据实际 Content-Type 安全处理 JSON 或文本响应。
响应处理与错误码:
1. 需通过返回体中的 "code" 字段判断业务结果(code 为 0 表示成功)。
2. 超时建议:建议将请求超时时间设置为 120 秒;如果 120 秒偏长,请至少设置为 60 秒,但可能会有少量请求因超时而未接收到结果。
3. 业务码说明:
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败,请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 账户余额不足
- 602: TOKEN 限额超限
4. code 601 表示账户共享余额不足。code 602 表示当前 API TOKEN 自身的累计消费上限已达到。TOKEN 限额不是资金划拨,多个 TOKEN 仍共享同一个账户余额。
请帮我用我擅长的编程语言写一个脚本来调用这个接口,并处理返回结果。import requests
BASE_URL = "https://api.justoneapi.com" # 由 OpenAPI servers 提供
url = BASE_URL + "/api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE"
response = requests.get(url, timeout=120)
print(response.status_code)
if response.content:
content_type = response.headers.get("content-type", "").lower()
if "json" in content_type:
try:
print(response.json())
except ValueError:
print(response.text)
elif content_type.startswith("text/") or "xml" in content_type or content_type.split(";", 1)[0].strip() in {"application/javascript", "application/x-www-form-urlencoded", "application/graphql"}:
print(response.text)
else:
with open("response.bin", "wb") as output:
output.write(response.content)
print(f"Saved {len(response.content)} bytes to response.bin")const BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
const url = BASE_URL + "/api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE";
const response = await fetch(url, {
method: "GET",
signal: AbortSignal.timeout(120000)
});
console.log(response.status);
const responseBytes = await response.arrayBuffer();
if (responseBytes.byteLength) {
const contentType = (response.headers.get("content-type") || "").toLowerCase();
const mediaType = contentType.split(";", 1)[0].trim();
const textual = contentType.startsWith("text/") || contentType.includes("json") || contentType.includes("xml") || ["application/javascript", "application/x-www-form-urlencoded", "application/graphql"].includes(mediaType);
if (textual) {
const responseText = new TextDecoder().decode(responseBytes);
let data = responseText;
if (contentType.includes("json")) {
try { data = JSON.parse(responseText); } catch { /* Keep the raw body. */ }
}
console.log(data);
} else {
console.log(`Received ${responseBytes.byteLength} binary bytes`);
}
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
public class Main {
public static void main(String[] args) throws Exception {
final String BASE_URL = "https://api.justoneapi.com"; // 由 OpenAPI servers 提供
final String url = BASE_URL + "/api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE";
HttpClient client = HttpClient.newBuilder().connectTimeout(Duration.ofSeconds(120)).build();
HttpRequest.Builder builder = HttpRequest.newBuilder()
.uri(URI.create(url))
.timeout(Duration.ofSeconds(120))
.method("GET", HttpRequest.BodyPublishers.noBody());
HttpRequest request = builder.build();
HttpResponse<byte[]> response = client.send(request, HttpResponse.BodyHandlers.ofByteArray());
System.out.println(response.statusCode());
String contentType = response.headers().firstValue("content-type").orElse("").toLowerCase();
String mediaType = contentType.split(";", 2)[0].trim();
if (contentType.startsWith("text/") || contentType.contains("json") || contentType.contains("xml") || mediaType.equals("application/javascript") || mediaType.equals("application/x-www-form-urlencoded") || mediaType.equals("application/graphql")) {
System.out.println(new String(response.body(), StandardCharsets.UTF_8));
} else {
Files.write(Path.of("response.bin"), response.body());
System.out.println("Saved " + response.body().length + " bytes to response.bin");
}
}
}package main
import (
"fmt"
"io"
"os"
"strings"
"net/http"
"time"
)
const BASE_URL = "https://api.justoneapi.com" // 由 OpenAPI servers 提供
func main() {
client := &http.Client{Timeout: 120 * time.Second}
url := BASE_URL + "/api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
fmt.Println(resp.StatusCode)
bodyBytes, _ := io.ReadAll(resp.Body)
contentType := strings.ToLower(resp.Header.Get("Content-Type"))
mediaType := strings.TrimSpace(strings.SplitN(contentType, ";", 2)[0])
if strings.HasPrefix(contentType, "text/") || strings.Contains(contentType, "json") || strings.Contains(contentType, "xml") || mediaType == "application/javascript" || mediaType == "application/x-www-form-urlencoded" || mediaType == "application/graphql" {
fmt.Println(string(bodyBytes))
} else {
os.WriteFile("response.bin", bodyBytes, 0600)
fmt.Printf("Saved %d bytes to response.bin\n", len(bodyBytes))
}
}<?php
$BASE_URL = 'https://api.justoneapi.com'; // 由 OpenAPI servers 提供
$url = $BASE_URL . '/api/tiktok-shop/get-product-detail/v1?token=YOUR_API_KEY&productId=VALUE';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 120);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$contentType = strtolower((string) curl_getinfo($ch, CURLINFO_CONTENT_TYPE));
curl_close($ch);
echo $status . PHP_EOL;
$mediaType = trim(explode(';', $contentType, 2)[0]);
if (str_starts_with($contentType, 'text/') || str_contains($contentType, 'json') || str_contains($contentType, 'xml') || in_array($mediaType, ['application/javascript', 'application/x-www-form-urlencoded', 'application/graphql'], true)) {
echo $response;
} else {
file_put_contents('response.bin', $response);
echo 'Saved ' . strlen($response) . ' bytes to response.bin' . PHP_EOL;
}返回字段
业务成功时(code = 0)的主要返回字段。
地区状态与商品数据14 个字段
data
TikTok Shop 商品详情或地区可用性响应。
| 字段 | 类型 | 说明 |
|---|---|---|
region_supported | boolean | 地区可用性响应中,本次请求地区是否受支持。 |
region | string | 地区可用性响应中返回的请求地区。 |
supported_regions | array | 地区可用性响应同时返回的受支持地区列表。 |
supported_regions[] | string | 一个受支持的地区代码。 |
message | string | 地区可用性响应的说明。 |
product_data | object | 返回商品详情时的商品页面数据。 |
product_data.page_config | object | 包含商品详情板块的结构化页面配置。 |
product_data.page_config.components_map | array | 页面板块列表。商品详情板块的 component_type 为 product_info。 |
product_data.page_config.components_map[] | object | 一个商品页面板块。 |
product_data.page_config.components_map[].component_type | string | 页面板块的类型标识。 |
product_data.page_config.components_map[].component_name | string | 页面板块的名称。 |
product_data.page_config.components_map[].component_data | object | 该页面板块关联的数据。 |
product_data.page_config.components_map[].component_data.error_code | integer | 商品详情板块返回的状态码。 |
product_data.page_config.components_map[].component_data.error_message | string | 商品详情板块返回的状态说明。 |
商品基本信息18 个字段
data.product_data.page_config.components_map[].component_data.product_info
商品资料与交易字段。较早的部分响应使用嵌套商品数据结构。
| 字段 | 类型 | 说明 |
|---|---|---|
status | integer | 商品返回的状态代码。 |
sold_count | string | 商品销量,以文本返回。 |
product_id | string | TikTok Shop 商品标识,以字符串返回。 |
seller_id | string | 商品关联的卖家标识。 |
title | string | 商品标题。 |
sold_count_note | object | 商品销量标签和展示文字。 |
sold_count_note.title | string | 销量说明的标题。 |
sold_count_note.text | string | 销量说明的展示文字。 |
specifications | array | 名称和值组成的商品规格列表。 |
specifications[] | object | 一项商品参数。 |
specifications[].name | string | 规格的显示名称。 |
specifications[].value | string | 规格的显示值。 |
desc_blocks | array | 商品描述内容块。 |
desc_blocks[] | object | 一个商品描述块。 |
desc_blocks[].type | string | 该描述块返回的内容类型。 |
desc_blocks[].text | string | 该商品描述块的文字。 |
desc_blocks[].rich_text | object | 该描述块的富文本内容。 |
desc_blocks[].rich_text.template | string | 描述块的文字模板。 |
商品图片16 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
images | array | 商品展示图片。 |
images[] | object | 一张商品展示图片。 |
images[].height | integer | 图片高度,单位为像素。 |
images[].width | integer | 图片宽度,单位为像素。 |
images[].url_list | array | 该图片资源返回的链接列表。 |
images[].url_list[] | string | 该图片资源的一个链接。 |
images[].uri | string | 图片引用标识。 |
images[].thumb_uri | string | 图片缩略图的引用标识。 |
images[].thumb_url_list | array | 图片返回的缩略图链接列表。 |
images[].thumb_url_list[] | string | 该图片缩略图的一个链接。 |
promotion_logos | array | 用于展示商品促销信息的图片。 |
promotion_logos[] | object | 一张商品促销图片。 |
promotion_logos[].height | integer | 图片高度,单位为像素。 |
promotion_logos[].width | integer | 图片宽度,单位为像素。 |
promotion_logos[].url_list | array | 该图片资源返回的链接列表。 |
promotion_logos[].url_list[] | string | 该图片资源的一个链接。 |
价格、SKU 与变体36 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
price | object | 商品的价格展示信息。 |
price.is_interval_price | boolean | 商品是否返回价格区间。 |
price.real_price | string | 商品价格的展示文字。 |
price.currency | string | 商品价格返回的货币代码。 |
price.currency_symbol | string | 商品价格的货币展示符号。 |
price.min_sku_price | string | 返回的最低 SKU 价格,以文本表示。 |
sale_props | array | 商品可选的变体属性。 |
sale_props[] | object | 一项商品变体属性。 |
sale_props[].has_image | boolean | 变体属性是否有关联图片。 |
sale_props[].has_extended_images | boolean | 该变体属性是否有扩展图片。 |
sale_props[].prop_id | string | 商品变体属性标识。 |
sale_props[].prop_name | string | 变体属性的显示名称。 |
sale_props[].sale_prop_values | array | 该变体属性的可选值。 |
sale_props[].sale_prop_values[] | object | 一个可选变体值。 |
sale_props[].sale_prop_values[].prop_value_id | string | 变体值标识。 |
sale_props[].sale_prop_values[].prop_value | string | 变体值的显示名称。 |
skus | array | 商品返回的 SKU 列表。 |
skus[] | object | 一条可选 SKU 记录。 |
skus[].status | integer | 该 SKU 返回的状态代码。 |
skus[].stock | integer | 该 SKU 返回的库存数量。 |
skus[].purchase_limit | integer | 该 SKU 返回的购买数量限制。 |
skus[].sku_id | string | TikTok Shop SKU 标识,以字符串返回。 |
skus[].sale_prop_value_ids | string | 该 SKU 返回的变体值标识文本。 |
skus[].sku_sale_props | array | 用于区分该 SKU 的变体属性。 |
skus[].sku_sale_props[] | object | 该 SKU 的一项变体属性。 |
skus[].sku_sale_props[].prop_id | string | 商品变体属性标识。 |
skus[].sku_sale_props[].prop_name | string | 变体属性的显示名称。 |
skus[].sku_sale_props[].prop_value_id | string | 变体值标识。 |
skus[].sku_sale_props[].prop_value | string | 变体值的显示名称。 |
skus[].price | object | 该 SKU 的价格信息。 |
skus[].price.price_type | integer | SKU 返回的价格类型代码。 |
skus[].price.sale_price_format | string | SKU 的格式化销售价格文本。 |
skus[].price.currency_symbol | string | SKU 价格的货币展示符号。 |
skus[].price.sale_price_decimal | string | SKU 销售价,以十进制字符串返回。 |
skus[].price.currency_name | string | SKU 价格返回的货币代码。 |
default_sku_id | string | 商品默认 SKU 的标识。 |
配送与运费24 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
logistic | object | 商品返回的配送与运费详情。 |
logistic.delivery_option | integer | 返回的配送选项代码。 |
logistic.is_default | boolean | 该配送选项是否被标为默认。 |
logistic.free_shipping | boolean | 该配送选项是否标记为免运费。 |
logistic.reachable | boolean | 当前上下文是否返回可配送。 |
logistic.delivery_min_days | integer | 预计最短配送天数。 |
logistic.delivery_max_days | integer | 预计最长配送天数。 |
logistic.delivery_name | string | 配送选项的显示名称。 |
logistic.lead_time | string | 配送时效的文字说明。 |
logistic.shipping_fee | object | 返回的运费信息。 |
logistic.shipping_fee.price_str | string | 运费的展示文字。 |
logistic.shipping_fee.price_val | string | 运费金额文本。 |
logistic.shipping_fee.currency | string | 运费的货币代码。 |
logistic.original_shipping_val | string | 原始运费金额文本。 |
shipping_module | object | 商品展示的补充配送信息。 |
shipping_module.description_list | array | 配送说明列表。 |
shipping_module.description_list[] | object | 一项配送说明。 |
shipping_module.description_list[].text | string | 配送说明的展示文字。 |
shipping_module.appendix_list | array | 商品返回的配送附注列表。 |
shipping_module.appendix_list[] | object | 一项配送附注。 |
shipping_module.appendix_list[].text | string | 配送附注的展示文字。 |
lock_up_shipping | array | 商品附带的补充配送摘要列表。 |
lock_up_shipping[] | object | 一项配送摘要。 |
lock_up_shipping[].text | string | 配送摘要的展示文字。 |
卖家与商品评价19 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
seller | object | 商品附带的卖家摘要。 |
seller.rating_value | number | 商品返回的卖家数字评分。 |
seller.product_count | string | 卖家商品数量文本。 |
seller.follower_count | string | 卖家粉丝数量文本。 |
seller.seller_id | string | 商品关联的卖家标识。 |
seller.name | string | 卖家展示昵称。 |
seller.shop_link | string | 卖家返回的公开店铺链接。 |
seller.rating | string | 卖家评分的展示文字。 |
seller.avatar | object | 卖家头像图片。 |
seller.avatar.height | integer | 图片高度,单位为像素。 |
seller.avatar.width | integer | 图片宽度,单位为像素。 |
seller.avatar.url_list | array | 该图片资源返回的链接列表。 |
seller.avatar.url_list[] | string | 该图片资源的一个链接。 |
seller.avatar.uri | string | 图片引用标识。 |
review | object | 商品返回的评价摘要。 |
review.product_rating | integer | 该摘要返回的商品数字评分。 |
review.review_count | string | 商品评价数量文本。 |
review.product_rating_str | string | 商品评分的展示文字。 |
review.review_count_str | string | 商品评价数量的格式化文字。 |
店铺资料与评分43 个字段
data.product_data.page_config.components_map[].component_data.shop_info
商品关联的公开店铺资料。
| 字段 | 类型 | 说明 |
|---|---|---|
seller_id | string | 店铺对应的卖家标识。 |
sold_count | integer | 返回的店铺销量数字。 |
on_sell_product_count | integer | 店铺返回的在售商品数量。 |
review_count | integer | 店铺返回的评价数量。 |
global_seller_id | string | 店铺返回的跨地区卖家标识。 |
global_sold_count | string | 店铺跨地区销量文本。 |
followers_count | string | 店铺粉丝数量文本。 |
video_count | string | 店铺视频数量文本。 |
enable_follow | boolean | 店铺是否标记为可关注。 |
shop_name | string | 店铺的公开显示名称。 |
shop_rating | string | 店铺评分的展示文字。 |
shop_link | string | 公开店铺链接。 |
format_sold_count | string | 店铺销量的格式化文字。 |
region | string | 店铺返回的地区代码。 |
display_on_sell_product_count | string | 店铺在售商品数量的格式化文字。 |
format_global_sold_count | string | 跨地区销量的格式化文字。 |
format_followers_count | string | 店铺粉丝数量的格式化文字。 |
format_video_count | string | 店铺视频数量的格式化文字。 |
store_sub_score | array | 店铺分项评分。 |
store_sub_score[] | object | 一项店铺分项评分。 |
store_sub_score[].score | number | 店铺分项评分的数字值。 |
store_sub_score[].type | integer | 该店铺分项评分的类别代码。 |
store_sub_score[].score_percentage | string | 该分项评分返回的占比文本。 |
worst_rating | string | 店铺返回的评分下限文本。 |
best_rating | string | 店铺返回的评分上限文本。 |
creator_name | string | 店铺资料中展示的创作者名称。 |
desc | string | 公开的店铺描述文字。 |
shop_exp_scores | array | 店铺返回的体验评分。 |
shop_exp_scores[] | object | 一项店铺体验评分。 |
shop_exp_scores[].score | number | 体验评分的数字值。 |
shop_exp_scores[].shop_sub_score_type | integer | 该体验评分的类别代码。 |
shop_exp_scores[].score_percentage | string | 该分项评分返回的占比文本。 |
shop_exp_scores[].format_score | string | 体验评分的格式化文字。 |
shop_exp_scores[].score_description | string | 体验评分的展示说明。 |
shop_exp_scores[].experience_format_description | string | 体验评分的格式化说明。 |
shop_exp_scores[].score_level | integer | 体验评分返回的等级代码。 |
shop_exp_scores[].format_numeric_score | string | 体验数字评分的格式化文字。 |
shop_logo | object | 公开的店铺标志图片。 |
shop_logo.height | integer | 图片高度,单位为像素。 |
shop_logo.width | integer | 图片宽度,单位为像素。 |
shop_logo.url_list | array | 该图片资源返回的链接列表。 |
shop_logo.url_list[] | string | 该图片资源的一个链接。 |
shop_logo.uri | string | 图片引用标识。 |
类目与补充条目10 个字段
data.product_data.page_config.components_map[].component_data
| 字段 | 类型 | 说明 |
|---|---|---|
vouchers | array | 返回的商品优惠券,列表可以为空。 |
category_info | object | 商品返回的类目信息。 |
category_info.recommended_categories | array | 商品关联的推荐类目。 |
category_info.recommended_categories[] | object | 一个推荐类目。 |
category_info.recommended_categories[].category_id | string | 推荐类目标识。 |
category_info.recommended_categories[].category_name | string | 推荐类目的显示名称。 |
category_info.recommended_categories[].category_name_en | string | 推荐类目的英文名称。 |
reviews_info | object | 商品附带的补充评价信息,对象可以为空。 |
hot_reviews | array | 返回的商品热门评价,列表可以为空。 |
shop_performance | array | 该板块返回的店铺表现条目,列表可以为空。 |
商品合规与警示8 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
compliance | object | 商品展示的合规信息。 |
compliance.title | string | 合规信息标题。 |
compliance.contents | array | 商品展示的合规说明列表。 |
compliance.contents[] | string | 一条展示的合规说明。 |
legit_warnings | array | 商品返回的警示说明。 |
legit_warnings[] | object | 一条商品警示说明。 |
legit_warnings[].short_content | string | 商品警示的简短展示文字。 |
legit_warnings[].long_content | string | 商品警示的详细展示文字。 |
较早响应中的商品与变体47 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
product_model | object | 较早响应结构中的商品资料。 |
product_model.product_id | string | TikTok Shop 商品标识,以字符串返回。 |
product_model.seller_id | string | 商品关联的卖家标识。 |
product_model.sold_count | string | 商品销量,以文本返回。 |
product_model.name | string | 嵌套商品资料中的商品名称。 |
product_model.description | string | 嵌套商品资料中的商品描述文字。 |
product_model.images | array | 嵌套商品资料中的商品图片。 |
product_model.images[] | object | 一张商品展示图片。 |
product_model.images[].height | integer | 图片高度,单位为像素。 |
product_model.images[].width | integer | 图片宽度,单位为像素。 |
product_model.images[].uri | string | 图片引用标识。 |
product_model.images[].url_list | array | 该图片资源返回的链接列表。 |
product_model.images[].url_list[] | string | 该图片资源的一个链接。 |
product_model.skus | array | 嵌套商品资料中的 SKU 记录。 |
product_model.skus[] | object | 嵌套商品资料中的一条 SKU。 |
product_model.skus[].sku_id | string | TikTok Shop SKU 标识,以字符串返回。 |
product_model.skus[].sku_name | string | SKU 展示名称。 |
product_model.skus[].sku_status | integer | 该 SKU 返回的状态代码。 |
product_model.skus[].is_pre_order | boolean | 该 SKU 是否标记为预售。 |
product_model.skus[].pre_order_ship_day | integer | 返回的预售发货等待天数。 |
product_model.skus[].property_pairs | array | 该 SKU 的变体属性与值列表。 |
product_model.skus[].property_pairs[] | object | 该 SKU 的一组变体属性和值。 |
product_model.skus[].property_pairs[].sku_property_id | string | 商品变体属性标识。 |
product_model.skus[].property_pairs[].sku_property_value_id | string | 变体值标识。 |
product_model.skus[].property_pairs[].sku_property_name | string | 变体属性的显示名称。 |
product_model.skus[].property_pairs[].sku_property_value_name | string | 变体值的显示名称。 |
product_model.skus[].sku_quantity | object | 该 SKU 返回的可售库存信息。 |
product_model.skus[].sku_quantity.available_quantity | integer | 该 SKU 返回的可售数量。 |
product_model.skus[].sku_stock_status | integer | 该 SKU 返回的库存状态代码。 |
product_model.sale_properties | array | 嵌套商品资料中的销售变体属性。 |
product_model.sale_properties[] | object | 嵌套商品资料中的一项属性。 |
product_model.sale_properties[].property_id | string | 嵌套商品资料中的属性标识。 |
product_model.sale_properties[].has_image | boolean | 该嵌套属性是否有关联图片。 |
product_model.sale_properties[].property_name | string | 该嵌套属性的显示名称。 |
product_model.sale_properties[].property_values | array | 该嵌套属性返回的属性值。 |
product_model.sale_properties[].property_values[] | object | 该嵌套属性返回的一个属性值。 |
product_model.sale_properties[].property_values[].property_value_id | string | 嵌套属性值的标识。 |
product_model.sale_properties[].property_values[].property_value_name | string | 嵌套属性值的显示名称。 |
product_model.product_properties | array | 嵌套商品资料中的商品属性。 |
product_model.product_properties[] | object | 嵌套商品资料中的一项属性。 |
product_model.product_properties[].property_id | string | 嵌套商品资料中的属性标识。 |
product_model.product_properties[].has_image | boolean | 该嵌套属性是否有关联图片。 |
product_model.product_properties[].property_name | string | 该嵌套属性的显示名称。 |
product_model.product_properties[].property_values | array | 该嵌套属性返回的属性值。 |
product_model.product_properties[].property_values[] | object | 该嵌套属性返回的一个属性值。 |
product_model.product_properties[].property_values[].property_value_id | string | 嵌套属性值的标识。 |
product_model.product_properties[].property_values[].property_value_name | string | 嵌套属性值的显示名称。 |
较早响应中的价格、卖家与状态43 个字段
data.product_data.page_config.components_map[].component_data.product_info
| 字段 | 类型 | 说明 |
|---|---|---|
promotion_model | object | 较早响应结构中的价格和配送促销信息。 |
promotion_model.promotion_product_price | object | 嵌套促销资料中的商品价格详情。 |
promotion_model.promotion_product_price.min_price | object | 返回的最低价格记录。 |
promotion_model.promotion_product_price.min_price.sku_id | string | 该价格关联的 SKU 标识。 |
promotion_model.promotion_product_price.min_price.currency_name | string | SKU 价格返回的货币代码。 |
promotion_model.promotion_product_price.min_price.currency_symbol | string | SKU 价格的货币展示符号。 |
promotion_model.promotion_product_price.min_price.sale_price_decimal | string | SKU 销售价,以十进制字符串返回。 |
promotion_model.promotion_product_price.min_price.sale_price_format | string | SKU 的格式化销售价格文本。 |
promotion_model.promotion_product_price.min_price.single_product_price_decimal | string | 商品单件价,以十进制字符串返回。 |
promotion_model.promotion_product_price.min_price.single_product_price_format | string | 商品单件价的格式化文字。 |
promotion_model.promotion_product_price.min_price.raw_origin_price_decimal | string | 原价,以十进制字符串返回。 |
promotion_model.promotion_product_price.min_price.raw_origin_price_format | string | 原价的格式化文字。 |
promotion_model.promotion_product_price.skus_price | object | 以 SKU 标识作为键的价格记录映射。 |
promotion_model.promotion_product_price.feature | array | 该价格结构返回的属性值列表。 |
promotion_model.promotion_product_price.feature[] | object | 与该价格结构关联的一项属性值。 |
promotion_model.promotion_product_price.feature[].property_name | string | 价格关联属性的显示名称。 |
promotion_model.promotion_product_price.feature[].property_value | string | 价格关联属性的显示值。 |
promotion_model.promotion_logistic_list | array | 嵌套促销资料返回的配送选项。 |
promotion_model.promotion_logistic_list[] | object | 促销资料中的一个配送选项。 |
promotion_model.promotion_logistic_list[].deliveryOption | integer | 返回的配送选项代码。 |
promotion_model.promotion_logistic_list[].freeShipping | boolean | 该配送选项是否标记为免运费。 |
promotion_model.promotion_logistic_list[].deliveryName | string | 配送选项的显示名称。 |
promotion_model.promotion_logistic_list[].shippingFee | object | 返回的运费信息。 |
promotion_model.promotion_logistic_list[].shippingFee.origin_price | string | 原始运费文本。 |
promotion_model.promotion_logistic_list[].shippingFee.real_price | string | 返回的运费文本。 |
promotion_model.promotion_logistic_list[].shippingFee.currency | string | 运费的货币代码。 |
promotion_model.promotion_logistic_list[].shippingFee.real_price_desc | string | 用于说明运费的展示文字。 |
review_model | object | 较早响应结构中的评价摘要。 |
review_model.product_overall_score | integer | 返回的商品综合评价分数。 |
review_model.product_review_count | string | 商品评价数量文本。 |
seller_model | object | 较早响应结构中的卖家资料。 |
seller_model.shop_name | string | 店铺的公开显示名称。 |
seller_model.shop_logo | object | 公开的店铺标志图片。 |
seller_model.shop_logo.height | integer | 图片高度,单位为像素。 |
seller_model.shop_logo.width | integer | 图片宽度,单位为像素。 |
seller_model.shop_logo.uri | string | 图片引用标识。 |
seller_model.shop_logo.url_list | array | 该图片资源返回的链接列表。 |
seller_model.shop_logo.url_list[] | string | 该图片资源的一个链接。 |
availability_model | object | 较早响应结构中的可售状态信息。 |
availability_model.reason | integer | 返回的可售状态原因代码。 |
base_resp | object | 较早响应结构中的状态信息。 |
base_resp.StatusCode | integer | 嵌套商品响应的状态码。 |
base_resp.StatusMessage | string | 嵌套商品响应的状态说明。 |