数据接口API

点击获取APKEY

正常 (重构版)物料精选


请求链接: http://api.web.21ds.cn/taoke/getMaterialItem
请求实例: http://api.web.21ds.cn/taoke/getMaterialItem?apkey=登录后即可显示&pid=mm_123456_456789_789132&tbname=xxxxxx (注:此实例中的密钥为登录用户的真实密钥,不登录不显示,请妥善保管,切勿泄露!)
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】进行Urlencode编码,然后再试。
今日调用统计: 暂无统计
会员限制: 全部会员 (新用户注册立刻送7天V1付费会员)
频率说明: 不同会员级别调用频率不同,具体可见会员升级页面介绍。会员升级传送门
使用说明: 通用物料推荐,传入官方公布的物料id,可获取指定物料
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 >立即抢购<<-

使用说明

暂无说明

请求参数

参数类型请求参数参考值是否必须说明
apkeyStringxxxxxxx用户中心 - 基础设置 中查看APKEY密钥(*必要
pidStringmm_123456_456789_789132pid
tbnameStringxxxxxx在本平台授权的淘客账号所对应的用户名,见“会员中心”-“账号授权”-“淘宝授权”列表页
materialidNumber4094官方的物料Id(详细物料id见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8576096)
pagesizeNumber10页大小,默认20,1~100
pagenoString1第几页,默认:1
device_valueStringbe427789f6a7195b798a5a9cc2e0cd5b智能匹配-设备号加密后的值(MD5加密需32位小写)
device_encryptStringMD5智能匹配-设备号加密类型:MD5
device_typeStringIDFA智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID
content_idString内容专用-内容详情ID
content_sourceString内容专用-内容渠道信息
item_idNumber商品ID,用于相似商品推荐

返回参数

返回参数类型参数说明扩展说明
dataString返回结果
 ├ coupon_amountNumber优惠券信息-优惠券面额。如:满299元减20元
 ├ small_imagesJson商品信息-商品小图列表
 ├ shop_titleString店铺信息-店铺名称
 ├ category_idNumber商品信息-叶子类目id
 ├ coupon_start_feeString优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元
 ├ item_idNumber商品信息-宝贝id
 ├ coupon_total_countNumber优惠券信息-优惠券总量
 ├ user_typeNumber店铺信息-卖家类型0表示集市,1表示商城
 ├ zk_final_priceString商品信息-商品折扣价
 ├ coupon_remain_countNumber优惠券信息-优惠券剩余量
 ├ commission_rateString商品信息-佣金比率(%)
 ├ coupon_start_timeString优惠券信息-优惠券开始时间
 ├ titleString商品信息-商品标题
 ├ item_descriptionString商品信息-宝贝描述推荐理由,不一定有
 ├ seller_idNumber店铺信息-卖家id
 ├ volumeString商品信息-30天销量
 ├ coupon_end_timeString优惠券信息-优惠券结束时间
 ├ pict_urlString商品信息-商品主图
 ├ click_urlString链接-宝贝推广链接
 ├ stockString拼团剩余库存拼团专用
 ├ sell_numNumber拼团已售数量拼团专用
 ├ total_stockNumber拼团库存数量拼团专用
 ├ oetimeString拼团结束时间拼团专用
 ├ ostimeString拼团开始时间拼团专用
 ├ jdd_numNumber拼团几人团拼团专用
 ├ jdd_priceString拼团拼成价,单位元拼团专用
 ├ orig_priceString拼团一人价(原价),单位元拼团专用
 ├ level_one_category_nameString一级类目名称商品信息
 ├ level_one_category_idNumber一级类目ID商品信息
 ├ category_nameString叶子类目名称商品信息
 ├ short_titleString商品短标题商品信息
 ├ white_imageString商品白底图商品信息
 ├ word_listJson商品关联词商品信息
 ├  ├ wordString商品相关的关联词商品信息
 ├  ├ urlString商品相关关联词落地页地址商品信息
 ├ tmall_play_activity_infoString营销-天猫营销玩法前n件x折
 ├ uv_sum_pre_saleNumber预售数量商品信息
 ├ new_user_priceString新人价
 ├ coupon_infoString优惠券信息-优惠券满减信息
 ├ coupon_share_urlString链接-宝贝+券二合一页面链接
 ├ nickString店铺信息-卖家昵称
 ├ reserve_priceString商品信息-一口价
 ├ ju_online_end_timeString聚淘结束时间聚划算信息
 ├ ju_online_start_timeString聚淘开始时间聚划算信息
 ├ maochao_play_free_post_feeString当前是否包邮,1:是,0:否猫超玩法信息
 ├ maochao_play_end_timeString活动结束时间,精确到毫秒猫超玩法信息
 ├ maochao_play_start_timeString活动开始时间,精确到毫秒猫超玩法信息
 ├ maochao_play_conditionsString折扣条件,价格百分数存储,件数按数量存储。可以有多个折扣条件,与折扣字段对应,','分割猫超玩法信息
 ├ maochao_play_discountsString折扣,折扣按照百分数存储,其余按照单位分存储。可以有多个折扣,','分割猫超玩法信息
 ├ maochao_play_discount_typeString玩法类型,2:折扣(满n件折扣),5:减钱(满n元减m元)猫超玩法信息
 ├ multi_coupon_zk_rateString多件券优惠比例
 ├ price_after_multi_couponString多件券件单价
 ├ multi_coupon_item_countString多件券件数
 ├ lock_rateString锁住的佣金率
 ├ lock_rate_end_timeString锁佣结束时间
 ├ lock_rate_start_timeString锁佣开始时间
 ├ presale_discount_fee_textString优惠信息预售商品
 ├ presale_tail_end_timeString付尾款结束时间(毫秒)预售商品
 ├ presale_tail_start_timeString付尾款开始时间(毫秒)预售商品
 ├ presale_end_timeString付定金结束时间(毫秒)预售商品
 ├ presale_start_timeString付定金开始时间(毫秒)预售商品
 ├ presale_depositString定金(元)预售商品
 ├ ysyl_tlj_send_timeString淘礼金发放时间预售有礼
 ├ ysyl_click_urlString推广链接预售有礼
 ├ ysyl_tlj_faceString预估淘礼金(元)预售有礼
 ├ ysyl_commission_rateString2030(表示20.3%)预售有礼-佣金比例( 预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 )
 ├ ysyl_tlj_use_end_timeString淘礼金使用结束时间预售有礼
 ├ ysyl_tlj_use_start_timeString淘礼金使用开始时间预售有礼

Json返回示例

{"code":200,"data":[{"category_id":"124312001","click_url":"//s.click.taobao.com/t?e=m=2&s=YD/hqgIU8vNw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0OkD+2sfa63YQjkYIyd8r6R5AXfiWajJ7kM7/x4T0IGLoZWj9sofm/fxDhneUlf29l9EeTtntI44hla2gak2AfaDfG54Fm7HvCehQVnVrhs0skmx5kiO8DrXn/66GKkZXbj8Cm8j3o1mXcA+W46NIkKdwLAiV4+OTeh0WN8Lbm3FcSpj5qSCmbA=&scm=1007.15348.115058.0_24761&pvid=c2697c83-e7e7-4e17-ad86-f4768c83993b&app_pvid=59590_11.23.74.225_55594_1568729324750&ptl=floorId:24761;originalFloorId:24761;pvid:c2697c83-e7e7-4e17-ad86-f4768c83993b;app_pvid:59590_11.23.74.225_55594_1568729324750&union_lens=lensId:n@1568729324@c2697c83-e7e7-4e17-ad86-f4768c83993b_576050176116@1","commission_rate":"9.0","coupon_amount":"5","coupon_click_url":"//uland.taobao.com/coupon/edetail?e=RHAP3dIFwcINfLV8niU3R5TgU2jJNKOfU1BGIDN741G0+c5Gzwi6geKSfLX1rbqQLGbJes29FQq2QeBl4W2u7+Mp8mtkdkG9jpTnYalLeM2HcxKBSO1kGWv8mqhUi+lmQFWprsaJjNnCXyVQnlyjboLjKMjbgDW2CQkbG8v/MjraHj4QP+oWBPeN7ntwbNKXc1dLsHth/jW0KcFcvEEv1+TNJGYOahjs&&app_pvid=59590_11.23.74.225_55594_1568729324750&ptl=floorId:24761;app_pvid:59590_11.23.74.225_55594_1568729324750;tpp_pvid:c2697c83-e7e7-4e17-ad86-f4768c83993b&union_lens=lensId:n@1568729324@c2697c83-e7e7-4e17-ad86-f4768c83993b_576050176116@1","coupon_end_time":"1568908799000","coupon_remain_count":"100000","coupon_share_url":"//uland.taobao.com/coupon/edetail?e=RHAP3dIFwcINfLV8niU3R5TgU2jJNKOfU1BGIDN741G0+c5Gzwi6geKSfLX1rbqQLGbJes29FQq2QeBl4W2u7+Mp8mtkdkG9jpTnYalLeM2HcxKBSO1kGWv8mqhUi+lmQFWprsaJjNnCXyVQnlyjboLjKMjbgDW2CQkbG8v/MjraHj4QP+oWBPeN7ntwbNKXc1dLsHth/jW0KcFcvEEv1+TNJGYOahjs&&app_pvid=59590_11.23.74.225_55594_1568729324750&ptl=floorId:24761;app_pvid:59590_11.23.74.225_55594_1568729324750;tpp_pvid:c2697c83-e7e7-4e17-ad86-f4768c83993b&union_lens=lensId:n@1568729324@c2697c83-e7e7-4e17-ad86-f4768c83993b_576050176116@1","coupon_start_fee":"10.0","coupon_start_time":"1568649600000","coupon_total_count":"100000","item_description":"户外运动,饱腹代餐,充饥食品,酥脆新工艺","item_id":"576050176116","level_one_category_id":"50002766","level_one_category_name":"零食/坚果/特产","nick":"休闲农场旗舰店","pict_url":"//img.alicdn.com/bao/uploaded/i2/2836984312/O1CN01jOqQ9K1hiwNGSqdZr_!!0-item_pic.jpg","seller_id":"2836984312","short_title":"休闲农场压缩小包装多口味户外饼干","small_images":{"string":["//img.alicdn.com/i1/2836984312/O1CN01EILSY31hiwJj5S3PA_!!2836984312.jpg","//img.alicdn.com/i4/2836984312/O1CN011hiwICvkJxwjCag_!!2836984312.jpg","//img.alicdn.com/i3/2836984312/O1CN011hiwIvprRNpJSUv_!!2836984312.jpg","//img.alicdn.com/i1/2836984312/TB2eelatrorBKNjSZFjXXc_SpXa_!!2836984312.jpg"]},"title":"休闲农场压缩饼干小包装多口味户外代餐饱腹干粮散装零食整箱","user_type":"1","volume":"23300","zk_final_price":"14.8"},{"category_id":"50009859","click_url":"//s.click.taobao.com/t?e=m=2&s=0ILsYwMvx21w4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0OkD+2sfa63YQjkYIyd8r6R5AXfiWajJ7kM7/x4T0IGLoZWj9sofm/fxDhneUlf29l9EeTtntI44hla2gak2AfbzPtVSNNR3lXdiviuNJJSjskmx5kiO8DrXn/66GKkZXbj8Cm8j3o1m3Oi+TbcbBcHXS3pEO5vaa+h0WN8Lbm3FcSpj5qSCmbA=&scm=1007.15348.115058.0_24761&pvid=c2697c83-e7e7-4e17-ad86-f4768c83993b&app_pvid=59590_11.23.74.225_55594_1568729324750&ptl=floorId:24761;originalFloorId:24761;pvid:c2697c83-e7e7-4e17-ad86-f4768c83993b;app_pvid:59590_11.23.74.225_55594_1568729324750&union_lens=lensId:n@1568729324@c2697c83-e7e7-4e17-ad86-f4768c83993b_573760325461@1","commission_rate":"6.33","coupon_amount":"50","coupon_click_url":"//uland.taobao.com/coupon/edetail?e=UjBerrHmIKgNfLV8niU3R5TgU2jJNKOfU1BGIDN741G0+c5Gzwi6geKSfLX1rbqQLGbJes29FQq2QeBl4W2u72dPCw6pg52/GR3mv0wEHrCHcxKBSO1kGWv8mqhUi+lmQFWprsaJjNnCXyVQnlyjboLjKMjbgDW2CQkbG8v/Mjo6KSWHbOdYWN6eGkbiB3MWZQMs8yTDkbq//H7HmUq/o+TNJGYOahjs&&app_pvid=59590_11.23.74.225_55594_1568729324750&ptl=floorId:24761;app_pvid:59590_11.23.74.225_55594_1568729324750;tpp_pvid:c2697c83-e7e7-4e17-ad86-f4768c83993b&union_lens=lensId:n@1568729324@c2697c83-e7e7-4e17-ad86-f4768c83993b_573760325461@1","coupon_end_time":"1568908799000","coupon_remain_count":"9996","coupon_share_url":"//uland.taobao.com/coupon/edetail?e=UjBerrHmIKgNfLV8niU3R5TgU2jJNKOfU1BGIDN741G0+c5Gzwi6geKSfLX1rbqQLGbJes29FQq2QeBl4W2u72dPCw6pg52/GR3mv0wEHrCHcxKBSO1kGWv8mqhUi+lmQFWprsaJjNnCXyVQnlyjboLjKMjbgDW2CQkbG8v/Mjo6KSWHbOdYWN6eGkbiB3MWZQMs8yTDkbq//H7HmUq/o+TNJGYOahjs&&app_pvid=59590_11.23.74.225_55594_1568729324750&ptl=floorId:24761;app_pvid:59590_11.23.74.225_55594_1568729324750;tpp_pvid:c2697c83-e7e7-4e17-ad86-f4768c83993b&union_lens=lensId:n@1568729324@c2697c83-e7e7-4e17-ad86-f4768c83993b_573760325461@1","coupon_start_fee":"100.0","coupon_start_time":"1568563200000","coupon_total_count":"10000","item_description":"特别添加桑葚保护视力 适合上班族和青少年","item_id":"573760325461","level_one_category_id":"50026316","level_one_category_name":"咖啡/麦片/冲饮","nick":"myshee海外旗舰店","pict_url":"//img.alicdn.com/bao/uploaded/i3/3980882903/O1CN01CSeaCt1XJcKtff5M2_!!0-item_pic.jpg","seller_id":"3980882903","short_title":"myshee澳洲进口网红奇亚桑葚*麦片","small_images":{"string":["//img.alicdn.com/i2/3980882903/O1CN011XJcFGqQzE38rdF_!!3980882903.jpg","//img.alicdn.com/i1/3980882903/TB2czj1GbSYBuNjSspfXXcZCpXa_!!3980882903.jpg","//img.alicdn.com/i1/3980882903/TB2.np8xZuYBuNkSmRyXXcA3pXa_!!3980882903.jpg","//img.alicdn.com/i1/3980882903/TB2Pq8ux5CYBuNkSnaVXXcMsVXa_!!3980882903.jpg"]},"title":"myshee澳洲进口网红奇亚桑葚功能水果坚果麦片早餐燕麦450g*2临期","user_type":"1","volume":"55","zk_final_price":"139"}],"msg":"success"}

code/http_status说明

code/http_status说明
200数据获取成功
-1数据获取失败
401IP没有添加白名单
429访问次数超限
403关键参数丢失
405请求方式不对