商品列表

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>
 
 
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<ImageUrl>
参见返回示例
商品细节图
product_item_detail
list<ProductItemGroup>
参见返回示例
 
商品详情
sale_tags
list<string>
参见返回示例
权益标签
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%2F6KLIwOtHig%2FLQm5dsw%3D&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”: “操作成功”

}

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部