Shop
commerce.shopUnified即将推出某个平台上的一个卖家账号。
主键 站点 + 卖家 ID计划 4 个调用目前有 2 个 Direct 接口
计划提供 4 个调用即将推出
调用来自电商 API 设计 0.1.0-draft，路径按 REST 写法。每个调用在所列平台上用同一套结构返回这个实体，目前都还没有部署。
- GET
/读取一家店铺的公开资料和指标TikTok Shop · Amazon已设计v1/ e-commerce/ shops/ {shopId} - GET
/一家店铺的商品页列表TikTok Shop已设计v1/ e-commerce/ shops/ {shopId}/ listings - GET
/按类目和是否跨境筛选店铺TikTok Shop已设计v1/ e-commerce/ tiktok-shop/ shops/ search - GET
/按日、周或月的店铺排行TikTok Shop已设计v1/ e-commerce/ tiktok-shop/ shops/ rankings
字段契约中的 85 个字段设计 0.1.0-draft · listing-contract-v3.2
设计定义的字段键和取值写法。只返回来源实际取得的字段。
身份5
AIsa ID、平台、站点和平台自己的 IDentity.iduuidentity.kindstringentity.platformstringentity.scopestringshop.seller_idstring
资料12
平台公开的资料shop.namestringshop.urlurlshop.location_rawstringshop.type_rawstringshop.identity_label_rawstringshop.business_infostring[]shop.business_type_rawstringshop.managed_type_rawjsonshop.primary_sales_channel_rawstringshop.sales_trend_rawstringshop.rating_count_reporteddecimalshop.is_cross_borderboolean
页面1
标题、链接、图片和页面上展示的内容image.cover_urlurl
价格2
数字字符串，币种见 contextprice.display_mindecimalprice.display_maxdecimal
评分1
评分数和评论数分开统计rating.scoredecimal
指标59
销量、GMV 和互动数据，各自按来源的统计周期metrics.sales_countdecimalmetrics.gmvdecimalmetrics.follower_count_totaldecimalmetrics.gmv_totaldecimalmetrics.sales_count_1ddecimalmetrics.gmv_1ddecimalmetrics.sales_count_7ddecimalmetrics.gmv_7ddecimalmetrics.sales_count_30ddecimal
再显示 50 个字段收起
metrics.gmv_30ddecimalmetrics.sales_count_90ddecimalmetrics.gmv_90ddecimalmetrics.gmv_reporteddecimalmetrics.positive_feedback_rate_reporteddecimalmetrics.response_rate_reporteddecimalmetrics.delivery_rate_reporteddecimalmetrics.product_count_totaldecimalmetrics.product_count_currentdecimalmetrics.product_count_on_saledecimalmetrics.creator_count_totaldecimalmetrics.video_count_totaldecimalmetrics.live_count_totaldecimalmetrics.creator_count_reporteddecimalmetrics.video_count_reporteddecimalmetrics.live_count_reporteddecimalmetrics.live_creator_count_totaldecimalmetrics.video_creator_count_totaldecimalmetrics.shop_creator_count_totaldecimalmetrics.self_promotion_gmv_7ddecimalmetrics.affiliate_gmv_7ddecimalmetrics.shopping_mall_gmv_7ddecimalmetrics.gmv_growth_rate_7ddecimalmetrics.self_promotion_gmv_30ddecimalmetrics.affiliate_gmv_30ddecimalmetrics.shopping_mall_gmv_30ddecimalmetrics.gmv_growth_rate_30ddecimalmetrics.self_promotion_gmv_reporteddecimalmetrics.affiliate_gmv_reporteddecimalmetrics.shopping_mall_gmv_reporteddecimalmetrics.gmv_growth_rate_reporteddecimalmetrics.video_sales_count_30ddecimalmetrics.video_gmv_30ddecimalmetrics.live_sales_count_30ddecimalmetrics.live_gmv_30ddecimalmetrics.product_card_sales_count_30ddecimalmetrics.product_card_gmv_30ddecimalmetrics.personal_creator_sales_count_30ddecimalmetrics.personal_creator_gmv_30ddecimalmetrics.seller_creator_sales_count_30ddecimalmetrics.seller_creator_gmv_30ddecimalmetrics.interval_related_creator_count_reporteddecimalmetrics.interval_total_related_creator_count_reporteddecimalmetrics.interval_total_related_video_creator_count_reporteddecimalmetrics.interval_total_related_shop_creator_count_reporteddecimalmetrics.interval_total_related_videos_count_reporteddecimalmetrics.interval_sold_count_reporteddecimalmetrics.interval_total_sold_count_reporteddecimalmetrics.interval_sold_count_growth_rate_reporteddecimalmetrics.interval_gmv_pop_growth_rate_reporteddecimal
关联4
指向其他实体的 AIsa IDrelated.categoriesuuid[]related.listingsuuid[]related.creatorsuuid[]related.product_categoriesuuid[]
上下文1
所有金额字段使用的币种context.currencystring
decimal 和 integer 以字符串返回，保留精度。以 _reported 结尾的字段是来源自己报告的数字，口径未确认；_raw 保留来源的原始编码。uuid 字段指向其他 AIsa 实体。
AIsa 在契约之外补充的字段草稿 · 不在设计中
来自其他来源的估算值、核验结果和风险列表，计划在同一个响应里返回。
可验证
逐家来源查询，直到有一个答案通过验证organizationOrganization观测值按统一社会信用代码或 D-U-N-S 匹配
列表与风险
多家来源合并去重；风险类只要有一家命中就提示tro_casesCase[]观测值把这家店铺列为被告的附表 A 案件
现在就能通过 Direct 调用已上线
已经能返回这类对象的供应商接口，字段保持供应商的原始格式。代码中指定供应商，更换供应商需要改代码。
1 个 API 的 2 个接口 · $0.001 起
Shop 的相关实体
每个关联都是可以在同一次调用里一起要的字段。
Listing
站点 + 商品页 ID某个平台上的一个商品页：价格、排名、评论和销量。
Offer
商品页 + 店铺某家店铺在一个商品页上的价格、库存和配送。
Creator
平台 + 达人 ID通过联盟链接带货的达人。
Organization
统一社会信用代码 · D-U-N-S · 域名店铺、工厂、品牌和专利背后的公司。卖家、供应商、权利人都是它扮演的角色。
Case
法院 + 案号知识产权诉讼，包括附表 A 案件和冻结店铺资金的 TRO。