Listing
commerce.listingUnified即将推出某个平台上的一个商品页：价格、排名、买家评价和销量，以及背后的店铺和公司。
11 个站点计划 5 个调用53 个字段主键 站点 + 商品页 IDAmazon 和 TikTok Shop 最先上线
Listing 在哪里
Product所有平台上的同一件商品
关联，附置信度
Listing一个平台上的一个商品页包含
Variant 和 Offer销售方
Shop该平台上的一个卖家账号
经营方
Organization背后的公司，也是品牌方或供应商
- 以
Brand品牌销售 - 归在
Category类目下 - 在
Keyword搜索词下有排名 - 出现在
Creator发布的Video或LiveStream里 - 可能碰到
IPRight - 店铺被
Case列为被告
计划提供 5 个调用即将推出
调用来自电商 API 设计 0.1.0-draft，路径按 REST 写法。每个调用在所列平台上用同一套结构返回这个实体，目前都还没有部署。
- GET
/读取一个商品页，连同来源返回的 Variant 和 OfferTikTok Shop · Amazon已设计v1/ e-commerce/ listings/ {listingId} - GET
/在一个平台上搜索商品页，各平台的筛选条件不同TikTok Shop · Amazon已设计v1/ e-commerce/ listings/ search - GET
/用商品图片找候选商品页，不默认认定为同款TikTok Shop · Amazon已设计v1/ e-commerce/ listings/ search-by-image - GET
/按类目和日期查询畅销排行TikTok Shop · Amazon已设计v1/ e-commerce/ listings/ rankings - GET
/推广某个商品页的视频TikTok Shop已设计v1/ e-commerce/ tiktok-shop/ listings/ {listingId}/ videos
字段
按类型列出主要字段。可观测字段沿用契约的字段键，完整契约见下文。
可观测
有未过期的快照就用快照，没有就实时采集，再不行换下一家来源计费：成功返回才收费- titlestring成功返回才收费
- imagesobject[]成功返回才收费
- related.categoriesuuid[]已确认的最细一级类目，保留平台自己的类目体系成功返回才收费
- rating.scoredecimal0 可能表示还没有评分，不一定是零分成功返回才收费
- review.countinteger只计文字评论；仅打星的评分计入 rating.count成功返回才收费
- lifecycle.launch_datedate来源报告的上架日期，不是 AIsa 首次采集的日期成功返回才收费
- relation.shop_iduuid发布这个商品页的店铺。在 Amazon 上，不把 Featured Offer 的卖家当作所属店铺成功返回才收费
- related.offersuuid[]价格、库存和配送都在各个 Offer 上成功返回才收费
- metrics.sales_countdecimal累计值或区间值，按来源的口径；不同来源的数字从不相加成功返回才收费
- metrics.video_countinteger统计周期内推广这个商品的视频数，不是播放量成功返回才收费
估算
默认问一家估算方，最多三家并排对比计费：按查询计费可验证
逐家来源查询，直到有一个答案通过验证计费：验证通过才收费列表与风险
多家来源合并；只要有一家命中就提示计费：按行计费字段契约中的 45 个字段设计 0.1.0-draft · listing-contract-v3.2
设计定义的字段键和取值写法。只返回来源实际取得的字段。
身份5
AIsa ID、平台、站点和平台自己的 IDentity.iduuidentity.kindstringentity.platformstringentity.scopestringentity.native_idstring
页面11
标题、链接、图片和页面上展示的内容titlestringurlurlimagesobject[]image.cover_urlurldescription.blocksobject[]attributes.listobject[]status.availabilitystringlifecycle.launch_datedatebadgesstring[]affiliate.commission_ratedecimaloption_groupsobject[]
评分5
评分数和评论数分开统计rating.scoredecimalrating.countintegerrating.distributionobject[]review.summarystringreview.countinteger
指标17
销量、GMV 和互动数据，各自按来源的统计周期metrics.sales_countdecimalmetrics.gmvdecimalmetrics.gmv_totaldecimalmetrics.creator_countintegermetrics.video_countintegermetrics.live_countintegermetrics.video_view_countintegermetrics.creator_order_ratedecimalmetrics.gmv_trendobject
再显示 8 个字段收起
metrics.video_average_views_reporteddecimalmetrics.video_gpm_reporteddecimalmetrics.video_conversion_reporteddecimalmetrics.live_average_viewers_reporteddecimalmetrics.ad_gmv_reporteddecimalmetrics.ad_cost_reporteddecimalmetrics.seller_creator_sales_count_30ddecimalmetrics.seller_creator_gmv_30ddecimal
关联7
指向其他实体的 AIsa IDrelation.shop_iduuidrelated.variantsuuid[]related.variant_listingsuuid[]related.parent_listingsuuid[]related.child_listingsuuid[]related.offersuuid[]related.categoriesuuid[]
decimal 和 integer 以字符串返回，保留精度。以 _reported 结尾的字段是来源自己报告的数字，口径未确认；_raw 保留来源的原始编码。uuid 字段指向其他 AIsa 实体。
按站点
有五家以上估算方的站点，销量并排返回，并最先完成校准。其他站点先从两家对比开始，或者只有一家来源并如实标注。
| 站点 | 商品页主键 | 实时采集 | 估算方 | 销量估算 | 状态 |
|---|---|---|---|---|---|
| Amazon | amazon:US · ASIN | 4 | 6 | 并排返回，已校准 | 已上线 |
| TikTok Shop | tiktok-shop:US · product_id | 1 | 5 | 并排返回，已校准 | 已上线 |
| Temu | temu:US · goods_id | — | 3 | 并排返回 | 即将推出 |
| Walmart | walmart:US · item ID | 1 | 2 | 两家对比 | 即将推出 |
| Shopee | shopee:SG · item_id | 1 | 2 | 两家对比 | 即将推出 |
| Ozon | ozon:RU · SKU | — | 2 | 两家对比 | 即将推出 |
| Mercado Libre | mercadolibre:BR · item ID | — | 2 | 两家对比 | 即将推出 |
| Etsy | etsy:US · listing_id | 1 | 1 | 单一来源，已标注 | 即将推出 |
| Shopify | shopify:{store} · product ID | — | 1 | 单一来源，已标注 | 即将推出 |
| eBay | ebay:US · item ID | 1 | — | 仅实时采集 | 即将推出 |
| 1688 | 1688:CN · offerId | — | 2 | 供应商列表合并 | 即将推出 |
数量来自第一期供应商名单。每个站点上线后，这里会显示各字段的填充率。