- id
- 该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
- url
- 该记录在原平台上的可访问链接。
- title
- 标题。平台无标题概念时(如纯文本帖)为 null。
- price
- 价格数值,不含货币符号;币种见 currency。
- currency
- 价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
- sold_count
- 销量。
- rating
- 评分。分制随平台而异,同一行的
rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。 - rating_scale
- 上一列
rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。 - location
- 地理位置描述,原文透传,格式随平台而异。
- shop_name
- 店铺名。
- image_url
- 图片链接。多图能力可能返回 image_urls 数组。
- stock
- 库存。
- shop_id
- 店铺 ID(search 行与详情、店铺商品行同一口径)。
- sold_text
- 销量原文(search,如「10万+」);带「+」或「万」的是平台展示的约数,不是精确销量。
- original_price
- 原价。
- coupon_price
- 券后价(有优惠券时低于 price,无券时缺省)。
- discount_type
- 折扣/活动类型原文(如「特价秒杀」)。
- is_tmall
- 是否为天猫店(区别于淘宝 C 店,开店门槛和保障不同)。
- brand
- 品牌。
- category_id
- 类目 ID。
- seller_credit_level
- 卖家信用等级(数字,越大越高)。
- seller_positive_rate
- 卖家好评率(search,百分数,100 即 100%)。
- shop_score_description
- 店铺动态评分·描述相符(5 分制)。
- shop_score_service
- 店铺动态评分·服务态度(5 分制)。
- shop_score_delivery
- 店铺动态评分·物流服务(5 分制)。
- subtitle
- 商品副标题(search,卖点短句)。
- search_rank
- 在本次搜索结果中的位置(search,从 1 起)。
- free_shipping
- 是否包邮。
- selling_points
- 商品卖点标签列表。
- review_tags
- 评价标签列表,每项 tag(标签文字)与 count(提到次数,可能缺省)。
- platform
- 数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
- shipping_fee
- 运费。
- ems_fee
- EMS 运费。
- express_fee
- 快递运费。
- skus
- 规格列表(全量,有多少给多少)。每条可含 id/name/price/original_price/coupon_price/stock/props_ids/image_url。
- sku_count
- SKU 数量。
- spec_values
- 商品规格值全表(含未在售组合),id 为规格值标识、text 为规格文本。
- props_images
- 规格值配图,id 与 spec_values/props_ids 同一标识,image_url 为该规格的展示图。
- attributes
- 商品属性列表(品牌、型号、产地等 {name, value} 行)。
- main_image_url
- 主图(首图)。
- description_images
- 详情页描述区长图列表(按页面出现顺序)。
- description_html
- 详情页描述区原始 HTML(以图片标签为主)。
- video_url
- 主图视频直链(无视频时缺省)。
- price_usd
- 美元参考价(按返回数据中的折算值)。
- total_price
- 总价(以返回数据为准,常缺省)。
- suggestive_price
- 建议零售价(常缺省)。
- has_discount
- 是否有折扣。
- is_promotion
- 是否促销中。
- promo_type
- 促销类型。
- is_virtual
- 是否虚拟商品。
- brand_id
- 品牌 ID。
- root_category_id
- 根类目 ID。
- category_path
- 类目路径(面包屑)。
- weight
- 商品重量(以返回数据为准,常为 0 或缺省)。
- size
- 商品尺寸(常缺省)。
- favorite_count
- 收藏数。
- fans_count
- 粉丝数(以返回数据为准,常缺省)。
- min_order_quantity
- 最小起订量。
- shipping_to
- 配送范围说明(常缺省)。
- listed_at
- 上架时间(ISO 8601,数据缺省时字段不出现)。
- modified_at
- 最近修改时间(ISO 8601,数据缺省时字段不出现)。
- delist_at
- 下架时间(ISO 8601,数据缺省时字段不出现)。
- images
- 图片链接列表:product_detail 是商品图,reviews 是买家晒图(没晒图时没有这个字段)。
- category_name
- 叶子类目名(product_detail)。
- description
- 简介或描述,通常比 text 短。
- keywords
- 商品页关键词(product_detail)。
- promotion_price
- 促销价(product_detail,常缺省)。
- discount_price
- 折后价(product_detail,常缺省)。
- price_note
- 价格说明原文(product_detail)。
- has_price_range
- 是否区间价(多规格价格不同,product_detail)。
- payment_methods
- 支持的支付方式(product_detail)。
- seller_id
- 卖家 ID。
- seller_type
- 卖家类型代码(product_detail)。
- seller_type_label
- 卖家类型名称(product_detail,如天猫、企业店)。
- shop_logo_url
- 店铺 Logo 链接(product_detail)。
- shop_url
- 店铺链接(product_detail)。
- shop_item_count
- 店铺在售商品数(product_detail)。
- shop_new_item_count
- 店铺新品数(product_detail)。
- shop_opened_at
- 开店时间原文(product_detail)。
- review_count
- 评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
- positive_rate
- 商品好评率(product_detail,百分数,常缺省)。
- seven_day_return
- 是否支持七天无理由退货(product_detail)。
- sold_count_30d
- 近 30 天销量(店铺在售商品行)。
- comment_count
- 评论数(店铺在售商品行)。
- text
- 正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
- posted_at
- 发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
- sku
- 规格。
- buy_count
- 购买人数。
- useful_count
- 评价被标有用次数。
- author_name
- 作者昵称(显示名)。
- author_avatar_url
- 评价人头像链接(reviews)。
- review_append
- 买家追评正文(有多条时按时间顺序换行拼接;没有追评时字段不出现)。
- seller_reply
- 卖家对该评价的回复。
- answer_count
- 「问大家」回答数。
- answers
- 问大家的回答内容。