Product(商品)对象

2 个平台的 5 个接口都返回 Product(商品)对象,13 个字段名完全一样,给一个平台写的代码不用改就能读其他平台。每次调用 $0.0020 到 $0.0200。它是预览结构,之后可能调整。

预览对象 · 更新于 2026-10-17在 ChatGPT 里打开在 Claude 里打开

商品(Product)是平台商城里在卖的一件东西:标题、现价 price 和原价 original_price 及其货币 currency、商品图、买家评分 rating(满分 5)和已售件数。现在来自 TikTok Shop 美国站和小红书商城(人民币)。

shop.id 和 shop.name 是卖它的店铺;在 TikTok Shop 上,用店铺编号还能列出这家店在售的其他商品。id 可以原样传给商品详情和商品评价接口,评价按“评价”对象返回。

字段

平台给不了的字段不会出现在这条数据里,而是写在 meta.unavailable 里。不会用猜的数或 0 顶上。

id 文本

编号,可原样传给取商品详情和取商品评价的接口

url 链接

能直接打开的链接

title 文本

商品标题

description 文本 standard

商品详情里的文字说明

price 金额

现价;有多个规格时是最低的那一档

original_price 金额 standard

打折前的价格;没有折扣时为 null

currency 文本

价格的货币,ISO 4217 代码

images 链接列表 standard

商品图片地址

rating 数字

买家评分,满分 5

metrics 对象

商品的数字

metrics.sold 整数

已售件数

metrics.reviews 整数

评价数

shop 对象

卖这件商品的店铺

shop.id 文本

店铺编号

shop.name 文本

店铺名

每个数取的是平台上的哪个数

同一个字段名,在不同平台上对应的动作不完全一样。这张表写明这个字段取的是平台自己的哪个数。

字段在那里是什么平台
title搜索结果卡片上的标题,和商品页上的标题字面上可能不同小红书
images搜索结果卡片上的那一张图;全部图片用商品详情取小红书
metrics.sold商品页上显示的已售件数小红书
搜索结果卡片上显示的已售件数小红书

哪些平台给不了哪些字段

一个平台的所有接口都给不了某个字段时,它才列在那个字段后面。

字段给不了的平台
url小红书
同一个平台上,可能一个接口给不了、另一个接口能给:每个接口的页面列着它给不了的字段,每次返回也都写在 meta.unavailable 里。

返回 Product(商品)的接口

每个平台旁边的数字,是它有几个接口返回这种对象。

接口路径价格
TikTok Shop 商品详情GET/v1/tiktok/shop/products/get$0.0020
TikTok Shop 商品搜索GET/v1/tiktok/shop/products/search$0.0020
TikTok Shop 店铺商品GET/v1/tiktok/shop/sellers/products/list$0.0020
小红书商品详情GET/v1/xiaohongshu/shop/products/get$0.0200
小红书商品搜索GET/v1/xiaohongshu/shop/products/search$0.0200

示例

tiktok.shop.products.get 返回的一条,录制于 2026-10-12 21:46 UTC。名字、正文和编号是示例,链接也是;数字是原样。

Product(商品) · tiktok.shop.products.get
{
  "id": "1716954397711561377",
  "url": "https://shop.tiktok.com/view/product/1716954397711561377",
  "title": "I tried weekend hiking for 30 days. Here is what happened",
  "description": "My honest take on weekend hiking, a month in.",
  "images": [
    "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/c864758cf8a90105a3d1~c5_720x720.jpeg",
    "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/2061b170200b03e40ffe~c5_720x720.jpeg",
    // … 另有 1 条
  ],
  "rating": 4.1,
  "metrics": { "sold": 233, "reviews": 18 },
  "shop": { "id": "1748001744684903334", "name": "Lumen Outdoor Store" }
}

完整的返回在这个接口的页面上 →

相关

其他对象