商品列表

接口

POST app/douYinGroup/product/list

请求参数

字段	名称	类型	是否必须
cursor	游标。注意：首次查询时传空，第二次查询传第一次查询返回值中的cursor	int	否
count	每页数量最大值为20	int	是
sort_by	1: 距离 2: 销量 3: 价格 4: 佣金比率	int
order_by	1升2降默认1	int
city_code	`当传递了经纬度时，会依据经纬度查询所在城市。其它情况，请必需传递 city_code，依据场景尽量传递到城市级别即可，例如：天津为120000 抖音城市码//https://bytedance .larkoffice.com/sheets/ Vek1si8jghvHIxtIoiRcdZFCn3f`	sting
longitude	经度。WGS84坐标	float
latitude	纬度。WGS84坐标，	float
distance_max	距离限制。示例：3000，表示经纬度为中心3000米内商品
category_id	`类别信息。参见 //http s://bytedance.larkoffice.com/she ets/CIqdsr8mqh6Y7MtX8x6cJ9No nxe`	int
keyword	关键字	string

返回结果

信息

	参数字段	参数类型	示例值	参数描述
data	cursor	int64		下一页请求的cursor
has_more	bool		是否还有数据
product_list	list
ProductList	id	int64	1752089523094557	商品id 注意：商品id请使用 int64 保存
name	string	`[春季专享]Q10卸妆+芦荟原萃液护理`	商品名称
type	int64	1	商品类型 1：团购套餐 2：虚拟商品 3：预售券 4：民宿 5：门票 6：外卖 7：旅行跟拍 8：一日游 9：售卖的房子 10：懂车帝 11：代金券 12：预售 v2 13：预定 14：配送商品 15：次卡 16：外卖（目前商品专项服务商用） 17：外卖聚合品（目前商品专项服务商用，只用于 MSPU） 18：通兑权益 19：外卖预售券 20：线索类 21：附属商品 22：预约商品多 sku 23：即使零售多 sku 24：接待单元
product_img	ImageUrl	参见返回示例	商品图片
product_detail_img	list	参见返回示例	商品细节图
product_item_detail	list	参见返回示例	商品详情
sale_tags	list	参见返回示例	权益标签
price	int64	1590	商品售价。注意：因为用户在抖音端有券的情况下，该价格可能比到手价要高
origin_price	int64	1900	商品原价（划线价）
marketing_info	MarketingInfo	参见返回示例	营销信息，目前仅包含秒杀信息和优惠券信息
blurred_sold_count	string	8000+	商品销量
sell_out	bool	false	是否售罄
first_category	ProductCategoryInfo	参见返回示例	一级类目
second_category	ProductCategoryInfo	参见返回示例	二级类目
third_category	ProductCategoryInfo	参见返回示例	三级类目
sold_time_begin	int64		商品售卖开始时间
sold_time_end	int64		商品售卖结束时间
new_user_lowest_price	int64	1	新人最低价，单位：分。如果为null，表示没有新人最低价
nearest_poi	PoiInfo		当前商品离用户最近的适用POI（如果用户没传经纬度，默认北京王府井）
poi_count	int64		适用门店数量
dy_h5_url	string		抖音h5商品详情页链接
commission_rate	int64	1000	佣金比率. 如果实际佣金率是12.34%,该字段会返回1234
commission_amount	int64	799	预估佣金金额,单位:分。>=实际佣金金额,因为折扣、退款等原因

{
  "code": 0,
  "data": {
    "cursor": 1623,
    "has_more": true,
    "product_list": [
      {
        "id": 1780690631695412,
        "name": "茶多娱满杯西柚",
        "type": 1,
        "product_img": {
          "url_list": [
            "https://p26-sign.douyinpic.com/tos-cn-i-hf2m9xxmck/8ac69481216b48bc95edd94b5f6706c6~tplv-shrink:750:0.image?x-expires=1814767200&x-signature=qv5w0MLI/6KLIwOtHig/LQm5dsw=&from=3158402634"
          ]
        },
        "sale_tags": [
          "免预约",
          "随时退·过期退"
        ],
        "price": 900,
        "origin_price": 1000,
        "marketing_info": {},
        "blurred_sold_count": "1",
        "sell_out": false,
        "first_category": {
          "id": 1000000,
          "name": "美食"
        },
        "second_category": {
          "id": 1015000,
          "name": "饮品"
        },
        "third_category": {
          "id": 1015003,
          "name": "茶饮果汁"
        },
        "sold_time_begin": 1698204271,
        "sold_time_end": 1729871999,
        "nearest_poi": {
          "name": "茶多娱",
          "poi_id": 7255983314014570000
        },
        "poi_count": 1,
        "dy_h5_url": "https://life.scsjsd.com/falcon/poi_mwa/trade_detail?hide_nav_bar=1&trans_status_bar=1&should_full_screen=1&&enter_from=poi&activity_id=1780690631695412&biz_code=food",
        "commission_rate": 500,
        "commission_amount": 40,
        "product_item_detail": [
          {
            "title": "果茶",
            "item_list": [
              {
                "name": "满杯西柚",
                "price": 1000,
                "count": 1,
                "unit": "份"
              }
            ]
          }
        ],
        "product_detail_img": [
          {
            "url_list": [
              ""
            ]
          }
        ]
      }
    ]
  },
  "msg": "操作成功"
}