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 |
当传递了经纬度时,会依据经纬度查询 |
sting | |
longitude |
经度。WGS84坐标 |
float | |
latitude |
纬度。WGS84坐标, |
float | |
distance_max |
距离限制。示例:3000,表示经纬 |
||
category_id |
类别信息。参见 //http |
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”: “操作成功”
}