淘宝客高级API
淘宝客物料搜索API接口【升级版】
需要授权
2397人使用

支持入参对应的“推广位”和官方提供的“物料id”,获取指定物料信息和推广链接

接口地址: http://api.tbk.dingdanxia.com/tbk/super_search_material 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

q

String

女装

商品筛选-查询词;注意:使用标题精准搜索时,当搜索结果只有一个商品时则出参不再提供商品推广链接和商品id字段,若搜索结果仍有多个商品,则正常出参,q参数也不再支持入参淘宝复制的商品链接进行搜索查询,仅支持入参含新商品id的淘宝客推广链接如uland链接进行搜索查询(场景id使用说明参考《淘宝客新商品ID升级》白皮书:https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud)

cat

String

16,18

商品筛选-后台类目ID。用,分割,最大10个

pid

String

mm_xx_xx_xx

推广位id

start_dsr

Number

10

商品筛选-店铺dsr评分。筛选大于等于当前设置的店铺dsr评分的商品0-50000之间

page_size

Number

20

页大小,默认20,1~100

page_no

Number

1

第几页,默认:1

end_tk_rate

Number

1234

商品筛选-淘客收入比率上限(商品佣金比率+补贴比率)。如:1234表示12.34%

start_tk_rate

Number

1234

商品筛选-淘客收入比率下限(商品佣金比率+补贴比率)。如:1234表示12.34%

end_price

String

10

商品筛选-预估到手价范围上限。单位:元

start_price

String

10

商品筛选-预估到手价范围下限。单位:元

is_overseas

Boolean

false

商品筛选-是否海外商品。true表示属于海外商品,false或不设置表示不限

is_tmall

Boolean

false

商品筛选-是否天猫商品。true表示属于天猫商品,false或不设置表示不限

sort

String

tk_rate_des

排序_des(降序),排序_asc(升序),销量(total_sales),淘客收入比率(tk_rate), 累计推广量(tk_total_sales),总支出佣金(tk_total_commi),预估到价格(final_promotion_price),匹配分(match)

itemloc

String

杭州

商品筛选-所在地

material_id

Number

80309

物料id,不传时默认物料material_id=80309;如果直接对消费者投放,可使用官方个性化算法优化的搜索物料material_id=17004(注意:若物料id=17004没查询到结果则出系统默认物料id=80309的查询结果)

has_coupon

Boolean

false

优惠券筛选-是否有优惠券。true表示该商品有优惠券,false或不设置表示不限

ip

String

ip参数影响邮费获取,如果不传或者传入不准确,邮费无法精准提供

npx_level

Number

商品筛选-牛皮癣程度。取值:1不限,2无,3轻微

include_rfd_rate

Boolean

商品筛选-退款率是否低于行业均值。True表示大于等于,false或不设置表示不限

include_good_rate

Boolean

商品筛选-好评率是否高于行业均值。True表示大于等于,false或不设置表示不限

include_pay_rate_30

Boolean

商品筛选-成交转化是否高于行业均值。True表示大于等于,false或不设置表示不限

need_prepay

Boolean

商品筛选-是否加入消费者保障。true表示加入,false或不设置表示不限

need_free_shipment

Boolean

商品筛选-是否包邮。true表示包邮,false或不设置表示不限

relation_id

String

渠道关系ID,仅适用于渠道推广场景

get_topn_rate

Number

是否获取前N件佣金信息,0否,1是,其他值否

返回参数说明

标记

类型

例子

说明

item_id

String

qeqscd1231-uqwenqe

商品信息-淘宝客新商品id;使用说明参考《淘宝客新商品ID升级》白皮书:https://www.yuque.com/taobaolianmengguanfangxiaoer/zmig94/tfyt0pahmlpzu2ud

price_promotion_info

PromotionInfoMapData

价格促销信息

final_promotion_path_list

FinalPromotionPathMapData[]

到手价优惠路径列表

predict_rounding_up_price

String

促销信息-预估凑单价(元)。预估凑单叠加优惠后的商品单价

predict_rounding_up_price_desc

String

促销信息-凑单价说明,描述凑单价的实现说明。如 “可凑单”或“需买X件”

more_promotion_list

MorePromotionMapData[]

更多活动优惠

promotion_title

String

预热优惠名称,如“商品券”、“跨店满减”、“单品直降”等

promotion_desc

String

预热优惠利益点文案,如“1件7.92折”、“每200减20”等

promotion_start_time

String

优惠开始时间

promotion_end_time

String

优惠结束时间

promotion_id

String

优惠ID

reserve_price

String

商品信息-一口价通常显示为划线价

zk_final_price

String

促销信息-销售价格,无促销时等于一口价,有促销时为促销价。若属于预售商品,付定金时间内,在线售卖价=预售价

final_promotion_price

String

促销信息-预估到手价(元)。若属于预售商品,付定金时间内,预估到手价价=定金+尾款的预估到手价

future_activity_promotion_price

String

预热预估到手价(元)

future_activity_promotion_path_list

FutureActivityPromotionPathMapData[]

预热到手价优惠路径列表

promotion_tag_list

PromotionTagMapData[]

标签信息列表

publish_info

PublishInfo

淘客推广信息

item_basic_info

BasicMapData

商品基础信息

title

String

商品信息-商品标题

short_title

String

商品信息-商品短标题

pict_url

String

商品信息-商品主图

white_image

String

商品信息-商品白底图

level_one_category_id

Number

商品信息-一级类目ID

category_id

Number

商品信息-叶子类目id

category_name

String

商品信息-叶子类目名称

seller_id

Number

店铺信息-卖家id

user_type

Number

店铺信息-卖家类型,0表示淘宝,1表示天猫,3表示特价版

shop_title

String

店铺信息-店铺名称

volume

Number

商品信息-30天销量;数据统计截止昨日非实时更新

sub_title

String

商品信息-商品子标题

brand_name

String

商品信息-品牌名称

level_one_category_name

String

商品信息-一级类目名称

tk_total_sales

String

商品信息-淘客30天推广量

provcity

String

商品信息-宝贝所在地

small_images

String[]

商品信息-商品小图列表

tmall_rank_info

TmallRankInfo

天猫榜单信息

presale_info

PresaleInfo

预售信息

presale_start_time

Number

预售商品-付定金开始时间(毫秒)

presale_end_time

Number

预售商品-付定金结束时间(毫秒)

presale_tail_start_time

Number

预售商品-付尾款开始时间(毫秒)

presale_tail_end_time

Number

预售商品-付尾款结束时间(毫秒)

presale_deposit

String

预售商品-定金(元)

presale_discount_fee_text

String

预售商品-优惠信息

scope_info

ScopeInfo

商品库范围信息

mgc_info

MgcInfo

线报内容

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "total_results": 157857,
    "data": [
        {
            "item_basic_info": {
                "brand_name": "VANCAMEL/西域骆驼",
                "category_id": 50010158,
                "category_name": "夹克",
                "level_one_category_id": 30,
                "level_one_category_name": "男装",
                "pict_url": "https://img.alicdn.com/bao/uploaded/i2/2215909379502/O1CN018CZyF92K3yKZybcJE_!!2215909379502.jpg",
                "provcity": "福建 泉州",
                "seller_id": 4800944021037088392,
                "shop_title": "西域骆驼服饰品牌店",
                "short_title": "",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/i4/2215909379502/O1CN01xRZ3Q82K3yKh3Ad80_!!2215909379502.jpg",
                        "https://img.alicdn.com/i3/2215909379502/O1CN01VQqRm32K3yL1E282f_!!2215909379502.png",
                        "https://img.alicdn.com/i4/2215909379502/O1CN01Of2vK62K3yKeIfljB_!!2215909379502.jpg",
                        "https://img.alicdn.com/i2/2215909379502/O1CN01VopZT12K3yKfp3LI1_!!2215909379502.jpg"
                    ]
                },
                "sub_title": "",
                "title": "西域骆驼新款户外登山旅游情侣美式冲锋衣防风保暖运动休闲外套",
                "tk_total_sales": "50",
                "user_type": 0,
                "volume": 500,
                "white_image": ""
            },
            "item_id": "wWGxrbcgtDoN83nYqI39Nsbtd-9OG5WdfOXewBjYbhrQ",
            "presale_info": {
                "presale_deposit": ""
            },
            "price_promotion_info": {
                "final_promotion_path_list": {
                    "final_promotion_path_map_data": [
                        {
                            "promotion_desc": "满500.01减500",
                            "promotion_end_time": "1706716799000",
                            "promotion_fee": "500",
                            "promotion_id": "0857973e0d6d47499f33076181f55726",
                            "promotion_start_time": "1705161600000",
                            "promotion_title": "商品券"
                        }
                    ]
                },
                "final_promotion_price": "69.9",
                "promotion_tag_list": {
                    "promotion_tag_map_data": [
                        {
                            "tag_name": "500元"
                        },
                        {
                            "tag_name": "包邮"
                        }
                    ]
                },
                "reserve_price": "659.90",
                "zk_final_price": "569.9"
            },
            "publish_info": {
                "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3D4L8pFbTA4LFw4vFB6t2Z2ueEDrYVVa64lwnaF1WLQxlyINtkUhsv0HAY4dRTeSoWMo80ymJwxZ%2BXX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYcZfoTD5jAPjoRNfHM0BOv3OoJTgnJNbsutj%2FQQREY2LgTybYfFtzwyoWu%2F2FmcMu9RITYVE%2Blah7jfuM1B8ZZ6aXm0XFZ13crkDp8AHWkMmJit67cAGVFU5FUZ5U0OvsfN2vv8Ma0EJoAzcQG3HvinGJe8N%2FwNpGw%3D%3D&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f09%4001%40eyJmbG9vcklkIjo4MDMwOX0ie",
                "commission_type": "MKT",
                "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=13WoZfVvC40NfLV8niU3R0P2gVhX2vi1lyRrA15W%2BoDSWGL28aqHjTvgB0zL82QpDKTrpn6NPbOdrkbOK0AiFiqrfGF0I709y5FOJP2gSFVlXymvoVZzQwNKjzwrr%2FgwqWHD%2FRBKBEOYwek19h0d0JLAbAIYNA39vQtn7YCHiI5oSkAynW0ilVACjPwtVWdsB%2BovwgEXpN6rP8R82Zr%2BoDeYlSGprshDdpqO%2F03DLNdfnkXucjRT5o4wYX6q0KwKcKyGdLFfF%2BPiINPY4XmmYKJ7%2BkHL3AEW&app_pvid=59590_33.7.114.50_58196_1706237865566&ptl=floorId:80309;app_pvid:59590_33.7.114.50_58196_1706237865566;tpp_pvid:ef0d09ae-becf-46f2-9a2f-358d17adb3d4&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f09%4001%40eyJmbG9vcklkIjo4MDMwOX0ie",
                "income_info": {
                    "commission_amount": "6.29",
                    "commission_rate": "900",
                    "subsidy_amount": "0",
                    "subsidy_rate": "0"
                },
                "income_rate": "9.0"
            },
            "scope_info": {
                "superior_brand": 0
            }
        },
        {
            "item_basic_info": {
                "brand_name": "",
                "category_id": 50008899,
                "category_name": "羽绒服",
                "level_one_category_id": 16,
                "level_one_category_name": "女装/女士精品",
                "pict_url": "https://img.alicdn.com/bao/uploaded/i2/733734199/O1CN01bL7Mt91gtBxOSuhLK_!!733734199.jpg",
                "provcity": "浙江 嘉兴",
                "seller_id": 4829195963715435163,
                "shop_title": "晴雨雪QYX",
                "short_title": "",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/i4/733734199/O1CN01rATucT1gtBy0HnE7d_!!733734199.jpg",
                        "https://img.alicdn.com/i3/733734199/O1CN01c6qpJQ1gtBxWq6dcm_!!733734199.jpg",
                        "https://img.alicdn.com/i1/733734199/O1CN01xncX8w1gtBxY0sgLA_!!733734199.jpg",
                        "https://img.alicdn.com/i4/733734199/O1CN01XztdSA1gtBy1PZhyO_!!733734199.jpg"
                    ]
                },
                "sub_title": "",
                "title": "晴雨雪圆领羽绒服女轻薄短款韩版菱格宽松小个子白鸭绒保暖外套冬",
                "tk_total_sales": "100",
                "user_type": 0,
                "volume": 500,
                "white_image": ""
            },
            "item_id": "bAozgbugto8jKz6GBUzMRIQt6-ZWQpy8tA9Wp64NKuO2",
            "presale_info": {
                "presale_deposit": ""
            },
            "price_promotion_info": {
                "final_promotion_path_list": {
                    "final_promotion_path_map_data": [
                        {
                            "promotion_desc": "满300减170",
                            "promotion_end_time": "1706716799000",
                            "promotion_fee": "170",
                            "promotion_id": "5c8a1147090b453b88adbbbc967d9311",
                            "promotion_start_time": "1705492800000",
                            "promotion_title": "商品券"
                        },
                        {
                            "promotion_desc": "每200减30",
                            "promotion_end_time": "1706716799000",
                            "promotion_fee": "30",
                            "promotion_id": "76011336300-20000-3000",
                            "promotion_start_time": "1705492800000",
                            "promotion_title": "跨店满减"
                        }
                    ]
                },
                "final_promotion_price": "138",
                "predict_rounding_up_price": "117.3",
                "predict_rounding_up_price_desc": "需凑单",
                "promotion_tag_list": {
                    "promotion_tag_map_data": [
                        {
                            "tag_name": "170元"
                        },
                        {
                            "tag_name": "每200减30"
                        },
                        {
                            "tag_name": "包邮"
                        }
                    ]
                },
                "reserve_price": "588.00",
                "zk_final_price": "338"
            },
            "publish_info": {
                "click_url": "//s.click.taobao.com/t?e=m%3D2%26s%3DfEWvFfcI5fRw4vFB6t2Z2ueEDrYVVa64lwnaF1WLQxlyINtkUhsv0HAY4dRTeSoWMo80ymJwxZ%2BXX8jSMzRlNjF3Y%2BbYt%2FaMJpZDSlCQtzzY06PVtVSdYcZfoTD5jAPjeCRicXXmXIyK7cYgECNa6T9GLwZIH0cp4tBGWqWljMeq3kLM0PSCBvigSS2RF98cmvn0QGfLkNAjtbb1lAkfqhIjP5Uhv22UFGhBLhApIMqkQNbHa5C5fZodOm2iw0gExgxdTc00KD8%3D&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f0a%4001%40eyJmbG9vcklkIjo4MDMwOX0ie",
                "commission_type": "MKT",
                "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=OcoluD857EMNfLV8niU3R0P2gVhX2vi111HhX5jcz4gO01iuyTF2TpOoeikG%2FZiD0Zx9mrIAJBmaIgIEbKKFXQpEfeXFu5Udy5FOJP2gSFVlXymvoVZzQyLd7RR5rzEm0tk3gl2YD1iYwek19h0d0JLAbAIYNA39vQtn7YCHiI5oSkAynW0ilVACjPwtVWdsB%2BovwgEXpN6aEUdoZkPltiz0ozPI%2BSxyyBV2ck2ykA8hcf5Wqw0N%2BRRejvUk6PEIO5pjFiQyOfUZao0HO%2FvX0w%3D%3D&app_pvid=59590_33.7.114.50_58196_1706237865566&ptl=floorId:80309;app_pvid:59590_33.7.114.50_58196_1706237865566;tpp_pvid:ef0d09ae-becf-46f2-9a2f-358d17adb3d4&union_lens=lensId%3AMAPI%401706237865%4021077232_1258_18d43b3aeb5_8f0a%4001%40eyJmbG9vcklkIjo4MDMwOX0ie",
                "income_info": {
                    "commission_amount": "2.48",
                    "commission_rate": "180",
                    "subsidy_amount": "0",
                    "subsidy_rate": "0"
                },
                "income_rate": "1.8"
            },
            "scope_info": {
                "superior_brand": 0
            }
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。