API文档中心

热门接口：产品ID找同款全量维权查询万能转链字符串ID转换 （有API需求可联系本站）

淘宝联盟选品库列表和每个收藏夹商品查询

调用权限：核心接口会员卡调用
 接口测试 
接口使用场景等说明：

收藏夹是指淘宝联盟在https://pub.alimama.com/ 后台——>我的工具——>收藏夹 中，所提供给淘宝客批量管理和获取所需推广物料的功能，您可创建不同的收藏夹，比满足对不同类型商品筛选和管理的需要。进入“我的收藏夹”后，即可看到您所创建的所有收藏夹及对应商品，可修改并增减商品。


本接口可查询选品库的收藏夹列表，以及查询每个收藏夹的商品清单。


1、获取选品库的收藏夹列表：出参字段为：favorites_info，获得具体的收藏夹id及收藏夹名称；

2、获取每个收藏夹的商品列表：提供收藏夹id（入参 favorites_id），就可以的对应收藏夹内的所有商品列表

调用说明

本接口需要您在会员中心授权（如果多用户可传入sessionkey参数）

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/tbk/favorites 暂无

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
pid Number 是 123 推广位id，mm_111_222_333
query_type Number 是 1 指定查询类型，可选值1或2：1-查列表，2-查每个收藏夹的商品列表
favorites_id Number 否 2094134051 查询指定收藏夹ID的商品。当query_type=2时是。
page_size Number 否 20 页大小，默认10，1~100
page_no Number 否 1 第几页，默认：1
sessionkey String 否 7002 多用户专用。如果您的会员卡是多用户版订单查询接口，若要查不同的帐号，请提供该帐号授权的sessionkey值
account_id String 否 联盟号id 会员中心有多个授权时，用本参数指定要查询哪一个联盟号id数据，联盟号ID请到会员中心授权页查看

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/tbk/favorites?vekey=xxx&query_type=2&favorites_id=2094134051
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/tbk/favorites?vekey=xxx&query_type=2&favorites_id=2094134051";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api);
//curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
//curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流，不直接输出
curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);

$result = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool，以hutool为例：

import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpRequest;

public class testGetParam {

    public static void main(String[] args) {
        // API网址
        String url = "http://api.veapi.cn/tbk/favorites?vekey=xxx&query_type=2&favorites_id=2094134051";
        // JDK 8u111版本后，若目标页面为HTTPS协议，请启用proxy用户密码鉴权
        //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");

        // 发送请求
        String result = HttpRequest.get(url)
                .timeout(10000)//设置超时，毫秒
                .execute().body();
        System.out.println(result);
    }
}
推荐使用 requests，支持访问http,https网页：

import requests
		
# 要访问的API网页
target_url = "http://api.veapi.cn/tbk/favorites?vekey=xxx&query_type=2&favorites_id=2094134051"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值（JSON）

参数名称 参数类型 示例值 描述
is_default String false 推荐信息-是否抄底
total_count Number 100 商品总数-该选品库收藏夹id及官方物料id对应的商品数量
uvid_msg String 123 uvid结果信息，传入但未使用uvid时会返回原因
isv_mktid String aisj979ld8-8asdbalaiu 根据入参工具服务商账号信息生成的新商品ID
favorites_info Favoritesinfo   选品库信息，仅当查询选品库列表时才有该字段。
 └─ total_count Number 100 选品库收藏夹总数量
 └─ favorites_list Favoritesdetail[]   选品库收藏夹详细信息
    └─ favorites_id Number 12334 选品库收藏夹id
    └─ favorites_title String 测试选品库 选品库收藏夹标题
item_basic_info Basicmapdata   商品基础信息
 └─ title String 复古女裤子秋冬九分裤萝卜裤 商品信息-商品标题
 └─ short_title String 九分裤显瘦高腰韩版 商品信息-商品短标题
 └─ pict_url String //img.alicdn.com/...-item_pic.jpg 商品信息-商品主图
 └─ white_image String //img.alicdn.com/...jpg 商品信息-商品白底图
 └─ level_one_category_id Number 1 商品信息-一级类目ID
 └─ level_one_category_name String 美妆 商品信息-一级类目名称
 └─ category_id Number 162201 商品信息-叶子类目id
 └─ category_name String 牛仔裤 商品信息-叶子类目名称
 └─ seller_id Number 123 店铺信息-卖家id
 └─ user_type Number 1 店铺信息-卖家类型，0表示淘宝，1表示天猫，3表示特价版
 └─ shop_title String 魔黛娅内衣旗舰店 店铺信息-店铺名称
 └─ volume Number 30 商品信息-30天销量；数据统计截止昨日非实时更新
 └─ sub_title String 吉品鲍鱼 关西参 商品信息-商品子标题
 └─ brand_name String 淘宝心选 商品信息-品牌名称
presale_info Presaleinfo   预售信息
 └─ presale_start_time Number 1567440000000 预售商品-付定金开始时间（毫秒）
 └─ presale_end_time Number 1567440000000 预售商品-付定金结束时间（毫秒）
 └─ presale_tail_start_time Number 1567440000000 预售商品-付尾款开始时间（毫秒）
 └─ presale_tail_end_time Number 1567440000000 预售商品-付尾款结束时间（毫秒）
 └─ presale_deposit String 100 预售商品-定金（元）
 └─ presale_discount_fee_text String 付定金立减5元 预售商品-优惠信息
price_promotion_info Promotioninfomapdata   价格促销信息
 └─ reserve_price String 102.00 商品信息-一口价通常显示为划线价
 └─ zk_final_price String 79.9 促销信息-销售价格，无促销时等于一口价，有促销时为促销价。若属于预售商品，付定金时间内，在线售卖价=预售价
 └─ final_promotion_price String 69.9 促销信息-预估到手价(元)。若属于预售商品，付定金时间内，预估到手价价=定金+尾款的预估到手价
publish_info Publishinfo   淘客推广信息
 └─ income_rate String 5.50 商品信息-收入比率(%)；商品佣金比率+补贴比率
 └─ click_url String //s.click.taobao.com/t?e=m... 链接-宝贝推广链接
 └─ coupon_share_url String //uland.taobao.com/... 链接-宝贝+券二合一页面链接
 └─ sp_campaign_list Spcampaign[]   定向计划集合-仅支持联系商务或运营小二申请定向计划合集字段权限
 └─ income_info Incomeinfo   商品佣金信息
    └─ commission_rate String 55 商品佣金比率
    └─ commission_amount String 12 商品佣金金额
    └─ subsidy_rate String 11 补贴比率
    └─ subsidy_amount String 4 补贴金额
    └─ subsidy_upper_limit String 10 补贴上限；仅在单笔订单命中补贴上限时返回结果否则出参为空
scope_info Scopeinfo   商品库范围信息
 └─ superior_brand String 1 是否品牌精选，0不是，1是

返回示例

【提示】推广链接通常有时效性，示例中的链接为创建文档时生成，仅用于展示返回结果使用，有可能已失效。
{ "error": "0", "msg": "查询成功！", "is_default": "false", "data": [ { "isv_mktid": "6v2aVzRC8tkjWDeu485Cot3-mMVzK8s78KDavJNUN", "item_basic_info": { "category_id": "50010537", "level_one_category_id": "50008165", "pict_url": "//img.alicdn.com/i4/255845733/O1CN01WsFdrC1sDlZ0INaWB_!!255845733.png", "seller_id": "4829056325738700466", "shop_title": "童泰母婴旗舰店", "title": "童泰婴儿连体衣秋冬季保暖宝宝衣服家居内衣偏开长袖夹棉哈衣爬服", "user_type": "1", "volume": "500", "white_image": "https://img.alicdn.com/bao/uploaded/O1CN01MV3lt71kfgjHYZNtJ_!!6000000004711-0-yinhe.jpg", "item_url": "https://uland.taobao.com/item/edetail?id=WxZo82tot2jZjKGNpCrWYIQta-mMVzK8s78KDavJNUN" }, "item_id": "WxZo82tot2jZjKGNpCrWYIQta-mMVzK8s78KDavJNUN", "presale_info": [], "price_promotion_info": { "reserve_price": "109.00", "zk_final_price": "65" }, "publish_info": { "click_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DhLVyYeoVJeBw4vFB6t2Z2ueEDrYVVa64Dne87AjQPk9yINtkUhsv0EH8qNtsVa3YxYTyzumKnGIL60FsZM9I2TIgTwpFUxJ%2BJzdJ3rdo4hcyJwaoKcyDsvAy%2Fay3dFHh7oVdeaxbXwH9DiNIlf8fP9PAaz7inggcEsfmixNmHdKyWIoTMUEx%2FSvntKtnvEgdXqpLtvLnATDNvEYaKndCY7bwtMNkY2OgKkQW85YhcBuy8E9SQYneG7TrV%2B3khMobjCYbLVFRUpiiZ%2BQMlGz6FQ%3D%3D&union_lens=lensId%3AMAPI%401706282303%40212bb30d_1265_18d4659c1d3_507e%4001%40eyJmbG9vcklkIjozMTUzOX0ie", "income_info": [], "income_rate": "0.9" }, "scope_info": [] } ], "request_id": "MCnlRBV" }

错误码

如果error不为0时，请点此查看错误码表格

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部