分销商品列表查询
| 参数名称 | 参数类型 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| apikey | string | 是 | 接口秘钥，请登录个人中心获取 | |
| count | Number | 否 | 20 | 本次查询数量，需⼩于20。 （response可能因为过滤等原因，返回数 量⼩于count） |
| city_code | String | 否 | 中国城市city_code（l2级），⽤于圈选该 城市⻔店的商品。如果不传，默认北京 | |
| longitude | String | 否 | ⽤⼾位置的经度(WGS84坐标)。如果不 传，默认北京王府井 | |
| latitude | String | 否 | ⽤⼾位置的纬度(WGS84坐标)。如果不 传，默认北京王府井 | |
| key_word | String | 否 | 查询关键字(⽀持商品名查询) | |
| sort_by | Number | 否 | 排序类型，可选： 1-距离(根据city_code城市下适⽤⻔店的距 离排序), 2-销量 3-优惠前价格 (按优惠前价格排序，因此优 惠后价格更⾼的商品可能排在前⾯) 4-佣⾦率 | |
| order_by | Number | 否 | 排序顺序： 1-升序 2-降序 | |
| category_id | String | 否 | 筛选项：商品类⽬-任意级别 | |
| distance_max | String | 否 | 最⼤距离，单位m | |
| cursor | String | 否 | 查询光标起点，默认0 |
| 名称 | 类型 | 示例值 | 说明 |
|---|---|---|---|
| curosr | int | 下次查询⽤的cursor | |
| has_more | bool | 是否还有更多商品 | |
| id | String | 商品id | |
| name | String | 商品名称 | |
| type | int | 1-团购 2-虚拟商品 3-⽼预售 4-⺠宿 5-⻔票 6-外卖 7-旅拍 8-⼀⽇游 9-售卖的房⼦ 10-懂⻋帝 11-代⾦券 12-新预售 13-⽇历票/⽇历房 14-⾃营配送 15-次卡 16/17-配送 18-通兑品 19-先买后约 20-线索类 21-附属商品 | |
| status | int | 商品状态： 1-online | |
| need_invoice | bool | 是否需要发票（商家给出分佣佣⾦后 需要发票） | |
| price_info | object | 价格信息，是⼀个结构体，形如： { price: xxx, origin_price: xxx, } | |
| price | int | 叠加优惠⼯具后的到⼿价（可能⽐⽤ ⼾在抖⾳中看到的价格要⾼，因为抖 ⾳中会对每个⽤⼾再单独发券） | |
| origin_price | int | 原价 | |
| sold_info | object | 商品销量信息，是⼀个结构体，形 如：{ blurred_sold_count: xxx, } | |
| blurred_sold_count | string | 商品模糊销量，如“10万+” | |
| product_img | object | 商品图⽚，是⼀个结构体，形如： { url: [xxx, ] } | |
| url | list |
商品图⽚url，数组中含多个url，指 向的图⽚相同，任取⼀个即可 | |
| dy_detail_page | object | 抖⾳详情⻚信息，是⼀个结构体，形 如：{ h5_url: xxx, } | |
| h5_url | String | 抖⾳h5商品详情⻚链接 | |
| nearest_poi | object | 当前商品离⽤⼾最近的适⽤POI（如 果⽤⼾没传经纬度，默认北京王府 井），形如： { id:xxx, name:xxx, distance: xxx, } | |
| name | String | ⻔店名 | |
| distance | float64 | 距离（不传经纬度时，不会返回 distance） | |
| poi_count | int | 适⽤⻔店数量 | |
| marketing_info | object | 营销信息，是⼀个结构体，⽬前仅包 含秒杀信息和优惠券信息: { seckill_info:{ status: 2, start_time: xxx, end_time: xxx, discount_amount: xxx, },coupon_list:[ { discount_amount: xxx, use_start_time: xxx, use_end_time: xxx },{ ... },... ] } | |
| seckill_info | object | 秒杀信息，是⼀个结构体，形如： { status: 2, start_time: xxx, // 秒级时间戳 end_time: xxx, // 秒级时间戳 discount_amount: xxx, } | |
| status | int | 1-预热 2-进⾏中 | |
| start_time | int | 秒杀开始时间(秒级时间戳) | |
| end_time | int | 秒杀结束时间(秒级时间戳) | |
| discount_amount | int | 优惠⾦额，单位：分 | |
| coupon_list | list | 券信息，是⼀个结构体，形如： { discount_amount: xxx, } | |
| discount_amount | int | 优惠⾦额，单位：分 | |
| use_start_time | int | 使⽤开始时间（若未领券，则假设当 前时间领券） | |
| use_end_time | int | 使⽤介质时间（若未领券，则假设当 前时间领券） | |
| available_task | list | 商品关联的计划，是⼀个结构体数 组，形如： [ { id:xxx, type:xxx, commission_rate:xxx, commission:xxx, status:xxx valid_time_begin: xxx, valid_time_end: xxx, is_recommend:true, },{ id:xxx, type:xxx, commission_rate:xxx, commission:xxx, status:xxx valid_time_begin: xxx, valid_time_end: xxx, is_recommend:false, } ] | |
| commission_rate | int | 佣⾦率，如果实际佣⾦率是 12.34%，该字段会返回1234 | |
| estimate_commission | int | 预估佣⾦⾦额，单位：分。>= 实际 佣⾦⾦额，因为折扣、退款等原因 | |
| status | Int | 计划状态 0-下线 1-上线 2-暂停 | |
| valid_time_begin | int | 计划⽣效的开始时间 | |
| valid_time_end | int | 计划⽣效的结束时间 | |
| is_recommend | bool | 当存在多个计划时，当前计划是否为 抖⾳推荐使⽤的计划 | |
| sale_tags | list | 权益标签，是⼀个结构体数组，形 如：[ { content: | |
| content | string | 权益标签⽂案，如 | |
| sold_time_begin | int | 商品售卖开始时间 | |
| sold_time_end | int | 商品售卖结束时间 | |
| category_info | object | 商品类⽬信息，包含⼀/⼆/三级类⽬ 信息，是⼀个object，形如： { first_category: { id: xxx, name: xxx, },second_category: { id: xxx, name: xxx, },third_category: { id: xxx, name: xxx, } } | |
| product_item_detail | list | 商品详情，是⼀个结构体，形如： [ { title: xxx, // 如：精品咖啡3 选1 item_list: [ { name: xxx, price: xxx, count: xxx, unit: xxx, // 单位： 如 | |
| product_detail_img | list | 商品细节图，是⼀个结构体的list， 形如： { { url: [xxx, ] },{ url: [xxx, ] },... } |
{
"code": 1,
"msg": "【success】",
"data": {
"cursor": 1,
"has_more": true,
"product_list": [
{
"dy_detail_page": {
"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=1742836540828699&biz_code=food"
},
"marketing_info": [],
"need_invoice": false,
"product_detail_img": null,
"nearest_poi": {
"name": "正新鸡排(石河子幸福路店)"
},
"sold_info": {
"blurred_sold_count": "100万+",
"sell_out": false
},
"sold_time_begin": 1709541392,
"available_task": [
{
"status": 1,
"type": 1,
"valid_time_begin": 1670050181580,
"valid_time_end": 9999999999999,
"commission": 39,
"commission_rate": 300,
"id": 7172805928072579085,
"is_recommend": true
}
],
"discount_price_infos": [
{
"post_discount_money": 1299,
"single_post_discount_money": 1299,
"discount_type": 1,
"effective_end_time": 1709619234,
"effective_start_time": 1709619234
},
{
"post_discount_money": 1299,
"single_post_discount_money": 1299,
"discount_type": 2,
"effective_end_time": 1709619234,
"effective_start_time": 1709619234
}
],
"id": "1742836540828699",
"price_info": {
"discount_price_infos": null,
"origin_price": 2199,
"price": 1299
},
"sale_tags": [
{
"content": "免预约"
},
{
"content": "随时退·过期退"
}
],
"sold_time_end": 2145887999,
"status": 1,
"type": 1,
"category_info": {
"first_category": {
"id": 1000000,
"name": "美食"
},
"second_category": {
"id": 1017000,
"name": "快餐小吃"
},
"third_category": {
"id": 1017002,
"name": "小吃"
}
},
"name": "【畅销】大鸡排+烤肠（1个）+饮料",
"poi_count": 5785,
"product_img": {
"UrlList": [
"https://p26-sign.douyinpic.com/tos-cn-i-hf2m9xxmck/dd5bcae9c69e414a95a055513f8a8752~tplv-shrink:750:0.image?x-expires=1804226400&x-signature=teEuHNDr5%2BCPZu2XCT23gYmlwoc%3D&from=3158402634"
]
},
"product_item_detail": [
{
"item_list": [
{
"count": 1,
"name": "香辣大鸡排",
"price": 1300,
"unit": "份"
},
{
"count": 1,
"name": "烤肠",
"price": 399,
"unit": "个"
},
{
"name": "饮料",
"price": 500,
"unit": "份",
"count": 1
}
],
"title": "小吃"
}
]
}
]
}
}
