淘宝客物料精选

¥免费基础接口

请求方法

接口地址:http://api.tkurl.top/api/alimama/optimusmaterial

支持格式:json

请求方式:get

请求示例:http://api.tkurl.top/api/alimama/optimusmaterial?Appkey=&MaterialId=28026

请求参数说明:

名称 类型 是否必须 示例值 描述
Appkey String 必填 123456 appkey
MaterialId int 必填 1234 官方的物料Id(详细物料id见:https://market.m.taobao.com/app/qn/toutiao-new/index-pc.html#/detail/10628875?_k=gpov9a)
PageSize int 可选 20 页大小,默认20,1~100
PageNo int 可选 1 第几页,默认:1
DeviceValue String 可选 xxx 智能匹配-设备号加密后的值(MD5加密需32位小写),类型为OAID时传原始OAID值
DeviceEncrypt String 可选 MD5 智能匹配-设备号加密类型:MD5,类型为OAID时不传
DeviceType String 可选 IMEI 智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID
ContentId int 可选 323 内容专用-内容详情ID
ContentSource String 可选 xxx 内容专用-内容渠道信息
ItemId int 可选 33243 商品ID,用于相似商品推荐

响应参数

名称
类型
示例值
描述
result_list
MapData []
resultList
coupon_amount
Number
40
优惠券(元) 若属于预售商品,该优惠券付尾款可用,付定金不可用
small_images
String[]
商品信息-商品小图列表
shop_title
String
魔黛娅内衣旗舰店
店铺信息-店铺名称
category_id
Number
162201
商品信息-叶子类目id
coupon_start_fee
String
69
优惠券信息-优惠券起用门槛,满X元可用。如:满299元减20元
item_id
Number
556633720749
商品信息-宝贝id
coupon_total_count
Number
30000
优惠券信息-优惠券总量
user_type
Number
1
店铺信息-卖家类型,0表示淘宝,1表示天猫,3表示特价版
zk_final_price
String
79.9
折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价
coupon_remain_count
Number
1936
优惠券信息-优惠券剩余量
commission_rate
String
5.50
商品信息-佣金比率(%)
coupon_start_time
String
2017-10-29
优惠券信息-优惠券开始时间
title
String
毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款
商品信息-商品标题
item_description
String
商品信息-宝贝描述(推荐理由,不一定有)
seller_id
Number
745957850
店铺信息-卖家id
volume
Number
3837
商品信息-30天销量
coupon_end_time
String
2017-11-02
优惠券信息-优惠券结束时间
coupon_click_url
String
//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8
链接-宝贝+券二合一页面链接(该字段废弃,请勿再用)
pict_url
String
//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
商品信息-商品主图
click_url
String
//item.taobao.com/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e
链接-宝贝推广链接
stock
Number
拼团专用-拼团剩余库存
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
商品信息-叶子类目名称
white_image
String
https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
商品信息-商品白底图
short_title
String
sss
商品信息-商品短标题
word_list
WordMapData[]
商品信息-商品关联词
url
String
https://uland.taobao.com/semm/tbxxxx
链接-商品相关关联词落地页地址
word
String
孕妇装
商品相关的关联词
tmall_play_activity_info
String
前n件x折
营销-天猫营销玩法
uv_sum_pre_sale
Number
21
商品信息-预售数量
x_id
String
uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc
物料块id(测试中请勿使用)
new_user_price
String
1.99
商品信息-新人价
coupon_info
String
满299减30元
优惠券信息-优惠券满减信息
coupon_share_url
String
//uland.taobao.com/coupon/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8
链接-宝贝+券二合一页面链接
nick
String
秉迪数码专营店
店铺信息-卖家昵称
reserve_price
String
2.99
商品信息-一口价
ju_online_end_time
String
1559750399000
聚划算信息-聚淘结束时间
ju_online_start_time
String
1559232000000
聚划算信息-聚淘开始时间
maochao_play_end_time
String
1559750399000
猫超玩法信息-活动结束时间,精确到毫秒
maochao_play_start_time
String
1559232000000
猫超玩法信息-活动开始时间,精确到毫秒
maochao_play_conditions
String
2,3
猫超玩法信息-折扣条件,价格百分数存储,件数按数量存储。可以有多个折扣条件,与折扣字段对应,','分割
maochao_play_discounts
String
500,450
猫超玩法信息-折扣,折扣按照百分数存储,其余按照单位分存储。可以有多个折扣,','分割
maochao_play_discount_type
String
2
猫超玩法信息-玩法类型,2:折扣(满n件折扣),5:减钱(满n元减m元)
maochao_play_free_post_fee
String
1
猫超玩法信息-当前是否包邮,1:是,0:否
multi_coupon_zk_rate
String
0.41234
多件券优惠比例
price_after_multi_coupon
String
9.9
多件券件单价
multi_coupon_item_count
String
3
多件券单品件数
lock_rate
String
110
锁住的佣金率
lock_rate_end_time
Number
1567440000000
锁佣结束时间
lock_rate_start_time
Number
1567440000000
锁佣开始时间
promotion_type
String
1
满减满折的类型(1. 满减 2. 满折)
promotion_info
String
满2件打5折;满300减20
满减满折信息
promotion_discount
String
300
满减满折门槛(满2件打5折中值为2;满300减20中值为300)
promotion_condition
String
5
满减满折优惠(满2件打5折中值为5;满300减20中值为20)
presale_discount_fee_text
String
付定金立减5元
预售商品-优惠信息
presale_tail_end_time
Number
1567440000000
预售商品-付尾款结束时间(毫秒)
presale_tail_start_time
Number
1567440000000
预售商品-付尾款开始时间(毫秒)
presale_end_time
Number
1567440000000
预售商品-付定金结束时间(毫秒)
presale_start_time
Number
1567440000000
预售商品-付定金开始时间(毫秒)
presale_deposit
String
100
预售商品-定金(元)
ysyl_tlj_use_start_time
String
2019-11-10 21:59:59
预售有礼-淘礼金使用开始时间
ysyl_commission_rate
String
2030(表示20.3%)
预售有礼-佣金比例( 预售有礼活动享受的推广佣金比例,注:推广该活动有特殊分成规则,请详见:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 )
ysyl_tlj_send_time
String
2019-11-10 21:59:59
预售有礼-淘礼金发放时间
ysyl_tlj_face
String
0.6
预售有礼-预估淘礼金(元)
ysyl_click_url
String
https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1
预售有礼-推广链接
ysyl_tlj_use_end_time
String
2019-11-10 21:59:59
预售有礼-淘礼金使用结束时间
ju_play_end_time
Number
1567440000000
聚划算满减 -结束时间(毫秒)
ju_play_start_time
Number
1567440000000
聚划算满减 -开始时间(毫秒)
play_info
String
玩法
1聚划算满减:满N件减X元,满N件X折,满N件X元) 2天猫限时抢:前N分钟每件X元,前N分钟满N件每件X元,前N件每件X元)
tmall_play_activity_end_time
Number
1567440000000
天猫限时抢可售 -结束时间(毫秒)
tmall_play_activity_start_time
Number
1567440000000
天猫限时抢可售 -开始时间(毫秒)
ju_pre_show_end_time
String
1581868800000
聚划算信息-商品预热开始时间(毫秒)
ju_pre_show_start_time
String
1582300799000
聚划算信息-商品预热结束时间(毫秒)
favorites_info
FavoritesInfo
选品库信息
total_count
Number
100
选品库总数量
favorites_list
FavoritesDetail[]
选品库详细信息
favorites_id
Number
12334
选品库id
favorites_title
String
测试选品库
选品库标题
sale_price
String
168
活动价
kuadian_promotion_info
String
["每100减20","每200减50"]
跨店满减信息
sub_title
String
吉品鲍鱼 关西参
商品子标题
jhs_price_usp_list
String
满200减10
聚划算商品价格卖点描述
tqg_online_end_time
String
1581868800000
淘抢购商品专用-结束时间
tqg_online_start_time
String
1581868800000
淘抢购商品专用-开团时间
tqg_sold_count
Number
20
淘抢购商品专用-已抢购数量
tqg_total_count
Number
50
淘抢购商品专用-总库存
superior_brand
String
1
是否品牌精选,0不是,1是
is_brand_flash_sale
String
1
是否品牌快抢,0不是,1是
hot_flag
String
1
是否是热门商品,0不是,1是
topn_info
TopNInfoDTO
前N件佣金信息-前N件佣金生效或预热时透出以下字段
topn_quantity
Number
3000
前N件剩余库存
topn_total_count
Number
3000
前N件初始总库存
topn_end_time
String
1937297392332
前N件佣金结束时间
topn_start_time
String
1937297392332
前N件佣金开始时间
topn_rate
String
30
前N件佣金率
bybt_info
BybtInfoDTO
百亿补贴信息
bybt_brand_logo
String
//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
百亿补贴品牌logo
bybt_pic_url
String
//img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
百亿补贴白底图
bybt_item_tags
String[]
["https://gw.alicdn.com/tfs/TB1CvN50KH2gK0jSZJnXXaT1FXa-167-42.png?getAvatar=avatar","https://gw.alicdn.com/tfs/TB10rZqkCR26e4jSZFEXXbwuXXa-132-42.png?getAvatar=avatar"]
百亿补贴商品特征标签,eg.今日发货、晚发补偿、限购一件等
bybt_coupon_amount
String
10.00
百亿补贴专属券面额,仅限百亿补贴场景透出
bybt_show_price
String
100.00
百亿补贴页面实时价
bybt_lowest_price
String
200.00
全网对比参考价格
bybt_end_time
String
1559750399000
商品的百亿补贴开始时间
bybt_start_time
String
1559750399000
商品的百亿补贴结束时间
tt_sold_count
String
200+
商品入驻淘特后产生的所有销量量级,不特指某段具体时间
maifan_promotion
MaifanPromotionDTO
猫超买返卡信息
maifan_promotion_end_time
String
1559750399000
猫超买返卡活动结束时间
maifan_promotion_start_time
String
1559750399000
猫超买返卡活动开始时间
maifan_promotion_discount
String
200
猫超买返卡面额
maifan_promotion_condition
String
100
猫超买返卡总数,-1代表不限量,其他大于等于0的值为总数
cpa_reward_type
String
0 1
额外奖励活动类型,如果一个商品有多个奖励类型,返回结果使用空格分割,0=单单奖励,1=超级单单奖励
is_default
String
false
推荐信息-是否抄底
total_count
Number
100
商品总数-目前只有全品库商品查询有该字段

响应示例

{
    "tbk_dg_optimus_material_response":{
        "result_list":{
            "map_data":[
                {
                    "coupon_amount":40,
                    "small_images":{
                        "string":[
                            ""
                        ]
                    },
                    "shop_title":"魔黛娅内衣旗舰店",
                    "category_id":162201,
                    "coupon_start_fee":"69",
                    "item_id":556633720749,
                    "coupon_total_count":30000,
                    "user_type":1,
                    "zk_final_price":"79.9",
                    "coupon_remain_count":1936,
                    "commission_rate":"5.50",
                    "coupon_start_time":"2017-10-29",
                    "title":"毛呢阔腿裤港味复古女裤子秋冬九分裤萝卜裤显瘦高腰韩版2017新款",
                    "item_description":"",
                    "seller_id":745957850,
                    "volume":3837,
                    "coupon_end_time":"2017-11-02",
                    "coupon_click_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8",
                    "pict_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                    "click_url":"\/\/item.taobao.com\/item.htm?id=556633720749&scm=1007.16190.92234.0&pvid=41362290-fa0b-4252-b172-6afc9c00e2c8&app_pvid=0ab0fac715095507006577956e",
                    "stock":,
                    "sell_num":,
                    "total_stock":,
                    "oetime":"",
                    "ostime":"",
                    "jdd_num":,
                    "jdd_price":"",
                    "orig_price":"",
                    "level_one_category_name":"",
                    "level_one_category_id":,
                    "category_name":"",
                    "white_image":"https:\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                    "short_title":"sss",
                    "word_list":{
                        "word_map_data":[
                            {
                                "url":"https:\/\/uland.taobao.com\/semm\/tbxxxx",
                                "word":"孕妇装"
                            }
                        ]
                    },
                    "tmall_play_activity_info":"前n件x折",
                    "uv_sum_pre_sale":21,
                    "x_id":"uESS0mv8JvfJRMKlIgCD5At9VuHVBXoqBRihfQlo4ybLiKygRlqiN4eoxoZDfe38uSogWy6GB971jD2N8tLuuc",
                    "new_user_price":"1.99",
                    "coupon_info":"满299减30元",
                    "coupon_share_url":"\/\/uland.taobao.com\/coupon\/edetail?e=pR6YtnFKK%2B8GQASttHIRqcEWOmlidB03Pf45HLyCqA8dRAklSM5tEQ36hBQToU3M3MmLjFwLsqgZxcV7BPtHQDd2Naqom0e0&mt=1&app_pvid=0ab0fac715095507006577956e&ptl=app_pvid:0ab0fac715095507006577956e;tpp_pvid:41362290-fa0b-4252-b172-6afc9c00e2c8",
                    "nick":"秉迪数码专营店",
                    "reserve_price":"2.99",
                    "ju_online_end_time":"1559750399000",
                    "ju_online_start_time":"1559232000000",
                    "maochao_play_end_time":"1559750399000",
                    "maochao_play_start_time":"1559232000000",
                    "maochao_play_conditions":"2,3",
                    "maochao_play_discounts":"500,450",
                    "maochao_play_discount_type":"2",
                    "maochao_play_free_post_fee":"1",
                    "multi_coupon_zk_rate":"0.41234",
                    "price_after_multi_coupon":"9.9",
                    "multi_coupon_item_count":"3",
                    "lock_rate":"110",
                    "lock_rate_end_time":1567440000000,
                    "lock_rate_start_time":1567440000000,
                    "promotion_type":"1",
                    "promotion_info":"满2件打5折;满300减20",
                    "promotion_discount":"300",
                    "promotion_condition":"5",
                    "presale_discount_fee_text":"付定金立减5元",
                    "presale_tail_end_time":1567440000000,
                    "presale_tail_start_time":1567440000000,
                    "presale_end_time":1567440000000,
                    "presale_start_time":1567440000000,
                    "presale_deposit":"100",
                    "ysyl_tlj_use_start_time":"2019-11-10 21:59:59",
                    "ysyl_commission_rate":"2030(表示20.3%)",
                    "ysyl_tlj_send_time":"2019-11-10 21:59:59",
                    "ysyl_tlj_face":"0.6",
                    "ysyl_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1",
                    "ysyl_tlj_use_end_time":"2019-11-10 21:59:59",
                    "ju_play_end_time":1567440000000,
                    "ju_play_start_time":1567440000000,
                    "play_info":"玩法",
                    "tmall_play_activity_end_time":1567440000000,
                    "tmall_play_activity_start_time":1567440000000,
                    "ju_pre_show_end_time":"1581868800000",
                    "ju_pre_show_start_time":"1582300799000",
                    "favorites_info":{
                        "total_count":100,
                        "favorites_list":{
                            "favorites_detail":[
                                {
                                    "favorites_id":12334,
                                    "favorites_title":"测试选品库"
                                }
                            ]
                        }
                    },
                    "sale_price":"168",
                    "kuadian_promotion_info":"[\"每100减20\",\"每200减50\"]",
                    "sub_title":"吉品鲍鱼 关西参",
                    "jhs_price_usp_list":"满200减10",
                    "tqg_online_end_time":"1581868800000",
                    "tqg_online_start_time":"1581868800000",
                    "tqg_sold_count":20,
                    "tqg_total_count":50,
                    "superior_brand":"1",
                    "is_brand_flash_sale":"1",
                    "hot_flag":"1",
                    "topn_info":{
                        "topn_quantity":3000,
                        "topn_total_count":3000,
                        "topn_end_time":"1937297392332",
                        "topn_start_time":"1937297392332",
                        "topn_rate":"30"
                    },
                    "bybt_info":{
                        "bybt_brand_logo":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                        "bybt_pic_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/745957850\/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg",
                        "bybt_item_tags":{
                            "string":[
                                "[\"https:\/\/gw.alicdn.com\/tfs\/TB1CvN50KH2gK0jSZJnXXaT1FXa-167-42.png?getAvatar=avatar\"",
                                "\"https:\/\/gw.alicdn.com\/tfs\/TB10rZqkCR26e4jSZFEXXbwuXXa-132-42.png?getAvatar=avatar\"]"
                            ]
                        },
                        "bybt_coupon_amount":"10.00",
                        "bybt_show_price":"100.00",
                        "bybt_lowest_price":"200.00",
                        "bybt_end_time":"1559750399000",
                        "bybt_start_time":"1559750399000"
                    },
                    "tt_sold_count":"200+",
                    "maifan_promotion":{
                        "maifan_promotion_end_time":"1559750399000",
                        "maifan_promotion_start_time":"1559750399000",
                        "maifan_promotion_discount":"200",
                        "maifan_promotion_condition":"100"
                    },
                    "cpa_reward_type":"0 1"
                }
            ]
        },
        "is_default":"false",
        "total_count":100
    }
}
   

异常示例

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}
   

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter 参数填写不正确 参数填写不正确
602 调用次数超出
603 未找到用户或该用户未注册 请输入正确的appkey
604 未知参数错误 建议加入重试机制
404 参数传入错误_未知参数 检查参数类型是否正确