YesApi 接口文档

08904 淘宝客-公用-淘宝客商品详情查询(简版)

接口路径(新)：http://hn216.api.okayapi.com/api/App/Taobao_TaobaoTBK/ItemInfoGet

接口路径(旧)：http://hn216.api.okayapi.com/?s=App.Taobao_TaobaoTBK.ItemInfoGet

接口描述： 淘宝客商品详情查询（简版）。依赖于API文档/淘宝客API/taobao.tbk.item.info.get，使用前请先进行小白开放平台»设置»淘宝开放平台配置。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
num_iids字符串必须商品ID串，用,分割，最大40个，如：123,456
platform整型可选1最小：1；最大：2链接形式：1：PC，2：无线，默认：１
ip字符串可选ip地址，影响邮费获取，如果不传或者传入不准确，邮费无法精准提供。未传时自动以客户端IP为准。

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.Taobao_TaobaoTBK.ItemInfoGet2&num_iids=607824758174&platform=1&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "results": {
            "n_tbk_item": {
                "cat_leaf_name": "T恤",
                "cat_name": "女装/女士精品",
                "item_url": "https://item.taobao.com/item.htm?id=607824758174",
                "material_lib_type": "1",
                "nick": "锋灵女装魔衣柜",
                "num_iid": "607824758174",
                "pict_url": "https://img.alicdn.com/bao/uploaded/i1/3364590938/O1CN01FLfeYf1Ine5BTwvOk_!!3364590938.jpg",
                "presale_deposit": "0",
                "presale_end_time": "0",
                "presale_start_time": "0",
                "presale_tail_end_time": "0",
                "presale_tail_start_time": "0",
                "provcity": "广东 广州",
                "reserve_price": "79",
                "seller_id": "3364590938",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/i4/3364590938/O1CN0149jQAk1Ine55YCutK_!!3364590938.jpg",
                    "https://img.alicdn.com/i4/3364590938/O1CN01nTZL1Y1Ine57NRrFc_!!3364590938.jpg",
                    "https://img.alicdn.com/i3/3364590938/O1CN01JKhtW41Ine5525mgB_!!3364590938.jpg",
                    "https://img.alicdn.com/i1/3364590938/O1CN01yp2YMa1Ine56YgWRH_!!3364590938.jpg"
                        ]
                },
                "title": "2019秋冬t恤女上衣女装春装新款加绒加厚打底衫女长袖雪纺衬衫女",
                "tmall_play_activity_end_time": "0",
                "tmall_play_activity_start_time": "0",
                "user_type": "0",
                "volume": "3",
                "zk_final_price": "69"
            }
        },
        "request_id": "ezt4iy54nfgt"
    },
    "msg": "V1.3.9 小白开放接口 App.Taobao_TaobaoTBK.ItemInfoGet"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

8902 淘宝客-公用-淘口令生成

接口路径(新)：http://hn216.api.okayapi.com/api/App/Taobao_TaobaoTBK/TpwdCreate

接口路径(旧)：http://hn216.api.okayapi.com/?s=App.Taobao_TaobaoTBK.TpwdCreate

接口描述： 提供淘客生成淘口令接口，淘客提交口令内容、logo、url等参数，生成淘口令关键key如：￥SADadW￥，后续进行文案包装组装用于传播。依赖于API文档/淘宝客API/taobao.tbk.tpwd.create，使用前请先进行小白开放平台»设置»淘宝开放平台配置。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
user_id字符串可选生成口令的淘宝用户ID，如：123
text字符串必须最小：5口令弹框内容，长度大于5个字符
url字符串必须口令跳转目标页，如：https://uland.taobao.com/
logo字符串可选口令弹框logoURL
ext字符串可选扩展字段JSON格式，如：{}

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.Taobao_TaobaoTBK.TpwdCreate&text=小白测试-华为手机热卖&url=https://uland.taobao.com/&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "data": {
            "model": "￥BhMAYBQIV2P￥"
        },
        "request_id": "f87qnbcrdij1"
    },
    "msg": "V1.3.8 小白开放接口 App.Taobao_TaobaoTBK.TpwdCreate"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

8903 淘宝客-公用-商品关联推荐

接口路径(新)：http://hn216.api.okayapi.com/api/App/Taobao_TaobaoTBK/ItemRecommendGet

接口路径(旧)：http://hn216.api.okayapi.com/?s=App.Taobao_TaobaoTBK.ItemRecommendGet

接口描述： 淘宝客商品关联推荐查询。依赖于API文档/淘宝客API/taobao.tbk.item.recommend.get，使用前请先进行小白开放平台»设置»淘宝开放平台配置。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
num_iid整型必须商品Id
fields字符串可选num_iid,title,pict_url,small_images,reserve_price,zk_final_price,user_type,provcity,item_url,nick,seller_id,volume需返回的字段列表
count整型可选20最大：40返回数量，默认20，最大值40
platform整型可选1最小：1；最大：2链接形式：1：PC，2：无线，默认：１

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.Taobao_TaobaoTBK.ItemRecommendGet&num_iid=558600578230&fields=num_iid,title,pict_url,small_images,reserve_price,zk_final_price,user_type,provcity,item_url,nick,seller_id,volume&count=3&platform=1&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "results": {
            "n_tbk_item": [
            {
                "item_url": "http://item.taobao.com/item.htm?id=582886688469",
                "nick": "fakeface旗舰店",
                "num_iid": "582886688469",
                "pict_url": "https://img.alicdn.com/tfscom/i1/1706206619/O1CN01eL14BS1ylY8KtPvB1_!!1706206619-0-pixelsss.jpg",
                "provcity": "广东 深圳",
                "reserve_price": "25.00",
                "seller_id": "1706206619",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/tfscom/i4/1706206619/O1CN01Uqod2i1ylY7ZPzCMy_!!1706206619.jpg",
                    "https://img.alicdn.com/tfscom/i2/1706206619/O1CN01SW7zgw1ylY2mfuN6W_!!1706206619.jpg",
                    "https://img.alicdn.com/tfscom/i3/1706206619/O1CN01hDpZjp1ylY2YdCYEP_!!1706206619.jpg",
                    "https://img.alicdn.com/tfscom/i2/1706206619/O1CN011ylY12qHW9CEAvY_!!1706206619.jpg"
                        ]
                },
                "title": "Fakeface卸妆棉卸妆用脸部清洁湿敷厚款双面纯棉化妆棉女200片",
                "user_type": "1",
                "volume": "17561",
                "zk_final_price": "9.90"
            },
            {
                "item_url": "http://item.taobao.com/item.htm?id=583405411993",
                "nick": "健美创研旗舰店",
                "num_iid": "583405411993",
                "pict_url": "https://img.alicdn.com/tfscom/i1/2258006982/O1CN01ewXpN221Rnu4otDIy_!!0-item_pic.jpg",
                "provcity": "浙江 金华",
                "reserve_price": "48.00",
                "seller_id": "2258006982",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/tfscom/i3/2258006982/O1CN01hAdWsy21Rnu2D9jDg_!!2258006982.jpg",
                    "https://img.alicdn.com/tfscom/i4/2258006982/O1CN01UZsxHr21RnqxQddsF_!!2258006982.jpg",
                    "https://img.alicdn.com/tfscom/i2/2258006982/O1CN01FjmnA221RnsIlYUEG_!!2258006982.jpg",
                    "https://img.alicdn.com/tfscom/i2/2258006982/O1CN01azVLJt21Rnqmd6wuP_!!2258006982.jpg"
                        ]
                },
                "title": "健美创研洗脸巾女纯棉一次性洗面擦脸洁面巾美容专用卸妆棉化妆棉",
                "user_type": "1",
                "volume": "307222",
                "zk_final_price": "8.10"
            },
            {
                "item_url": "http://item.taobao.com/item.htm?id=558522738825",
                "nick": "acare大陆直营店",
                "num_iid": "558522738825",
                "pict_url": "https://img.alicdn.com/tfscom/i1/1788211453/TB2uT0VXkZmBKNjSZPiXXXFNVXa_!!1788211453.jpg",
                "provcity": "北京",
                "reserve_price": "22.94",
                "seller_id": "1788211453",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/tfscom/i3/1788211453/O1CN01TlwpW31MbVzyoyhfm_!!1788211453.jpg",
                    "https://img.alicdn.com/tfscom/i3/1788211453/O1CN01xvdgoE1MbVyKWjIH4_!!1788211453.jpg",
                    "https://img.alicdn.com/tfscom/i1/1788211453/O1CN01PMqjYh1MbVyNdOLii_!!1788211453.jpg",
                    "https://img.alicdn.com/tfscom/i3/1788211453/O1CN01YM5lEP1MbVyFzPoWh_!!1788211453.jpg"
                        ]
                },
                "title": "化妆棉盒装1000片纯棉卸妆棉脸部湿敷专用爽肤水厚薄款单层一次性",
                "user_type": "0",
                "volume": "1318",
                "zk_final_price": "8.99"
            }
            ]
        },
        "request_id": "ro291pqoztem"
    },
    "msg": "V1.3.8 小白开放接口 App.Taobao_TaobaoTBK.ItemRecommendGet"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

8905 淘宝客-推广者-图文内容输出

接口路径(新)：http://hn216.api.okayapi.com/api/App/Taobao_TaobaoTBK/ContentGet

接口路径(旧)：http://hn216.api.okayapi.com/?s=App.Taobao_TaobaoTBK.ContentGet

接口描述： 淘客媒体内容输出。依赖于API文档/淘宝客API/taobao.tbk.content.get，使用前请先进行小白开放平台»设置»淘宝开放平台配置。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
adzone_id字符串必须推广位，如：123。
如何找到推广位ID？
1.进入阿里妈妈后台>推广管理>推广位管理；2.在推广位管理 列表页 找到 PID，最后一个下划线后面的数字就是 推广位ID；一般PID的格式: mm_xxx_xxx_xxx 最后一个下划线就是推广位ID。例如对于推广位：mm_762460132_1145000489_109857350393，其推广位ID是：109857350393
type字符串可选1内容类型，1:图文、2: 图集、3: 短视频
before_timestamp字符串可选表示取这个时间点以前的数据，以毫秒为单位（出参中的last_timestamp是指本次返回的内容中最早一条的数据，下一次作为before_timestamp传过来，即可实现翻页）
count整型可选10表示期望获取条数
cid字符串可选类目
image_width字符串可选图片宽度，如：300
image_height字符串可选图片高度，如：300
content_set字符串可选默认可不传,内容库类型:1 优质内容

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.Taobao_TaobaoTBK.ContentGet&adzone_id=109857350393&type=1&count=2&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "result": {
            "data": {
                "contents": {
                    "map_data": [
                    {
                        "author_avatar": "https://wwc.alicdn.com/avatar/getAvatar.do?width=160&height=160&type=sns&userId=3313869525",
                        "author_id": "3313869525",
                        "author_nick": "陈列师Asoka",
                        "clink": "//ifeeds.taobao.com/article.html?contentId=9562031&publishTime=1576072117000&pid=mm_762460132_1145000489_109857350393&source=default&union_lens=lensId:m_0b08381d_0b84_16ef53a634e_b155;traffic_flag:lm",
                        "content_categories": "[鞋包]",
                        "content_id": "9562031",
                        "images": {
                            "string": [
                                "https://ossgw.alicdn.com/union-content-cdn/055679c0db943124be7860733dee45d6.jpg?x-oss-process=image/resize,m_fill,w_300,h_300,limit_0",
                            "https://ossgw.alicdn.com/union-content-cdn/5f166a22da54388f9e5e4d227197fd5c.jpg?x-oss-process=image/resize,m_fill,w_300,h_300,limit_0",
                            "https://ossgw.alicdn.com/union-content-cdn/e26c5e32f0d23c35b3357b171f46a04b.jpg?x-oss-process=image/resize,m_fill,w_300,h_300,limit_0"
                                ]
                        },
                        "img_count": "3",
                        "item_ids": {
                            "number": "561472127984"
                        },
                        "publish_time": "1576072117000",
                        "score": "57",
                        "summary": "这个世界不是缺少美，而是缺少一双发现美的眼睛，这个世界不缺少好鞋，缺少的是认同它的主人。下面小编就为大家测评一款鞋子，带你发现它的美！这个世界不是缺少美，而是缺少一双发现美的眼睛，这个世界不缺少好鞋，缺少的是认同它的主人。下面小编就为大家测评一款鞋子，带你发现它的美！——鞋型——这款鞋子的鞋型是经典的 船型设计，是今年最流行的款式。微微翘起的鞋头，能够有效防止雨水打湿鞋子。——鞋后跟——这款鞋子的鞋后跟，是破跟的。鞋子从中部向后微微增高，有一种隐形的增高的功能。默默无闻中提升你的高度，增加你的气质美！——鞋内里——这款鞋子的鞋内里，是两层厚厚的猪皮材质，穿起来很柔软舒适，鞋子的鞋垫非常平坦，厚厚的材质有效的平整",
                        "tags": "[\"增高\", \"外穿\", \"女鞋\", \"经典\", \"包头半拖鞋\", \"平底凉鞋\", \"真皮女鞋\", \"拖鞋\", \"美的\", \"时尚凉拖\", \"夏季\"]",
                        "title": "用你能发现美的眼睛，看到这双鞋子的美！",
                        "type": "1",
                        "ui_style": "3",
                        "update_time": "1576072122000"
                    },
                    {
                        "author_avatar": "https://wwc.alicdn.com/avatar/getAvatar.do?width=160&height=160&type=sns&userId=3288428062",
                        "author_id": "3288428062",
                        "author_nick": "潮范儿",
                        "clink": "//ifeeds.tmall.com/article.html?contentId=9562033&publishTime=1576072118000&pid=mm_762460132_1145000489_109857350393&source=default&union_lens=lensId:m_0b08381d_0b84_16ef53a634e_b157;traffic_flag:lm",
                        "content_categories": "[男装]",
                        "content_id": "9562033",
                        "images": {
                            "string": [
                                "https://ossgw.alicdn.com/union-content-cdn/351de1be00893c7da33c9e3ee513b23a.png?x-oss-process=image/resize,m_fill,w_300,h_300,limit_0",
                            "https://ossgw.alicdn.com/union-content-cdn/c686023e4b573b008905dea21258e3b7.png?x-oss-process=image/resize,m_fill,w_300,h_300,limit_0",
                            "https://ossgw.alicdn.com/union-content-cdn/b4a65168a27231459dc3dacef86ace32.jpg?x-oss-process=image/resize,m_fill,w_300,h_300,limit_0"
                                ]
                        },
                        "img_count": "5",
                        "item_ids": {
                            "number": [
                                "594655534512",
                            "605589355374"
                                ]
                        },
                        "publish_time": "1576072118000",
                        "score": "58",
                        "summary": "直男们不会搭配怎么办？没关系，教你两个小技巧，让你轻松变身时尚型男。在大多数人的眼中，钢铁直男的穿搭总是遭人嫌弃，他们经常穿着千篇一律的T恤或者格子衬衫，再加上一个大裤衩和拖鞋，到了冬季，更是一件黑色羽绒服就解决所有搭配，经常看起来油腻腻的，简直惨不忍睹。 直男们不会搭配怎么办？是时候要改造自己了，不管从衣着还是配饰都需要的彻底的打造一番，这样才会让你改变直男形象。今天就跟大家分享一些变身型男的穿搭指南，让你变得更加帅气有型。 — ❶ — 学会叠穿技巧，增加穿搭层次感  很多直男穿搭之所以不美观，就是因为你不会搭配，卫衣，衬衫，羽绒服，牛仔裤，运动鞋等这些基础单品都有了，要怎么搭配才能提升自己的时尚感呢?可以",
                        "tags": "[\"男装\", \"卫衣\", \"外穿\", \"罗马\", \"毛衣\", \"羽绒服\", \"黑色羽绒服\", \"拖鞋\", \"牛仔裤\", \"缝线\", \"衬衫\", \"鸭舌帽\"]",
                        "title": "直男穿搭指南，两招让你变时尚型男",
                        "type": "1",
                        "ui_style": "3",
                        "update_time": "1576072122000"
                    }
                    ]
                },
                "count": "2",
                "last_timestamp": "1576072117000"
            }
        },
        "request_id": "4u6urqxobpyz"
    },
    "msg": "V1.3.13 小白开放接口 App.Taobao_TaobaoTBK.ContentGet"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

8906 淘宝客-推广者-物料搜索

接口路径(新)：http://hn216.api.okayapi.com/api/App/Taobao_TaobaoTBK/MaterialOptional

接口路径(旧)：http://hn216.api.okayapi.com/?s=App.Taobao_TaobaoTBK.MaterialOptional

接口描述： 通用物料搜索API（导购）。依赖于API文档/淘宝客API/taobao.tbk.dg.material.optional，使用前请先进行小白开放平台»设置»淘宝开放平台配置。在线演示请访问：开发者必备零食。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
adzone_id字符串必须推广位，mm_xxx_xxx_12345678三段式的最后一段数字，如：123。
如何找到推广位ID？
1.进入阿里妈妈后台>推广管理>推广位管理；2.在推广位管理 列表页 找到 PID，最后一个下划线后面的数字就是 推广位ID；一般PID的格式: mm_xxx_xxx_xxx 最后一个下划线就是推广位ID。例如对于推广位：mm_762460132_1145000489_109857350393，其推广位ID是：109857350393
q字符串可选商品筛选-查询词
page_no字符串可选页码从1开始
page_size整型可选50页数，最大1000

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

HTTP通用示例 
请求：
{你的接口域名}/?s=App.Taobao_TaobaoTBK.MaterialOptional&adzone_id=109856150478&q=办公零食&app_key={你的app_key}&sign={动态签名}

返回：
{
    "ret": 200,
    "data": {
        "result_list": {
            "map_data": [
            {
                "category_id": "50010535",
                "category_name": "膨化食品",
                "commission_rate": "1200",
                "commission_type": "MKT",
                "coupon_amount": "10",
                "coupon_end_time": "2019-12-11",
                "coupon_id": "ac67637c5849492d8b7c4bc617b29842",
                "coupon_info": "满24.00元减10元",
                "coupon_remain_count": "99951",
                "coupon_share_url": "//uland.taobao.com/coupon/edetail?e=d5aBXBtzNVUNfLV8niU3RwXoB%2BDaBK5LQS0Flu%2FfbSp4QsdWMikAalrisGmre1Id522H2TxuqpK633e15CyRC4UpsKtpxCuLSfYLHfEjG8tdvWkO4mdSTvgBM2nGyWCJxDqyJAdxa%2FJRGqF5vmpvyEGMB05DMYU0LW0cp9rhR3NWbgkOnM3%2FTe5aRxmP7KyPsYDW%2FeIv9KTV8CKoRNyLdufVqn5cxLzlzWuH7hCAmylMDQVG07AK7A%3D%3D&&app_pvid=59590_11.132.118.138_473_1576074362441&ptl=floorId:2836;app_pvid:59590_11.132.118.138_473_1576074362441;tpp_pvid:100_11.178.158.87_18370_7811576074362444704&xId=FasZRPUTmiALycx302MHk7Ovzf1NgddC7ghE1KCbDX8VMz4wFBhFUA9IryW8j0ObebqA5oclKgSCC9gXIZtoOS&union_lens=lensId%3A0b84768a_af81_16ef55a3ea8_cb21",
                "coupon_start_fee": "24.00",
                "coupon_start_time": "2019-12-10",
                "coupon_total_count": "100000",
                "include_dxjh": "true",
                "include_mkt": "true",
                "info_dxjh": "{}",
                "item_description": "厂家直发 日期新鲜 鲜虾肉片",
                "item_id": "603951222167",
                "item_url": "https://detail.tmall.com/item.htm?id=603951222167",
                "level_one_category_id": "50002766",
                "level_one_category_name": "零食/坚果/特产",
                "nick": "喜盈盈旗舰店",
                "num_iid": "603951222167",
                "pict_url": "https://img.alicdn.com/bao/uploaded/i4/2378881695/O1CN01ETmEP91OOLuLilRyG_!!0-item_pic.jpg",
                "provcity": "河南 漯河",
                "real_post_fee": "0.00",
                "reserve_price": "45",
                "seller_id": "2378881695",
                "shop_dsr": "48647",
                "shop_title": "喜盈盈旗舰店",
                "short_title": "喜盈盈一口虾虾酥条办公室下午茶*",
                "small_images": {
                    "string": [
                        "https://img.alicdn.com/i4/2378881695/O1CN0187Rh6o1OOLtwLSZ2x_!!2378881695.jpg",
                    "https://img.alicdn.com/i2/2378881695/O1CN01jddxVb1OOLtHFL0kG_!!2378881695.jpg",
                    "https://img.alicdn.com/i1/2378881695/O1CN01uSdcko1OOLtIgkeOK_!!2378881695.jpg",
                    "https://img.alicdn.com/i2/2378881695/O1CN01VjAIhV1OOLte8HdSz_!!0-item_pic.jpg"
                        ]
                },
                "title": "喜盈盈一口虾虾酥条 办公室下午茶休闲零食薯条/鲜虾条80g*3大包",
                "tk_total_commi": "9117.93",
                "tk_total_sales": "2444",
                "url": "//s.click.taobao.com/t?e=m%3D2%26s%3DlimQQ5ZkwJMcQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0EJ%2FcETqmSLTyMJK2z9CSAMLen%2BMlB%2BBT%2B1HfCZxdJPDb9tkn%2F1u6KYYZQ6g3qfmcqwAREUZrIer1GPduzu4oNrtUmQdQKfdNMpMmMAKX8uYotYzDcQ4SzJrgjAxE6YN4uMeootrswwp9bWveRt%2BG4P9pElIsXItYeLNb4tvRpoZIYULNg46oBA%3D&scm=null&pvid=100_11.178.158.87_18370_7811576074362444704&app_pvid=59590_11.132.118.138_473_1576074362441&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.178.158.87_18370_7811576074362444704;app_pvid:59590_11.132.118.138_473_1576074362441&xId=FasZRPUTmiALycx302MHk7Ovzf1NgddC7ghE1KCbDX8VMz4wFBhFUA9IryW8j0ObebqA5oclKgSCC9gXIZtoOS&union_lens=lensId%3A0b84768a_af81_16ef55a3ea8_cb21",
                "user_type": "1",
                "volume": "3150",
                "white_image": "https://img.alicdn.com/bao/uploaded/O1CN01F4HXXL1OOLtPlRGgK_!!2-item_pic.png",
                "x_id": "FasZRPUTmiALycx302MHk7Ovzf1NgddC7ghE1KCbDX8VMz4wFBhFUA9IryW8j0ObebqA5oclKgSCC9gXIZtoOS",
                "zk_final_price": "24.9"
            }
            ]
        },
        "total_results": "147367",
        "request_id": "4ctcwhh3lbfy"
    },
    "msg": "V1.3.13 小白开放接口 App.Taobao_TaobaoTBK.MaterialOptional"
}

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单
YesApi 接口文档

8907 淘宝客-推广者-图文内容效果数据

接口路径(新)：http://hn216.api.okayapi.com/api/App/Taobao_TaobaoTBK/ContentEffectGet

接口路径(旧)：http://hn216.api.okayapi.com/?s=App.Taobao_TaobaoTBK.ContentEffectGet

接口描述： 淘客媒体内容维度的效果输出。

接口参数 若无特殊说明，接口参数同时支持GET和POST传递；推荐：查询/删除用GET，创建/更新用POST。

参数名字参数类型是否必须默认值备注参数说明
app_key字符串必须最小：32公共参数 开发者应用的app_key，查看我的app_key，如果还没有，可免费注册开通。
sign字符串可选公共参数接口签名，其中：
  • 使用动态签名，签名生成算法请见：如何生成签名，或直接使用封装好的SDK开发包，通过在线测试工具可进行签名的对比和调试。
  • 使用静态签名，点击获取我的静态签名
  • 关闭签名，如果不需要签名，可进入小白开放平台接口签名设置关闭或开启签名。
  • 定制签名支持专属签名算法定制开发
uuid字符串可选公共参数 UUID，当前登录的应用会员ID，即全局唯一用户ID，查看我的应用会员。传递此参数后，可以在开放平台查看每日活跃会员统计图表。uuid需要和token一起传递。
token字符串可选公共参数 当前登录会员的会话凭证，可通过会员登录接口获得。uuid需要和token一起传递。
return_data字符串可选0公共参数 数据返回结构，其中：
  • return_data=0，返回完整的接口结果，示例：{"ret":200,"data":{"err_code":0,"err_msg":"","title":"Hi YesApi，欢迎使用小白开放接口！"},"msg":"V3.1.0 YesApi App.Hello.World","_t": 1657513450, "_auth": "9bcd54ff53e71a1d80d37c52bdfabf76"}；
  • return_data=1，返回简洁的接口结果，只返回data字段，结构简化一级，更扁平，示例：{"err_code":0,"err_msg":"V3.1.0 YesApi App.Hello.World","title":"Hi YesApi，欢迎使用小白开放接口！"}。
time字符串可选选择效果日期，如果不传即按日期倒序排，如：2018-04-02
page_no字符串可选页码从1开始
page_size整型可选50页数，最大1000
pid字符串可选如若不传则不做为筛选条件，如：mm_1_1_1
content_id字符串可选内容id，如不指定则不做为筛选条件，如：1234

客户端请求示例

查看我的接口域名、app_key和app_secrect 客户端接入指南(如何生成签名) 开启/关闭签名

接口返回及数据结构

返回字段类型说明
ret整型接口状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务端异常，查看异常错误码
dataobject/array/混合接口返回的业务数据，由不同的API接口决定不同的数据返回字段和结构。当return_data=1时，接口只会返回此data字段。
data.err_code整型操作码，0表示成功，正数表示业务失败场景，负数表示系统失败场景
data.err_msg字符串错误提示信息，err_code非0时参考此提示信息
msg字符串提示信息，面向技术人员的帮助或错误提示信息
_t整数服务器当时Unix时间戳，例如：1657513450
_auth字符串反向数字签名，可用于客户端进行反向验证，防止数据篡改，例如：9bcd54ff53e71a1d80d37c52bdfabf76。验证算法：_auth = md5(data返回的JSON字符串 + _t当前时间戳字符串 + APP_SECRECT密钥字符串)，若需要关闭或开启请提交工单

特别注意：当前 hn216.api.okayapi.com 为临时接口测试域名！请先完成 绑定独立接口域名后 ，才能正式进行API调用。

由 果创云YesApi.cn 提供技术支持，4万+开发者都在用，累计API调用1,800,000＋万次