APIKEY获取

关键词商品页API


方法:get
返回数据类型:json格式数据
请求链接:http://v2.api.haodanku.com/get_keyword_items
请求示例:http://v2.api.haodanku.com/get_keyword_items/apikey/你的apikey/keyword/%25e5%25a5%25b3%25e8%25a3%2585/back/10/sort/0/cid/0

请求参数

参数类型参数值是否必须说明
apikeystring你的apikey放单后台获取的Apikey值
keywordstring%25e5%25a5%25b3%25e8%25a3%2585搜索关键词 支持宝贝ID搜索即keyword=itemid(由于存在特殊符号搜索的关键词必须进行两次urlencode编码
shopidstring111556986根据店铺id搜索商品 (需要注意的是店铺id搜索暂不支持筛选和排序,如果链接里有关键词和shopid优先搜索店铺id商品
backinteger500每页返回条数(请在1,2,10,20,50,100,120,200,500,1000中选择一个数值返回)
sortinteger00.综合(最新),1.券后价(低到高),2.券后价(高到低),3.券面额,4.销量,5.佣金比例,6.券面额(低到高),7.月销量(低到高),8.佣金比例(低到高),9.全天销量(高到低),10全天销量(低到高),11.近2小时销量(高到低),12.近2小时销量(低到高),13.优惠券领取量(高到低),14.好单库指数(高到低)
cidinteger00全部,1女装,2男装,3内衣,4美妆,5配饰,6鞋品,7箱包,8儿童,9母婴,10居家,11美食,12数码,13家电,14其他,15车品,16文体
min_idinteger1分页,用于实现类似分页抓取效果,来源于上次获取后的数据的min_id值,默认开始请求值为1(该方案比单纯123分页的优势在于:数据更新的情况下保证不会重复也无需关注和计算页数)
price_mininteger100券后价筛选,筛选大于等于所设置的券后价的商品
price_maxinteger200券后价筛选,筛选小于等于所设置的券后价的商品
sale_mininteger1000销量筛选,筛选大于等于所设置的销量的商品
sale_maxinteger5000销量筛选,筛选小于等于所设置的销量的商品
coupon_mininteger10券金额筛选,筛选大于等于所设置的券金额的商品
coupon_maxinteger20券金额筛选,筛选小于等于所设置的券金额的商品
typeinteger1商品筛选类型:type=1是今日上新,type=2是9.9包邮,type=3是30元封顶,type=4是聚划算,type=5是淘抢购,type=6是0点过夜单,type=7是预告单,type=8是品牌单,type=9是天猫商品,type=10是视频单

返回参数

参数类型参数值说明
codeinteger1状态码(1成功,0失败或没有数据返回)
min_idinteger2作为请求地址中获取下一页的参数值
msgstringSUCCESS返回信息说明,SUCCESS代表成功获取,失败则有具体原因
totalstring1298搜索结果总数
product_idinteger2720653自增ID
itemidinteger553757100845宝贝ID
seller_idinteger9522放单人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)
tktypestring营销计划佣金计划:
隐藏
营销
tkratesfloat70.50佣金比例
cuntaointeger0是否村淘(1是)
tkmoneyfloat2.19预计可得(宝贝价格 * 佣金比例 / 100)
couponurlhttps://uland.taobao.com/quan/detail??sellerId=3162813958&activityId=1d5771905a774f01ad345d26ad8a55b2优惠券链接
couponmoneyfloat5.6优惠券金额
couponsurplusinteger625优惠券剩余量
couponreceiveinteger158优惠券领取量
couponreceive20当天优惠券领取量
todaycouponreceiveinteger0今日优惠券领取量
couponnuminteger100000优惠券总数量
couponexplainstring单笔满8元可用优惠券使用条件
couponstarttimeinteger1509120000优惠券开始时间
couponendtimeinteger1509292799优惠券结束时间
start_timeinteger1509174000活动开始时间
end_timeinteger1509292799活动结束时间
starttimeinteger1509174000发布时间
report_statusinteger0举报处理条件
0未举报
1为待处理
2为忽略
3为下架
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普通活动活动类型
普通活动
聚划算
淘抢购
general_indexinteger344好单指数
planlinkstringhttps://s.click.taobao.com/ei0gtfw营销计划链接
seller_namestring若梦****追梦放单人名号
useridinteger3162813958店主的userid
sellernickstring南极人唯欲专卖店店铺掌柜名
shopnamestring南极人唯欲专卖店店铺名
discountfloat1.00折扣力度
depositfloat5.0双十一定金
deposit_deductfloat5.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",
......
}]}