APIKEY获取

商品列表页API


方法:get
返回数据类型:json格式数据
请求链接:http://v2.api.haodanku.com/itemlist
请求示例:http://v2.api.haodanku.com/itemlist/apikey/你的apikey/nav/3/cid/0/back/10/min_id/1
接口说明:如果获取全部商品数据建议请求参数nav直接是3来获取全部商品数据,拉取全量数据是时尽量避开凌晨时段,这个时段由于检查失效下架比较多。

请求参数

参数类型参数值是否必须说明
apikeystring你的apikey放单后台获取的Apikey值
navinteger1默认全部商品(1实时跑单商品,2爆单榜商品,3全部商品,4纯视频单,5聚淘专区)
cidinteger0商品类目:
0全部,1女装,2男装,3内衣,4美妆,5配饰,6鞋品,7箱包,8儿童,9母婴,10居家,11美食,12数码,13家电,14其他,15车品,16文体,17宠物(支持多类目筛选,如1,2获取类目为女装、男装的商品,逗号仅限英文逗号)
backinteger500每页返回条数(请在1,2,10,20,50,100,120,200,500,1000中选择一个数值返回)
min_idinteger1分页,用于实现类似分页抓取效果,来源于上次获取后的数据的min_id值,默认开始请求值为1(该方案比单纯123分页的优势在于:数据更新的情况下保证不会重复也无需关注和计算页数)
sortinteger00.综合(最新),1.券后价(低到高),2.券后价(高到低),3.券面额(高到低),4.月销量(高到低),5.佣金比例(高到低),6.券面额(低到高),7.月销量(低到高),8.佣金比例(低到高),9.全天销量(高到低),10全天销量(低到高),11.近2小时销量(高到低),12.近2小时销量(低到高),13.优惠券领取量(高到低)注意:该排序仅对nav=3,4,5有效,1,2无效
price_mininteger100券后价筛选,筛选大于等于所设置的券后价的商品
price_maxinteger200券后价筛选,筛选小于等于所设置的券后价的商品
sale_mininteger1000销量筛选,筛选大于等于所设置的销量的商品
sale_maxinteger5000销量筛选,筛选小于等于所设置的销量的商品
coupon_mininteger10券金额筛选,筛选大于等于所设置的券金额的商品
coupon_maxinteger20券金额筛选,筛选小于等于所设置的券金额的商品
tkrates_mininteger30佣金比例筛选,筛选大于等于所设置的佣金比例的商品
tkrates_maxinteger50佣金比例筛选,筛选小于所设置的佣金比例的商品
tkmoney_mininteger30佣金筛选,筛选大于等于所设置的佣金的商品
item_typestring0是否只获取营销返利商品

返回参数

参数类型参数值说明
codeInteger1状态码(1成功,0失败或没有数据返回)
min_idInteger2作为请求地址中获取下一页的参数值
msgstringSUCCESS返回信息说明,SUCCESS代表成功获取,失败则有具体原因
product_idInteger2720653自增ID
itemidInteger553757100845宝贝ID
itemtitlestring南极人魅金创意不锈钢垃圾桶家用卫生间客厅卧室脚踏式厕所带盖筒宝贝标题
itemshorttitlestring南极人家用卫生间客厅垃圾袋60个宝贝短标题
itemdescstring南极人加厚垃圾袋60支,采用高强度PE新材料韧性足、无异味、承重佳、封底结实不易漏,避免烂袋尴尬,千万家庭的选择,抢到就是赚!【送运费险】宝贝推荐语
itempricefloat8.10在售价
itemsaleinteger33879宝贝月销量
itemsale2integer5612宝贝近2小时跑单
todaysaleinteger10493当天销量
itempicstringhttps://img.alicdn.com/imgextra/i2/3412518427/TB26gs7bb7U5uJjSZFFXXaYHpXa_!!3412518427.jpg宝贝主图原始图像(由于图片原图过大影响加载速度,建议加上后缀_310x310.jpg,如https://img.alicdn.com/imgextra/i2/3412518427/TB26gs7bb7U5uJjSZFFXXaYHpXa_!!3412518427.jpg_310x310.jpg
itempic_copystring0_553757100845_1509175123.jpg推广长图(带http://img.haodanku.com/0_553757100845_1509175123.jpg-600进行访问)
fqcatinteger10商品类目:
1女装,2男装,3内衣,4美妆,5配饰,6鞋品,7箱包,8儿童,9母婴,10居家,11美食,12数码,13家电,14其他,15车品,16文体,17宠物
itemendpricefloat3.10宝贝券后价
shoptypestringB店铺类型:
天猫店(B)
淘宝店(C)
couponurlstringhttps://uland.taobao.com/quan/detail??sellerId=3162813958&activityId=1d5771905a774f01ad345d26ad8a55b2优惠券链接
couponmoneyfloat5.6优惠券金额
is_brandinteger0是否为品牌产品(1是)
is_liveinteger0是否为直播(1是)
guide_articlestring南极人加厚垃圾袋60支,采用高强度PE新材料韧性足、无异味、承重佳、封底结实不易漏,避免烂袋尴尬,千万家庭的选择,抢到就是赚!【送运费险】推广导购文案
videoidinteger0商品视频ID(id大于0的为有视频单,视频拼接地址http://cloud.video.taobao.com/play/u/1/p/1/e/6/t/1/+videoid+.mp4)
activity_typestring普通活动活动类型:
普通活动
聚划算
淘抢购
planlinkstringhttps://s.click.taobao.com/KjSknfw营销计划链接
useridinteger3162813958店主的userid
sellernickstring南极人唯欲专卖店店铺掌柜名
shopnamestring南极人唯欲专卖店店铺名
tktypestring营销计划佣金计划:
隐藏
营销
tkratesfloat70.50佣金比例
cuntaointeger0是否村淘(1是)
tkmoneyfloat2.19预计可得(宝贝价格 * 佣金比例 / 100)
couponreceive2integer0当天优惠券领取量
couponsurplusinteger100000优惠券剩余量
couponnuminteger100000优惠券总数量
couponexplainstring单笔满8元可用优惠券使用条件
couponstarttimeinteger1509120000优惠券开始时间
couponendtimeinteger1509292799优惠券结束时间
start_timeinteger1509174000活动开始时间
end_timeinteger1509292799活动结束时间
starttimeinteger1509174000发布时间
report_statusinteger0举报处理条件
0未举报
1为待处理
2为忽略
3为下架
general_indexinteger344好单指数
seller_namestring若梦****追梦放单人名号
discountfloat5.0折扣力度
Json返回示例:
{
"code": 1,
"min_id": 3136867,
"msg": "SUCCESS",
"data": [{
"product_id": "3136867",
"itemid": "557787124271",
"itemtitle": "太平有象3支纳米牙刷替换头硅胶成人软毛家用家庭装旅行盒套装",
"itemshorttitle": "太平有象3支纳米牙刷替换头硅胶",
"itemdesc": "纳米牙刷采用软胶体,弾韧软胶刷毛,按摩牙龈不易变形,护龈洁齿,带来更佳的刷牙体验!",
"itemprice": "25.80",
"itemsale": "555",
"itemsale2": "0",
"todaysale": "0",
......
}]}