正常物料精选[猜你喜欢] 接口在线测试

通用物料推荐，传入官方公布的物料id，可获取指定物料

接口地址： http://api.web.ecapi.cn/taoke/getMaterialItem

接口实例： http://api.web.ecapi.cn/taoke/getMaterialItem?apkey=登录会员中心查看&pid=mm_123456_456789_789132&tbname=xxxxxx

注意事项：如调用接口时数据返回异常，则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码，然后再试。

请求方式：GET

会员范围：全部会员 (新用户注册立刻送7天V1付费会员【注：赠送会员可使用全部接口，但调用频率与免费会员一致，免费会员调用频率可参考会员等级说明】)

必看注意：为保障接口安全及使用效率，调用本站接口前需先添加IP白名单 (IP地址测试)，若IP不固定且无服务器，可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口，禁止将接口重新打包销售或转卖，一经发现，将做帐号封禁处理。

优惠推荐：高性能云服务器2折起，普惠上云，仅需234元/年 ->>立即抢购<<- 。

使用说明: 暂无说明

请求参数

参数	类型	请求参数参考值	是否必须	说明
apkey	String	xxxxxxx	是	用户中心 - 系统设置 - 平台设置中查看APKEY密钥 (点我获取)（*必要）
pid	String	mm_123456_456789_789132	是	pid（注：如已在会员中心设置了默认PID，此参数可无需再次传入）
tbname	String	xxxxxx	是	在本平台授权的淘客账号所对应的用户名，见“会员中心”-“账号授权”-“淘宝授权”列表页
materialid	Number	4094		请求API参数中materialid设置为6708，同时传入用户设备信息，即可返回个性化的推荐结果。官方的物料Id(详细物料id见：https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html?#/detail/10628875?_k=k64m5e)
pagesize	Number	10		页大小，默认20，1~100
pageno	String	1		第几页，默认：1
device_value	String	be427789f6a7195b798a5a9cc2e0cd5b		智能匹配-设备号加密后的值（MD5加密需32位小写），类型为OAID时传原始OAID值
device_encrypt	String	MD5		智能匹配-设备号加密类型：MD5，类型为OAID时不传
device_type	String	IDFA		智能匹配-设备号类型：IMEI，或者IDFA，或者UTDID（UTDID不支持MD5加密），或者OAID
content_id	String			内容专用-内容详情ID
content_source	String			内容专用-内容渠道信息
item_id	String			淘宝客新商品ID；用于相似商品推荐（注意：使用相似商品推荐material_id=13256必传，并请先签署协议https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)；另关于《淘宝客新商品ID升级》参考白皮书：https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud
relation_id	String	xxxx		渠道ID，获取说明：https://doc.21ds.cn/detail?doc=4685763267728060/4970875219793639
favorites_id	String			选品库收藏夹id，获取收藏夹id参考文档：https://mos.m.taobao.com/union/page_20230109_175050_176?spm=a219t._portal_v2_pages_promo_goods_index_htm.0.0.7c2a75a5H2ER3N

返回参数

返回参数	类型	参数说明	扩展说明
data	String	返回结果
├　coupon_amount	Number	优惠券信息-优惠券面额。	如：满299元减20元
├　small_images	Json	商品信息-商品小图列表
├　shop_title	String	店铺信息-店铺名称
├　category_id	Number	商品信息-叶子类目id
├　coupon_start_fee	String	优惠券信息-优惠券起用门槛，满X元可用。	如：满299元减20元
├　item_id	String	商品信息-宝贝id
├　coupon_total_count	Number	优惠券信息-优惠券总量
├　user_type	Number	店铺信息-卖家类型	0表示集市，1表示商城
├　zk_final_price	String	商品信息-商品折扣价
├　coupon_remain_count	Number	优惠券信息-优惠券剩余量
├　commission_rate	String	商品信息-佣金比率(%)
├　coupon_start_time	String	优惠券信息-优惠券开始时间
├　title	String	商品信息-商品标题
├　item_description	String	商品信息-宝贝描述	推荐理由,不一定有
├　seller_id	Number	店铺信息-卖家id
├　volume	String	商品信息-30天销量
├　coupon_end_time	String	优惠券信息-优惠券结束时间
├　pict_url	String	商品信息-商品主图
├　click_url	String	链接-宝贝推广链接
├　stock	String	拼团剩余库存	拼团专用
├　sell_num	Number	拼团已售数量	拼团专用
├　total_stock	Number	拼团库存数量	拼团专用
├　oetime	String	拼团结束时间	拼团专用
├　ostime	String	拼团开始时间	拼团专用
├　jdd_num	Number	拼团几人团	拼团专用
├　jdd_price	String	拼团拼成价，单位元	拼团专用
├　orig_price	String	拼团一人价（原价)，单位元	拼团专用
├　level_one_category_name	String	一级类目名称	商品信息
├　level_one_category_id	Number	一级类目ID	商品信息
├　category_name	String	叶子类目名称	商品信息
├　short_title	String	商品短标题	商品信息
├　white_image	String	商品白底图	商品信息
├　word_list	Json	商品关联词	商品信息
├　　├　word	String	商品相关的关联词	商品信息
├　　├　url	String	商品相关关联词落地页地址	商品信息
├　tmall_play_activity_info	String	营销-天猫营销玩法	前n件x折
├　uv_sum_pre_sale	Number	预售数量	商品信息
├　new_user_price	String	新人价
├　coupon_info	String	优惠券信息-优惠券满减信息
├　coupon_share_url	String	链接-宝贝+券二合一页面链接
├　nick	String	店铺信息-卖家昵称
├　reserve_price	String	商品信息-一口价
├　ju_online_end_time	String	聚淘结束时间	聚划算信息
├　ju_online_start_time	String	聚淘开始时间	聚划算信息
├　maochao_play_free_post_fee	String	当前是否包邮，1:是，0:否	猫超玩法信息
├　maochao_play_end_time	String	活动结束时间，精确到毫秒	猫超玩法信息
├　maochao_play_start_time	String	活动开始时间，精确到毫秒	猫超玩法信息
├　maochao_play_conditions	String	折扣条件，价格百分数存储，件数按数量存储。可以有多个折扣条件，与折扣字段对应，','分割	猫超玩法信息
├　maochao_play_discounts	String	折扣，折扣按照百分数存储，其余按照单位分存储。可以有多个折扣，','分割	猫超玩法信息
├　maochao_play_discount_type	String	玩法类型，2:折扣(满n件折扣),5:减钱(满n元减m元)	猫超玩法信息
├　multi_coupon_zk_rate	String	多件券优惠比例
├　price_after_multi_coupon	String	多件券件单价
├　multi_coupon_item_count	String	多件券件数
├　lock_rate	String	锁住的佣金率
├　lock_rate_end_time	String	锁佣结束时间
├　lock_rate_start_time	String	锁佣开始时间
├　presale_discount_fee_text	String	优惠信息	预售商品
├　presale_tail_end_time	String	付尾款结束时间（毫秒）	预售商品
├　presale_tail_start_time	String	付尾款开始时间（毫秒）	预售商品
├　presale_end_time	String	付定金结束时间（毫秒）	预售商品
├　presale_start_time	String	付定金开始时间（毫秒）	预售商品
├　presale_deposit	String	定金（元）	预售商品
├　ysyl_tlj_send_time	String	淘礼金发放时间	预售有礼
├　ysyl_click_url	String	推广链接	预售有礼
├　ysyl_tlj_face	String	预估淘礼金（元）	预售有礼
├　ysyl_commission_rate	String	2030（表示20.3%）	预售有礼-佣金比例（预售有礼活动享受的推广佣金比例，注：推广该活动有特殊分成规则，请详见：https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 ）
├　ysyl_tlj_use_end_time	String	淘礼金使用结束时间	预售有礼
├　ysyl_tlj_use_start_time	String	淘礼金使用开始时间	预售有礼

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	数据获取失败
401	IP没有添加白名单
429	访问次数超限
403	关键参数丢失
405	请求方式不对