淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	描述
top_service_context	TopServiceContext	必须	topServiceContext
└ biz_code String 必须 xxxxx api业务线编码 └ login_type Number 可选 1 1: 直客(正常)登录 2: 代理直投(叉乘账号) └ member_id Number 可选 12345 代理直投时被代理商家账号, 代理直投（叉乘）时必填。直客时也可以填入 memberId └ ext String 可选 {} 扩展内容, 暂时无用
item_query_v_o	ItemQueryVO	必须	itemQueryVO
└ item_id_list Number [] 可选 [714894818852, 714901906337] 宝贝id集合 └ tag_id Number 可选 1 物料来源标识,1:全部宝贝,2:推荐宝贝,3:活动宝贝,4:有好货宝贝,5:图文,6:有好货帖子,7:直播,8:淘积木,9:短视频,10:图文手猜,11:可用津贴券商品,12:全部新品,13:618活动商品,14:可用店铺券宝贝,15:推荐新品,16:首页新品推荐,20:首页推荐,21:图文V任务,22:短视频V任务,23:直播V任务,25:店铺微淘,26:直播合作,24:落地页,27:活动商品,28:首页大促商品,29:投中探测爆款商品,30:已报名的新享宝贝,31:店铺视频,32:包含单元宝贝的淘积木列表,34:达人视频,33:不计入最低价新品,35:首猜精品库,36:首猜精品中的新品,37:行业优选,38:大促推荐新品,39:推广有礼":关于推广有礼,40:效果优选,41:潜力爆品,42:全店成长,43:双11,44:推广有礼,49:新品飞车数据,50:效果优选,53:全店优选二期,55:首单礼金,56:新品直降,57:限时优惠,58:618大促,59:扩容后新品飞车商品池,101:全部,102:优选宝贝":根据该宝贝历史数据预测为适合推广的宝贝。,103:优选流量":根据该宝贝历史数据预测为在引流方面有潜力宝贝。,104:优选转化":根据该宝贝历史数据预测为在转化方面有潜力宝贝。,105:生意参谋":根据店铺宝贝历史数据优选推荐的适合推广的宝贝。,106:生意参谋-物流红包,1000:组件tag开始index,1999:组件tag结束,209:策略中心货品加速单品,201:策略中心推荐宝贝,202:策略中心推荐相似宝贝,203:策略中心智能营销推荐宝贝,204:策略中心大快消TOP单品,205:策略中心新享报名商品,206:策略中心未报名商品,207:策略中心上新单品,214:策略中心上新礼,224:策略中心小黑盒上新,212:策略中心产业带单品,210:策略中心货品加速新的tag,211:策略中心货品加速版本2,213:策略中心大快消入会快,215:策略中心大快消留资快,216:策略中心大快消派样快,219:策略中心大快消预热蓄水,217:策略中心大快消爆发现货,218:策略中心大快消爆发预售,220:策略中心大快消测款,221:策略中心销量明星商品,222:策略中心测款均匀曝光,223:策略中心大测款均匀预算,225:策略中心上新数智经营争霸赛,226:策略中心货品加速数智经营争霸赛,227:策略中心数预热蓄水智经营争霸赛,228:策略中心爆发现货数智经营争霸赛,229:策略中心爆发预售数智经营争霸赛,230:策略中心大快消数智经营争霸赛,1016001:系统优选,1016002:相似宝贝,1100001:极速推宝贝推荐,101111301:冷启动新品,101111302:好货推荐,101111303:趋势主题选品 └ title String 可选测试宝贝名称，支持模糊查询 └ shop_category_id Number 可选 1714177721 店铺类目id └ promotion_scene String 可选 promotion_scene_crowd 推广场景,promotion_scene_crowd:人群方舟,promotion_scene_item:店铺宝贝运营,promotion_scene_traffic:宝藏场景,AD_STRATEGY_LAXIN:策略中心拉新场景,AD_STRATEGY_SHANGXINLI:策略中心上新礼场景,AD_STRATEGY_FRESH_BOX:策略中心小黑盒场景,AD_STRATEGY_LAXIN_XINXIANG:策略中心拉新新享一笔钱场景,AD_STRATEGY_RUHUI_NEW:策略中心入会快新会员场景,AD_STRATEGY_RUHUI_OLD:策略中心入会快老会员场景,AD_STRATEGY_LIUZI:策略中心留资快场景,AD_STRATEGY_YURE:策略中心活动加速场景,AD_STRATEGY_HUODONG_ESCORT:活动全周期护航计划,AD_STRATEGY_CROWD_INDUSTRY:策略中心行业人群通,AD_STRATEGY_WHOLE_SHOP_SMART:策略中心全店放心推-智能托管,AD_STRATEGY_WHOLE_SHOP_CUSTOM:策略中心全店放心推-自定义,AD_STRATEGY_EVEN_BUDGET:策略中心均匀曝光场景,AD_STRATEGY_SXK_GUARANTEE:万相台上新快确定性保障,AD_STRATEGY_HPJS_GUARANTEE:万相台货品加速确定性保障,AD_STRATEGY_HPJS_TIME_LIMIT:万相台货品加速限时加速,AD_STRATEGY_FANS_HEADLINES:万相台粉丝头条,WXT_AGENCY_XST_CPC:服务商版一键起量（CPC）,WXT_AGENCY_XST_CPA:服务商版客源多（CPA）,WXT_AGENCY_SHEQUN:服务商版社群（CPA+CPS） └ optimize_target String 可选 conv 优化目标，conv:促进成交,coll_cart:促进加购,click:促进点击,deal_count:促进成交笔数,exposure_pv:促进曝光,mini_view:促进橱窗宝贝浏览个数,mini_interactive:促进橱窗宝贝互动,ad_strategy_wangwang:策略中心旺旺咨询,shop_potential:提升潜客人数,shop_interest_new:提升兴趣新客人数,shop_purchase_new:提升首购新客人数,shop_visit_new:提升访问新客人数,shop_repurchase:提升复购人数,high_cvr:提升高转换人群成交人数,deeplink_d:提升品牌发现人数-D,deeplink_e1:提升品牌种草人数-E,deeplink_e2:提升品牌互动人数-E,deeplink_p:提升品牌行动人数-P,deeplink_i:提升品牌首购人数-I,deeplink_n:提升品牌复购人数-N,deeplink_k:提升品牌挚爱人数-K,hf_grass_plant:预热种草,hf_impoundment:预售蓄水,hf_harvest:爆发收割,nd_click:提高互动量,nd_cart:提高加购量,nd_deal:提高成交量,ad_strategy_ruhui_count:策略中心入会快新会员场景入会量目标,ad_strategy_lzl:策略中心留资快留资量目标,ad_strategy_try:策略中心派样量,ad_strategy_view:策略中心优化展现,ad_strategy_auto_trans:策略中心自动流转,ad_strategy_trial_order:策略中心表单获客成本,ad_strategy_liuzi_cost:策略中心广义留资目标,ad_strategy_cool_start:策略中心自动冷启动,ad_strategy_cool_start_mini_aim:策略中心冷启动分阶段目标流转,wxt_agency_ai:A转I人群流转,wxt_agency_smart:自定义场景,form_submit:表单提交,trial_order:试用下单,wangwang_liuzi:旺旺留资 └ campaign_id Number 可选 69340883646 计划id └ item_selected_mode String 可选 shop 选品方式,shop:全店优选,user_define:用户自定义选品,scope:范围圈选,trend:趋势选品 └ shop_item_type String 可选 effect 优选集合,effect:效果优选,growing:全店成长,activity:活动选品,industry:行业尖货,scope:定义选品 └ offset Number 可选 10 偏移量 └ page_size Number 可选 10 页面大小

名称	类型	示例值	描述
top_result	TopResult		topResult
info TopInfo 通用前端结果的Info信息请求系统信息 └ ok Boolean true 是否成功 └ message String 参数错误错误信息 └ error_code String xxxxx 错误编码 item_v_o_top_bulk_data TopBulkData 结果集 └ count Number 10 成功数量 item_v_o_list ItemVO [] 批量成功结果集 └ item_id Number 714707465203 商品id └ title String 测试商品_请不要拍_夏季连衣裙，1 商品标题 └ img_url String //img.alicdn.com/bao/uploaded/i4/2212778286564/O1CN018hQuTY1yMMbmQD13V_!!2212778286564.jpg 商品图片 └ link_url String http://item.taobao.com/item.htm?id=714707465203 商品地址 └ price Number 899900 价格 └ bid_count Number 899900 销量 └ quantity Number 10 库存 └ first_starts_time Date 2023-04-26 14:51:03 首次上架时间 └ starts Date 2023-04-26 14:51:03 最近上架时间 └ category_id String 16 50010850 主站类目路径，空格分隔多级 └ timing Boolean false 是否定时上架,true:是,false:否

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpNewMaterialItemFindpageRequest req = new UniversalbpNewMaterialItemFindpageRequest();
UniversalbpNewMaterialItemFindpageRequest.TopServiceContext obj1 = new UniversalbpNewMaterialItemFindpageRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
obj1.setLoginType(1L);
obj1.setMemberId(12345L);
obj1.setExt("{}");
req.setTopServiceContext(obj1);
UniversalbpNewMaterialItemFindpageRequest.ItemQueryVO obj2 = new UniversalbpNewMaterialItemFindpageRequest.ItemQueryVO();
obj2.setItemIdList(new Long[] { 714894818852, 714901906337 };
);
obj2.setTagId(1L);
obj2.setTitle("测试");
obj2.setShopCategoryId(1714177721L);
obj2.setPromotionScene("promotion_scene_crowd");
obj2.setOptimizeTarget("conv");
obj2.setCampaignId(69340883646L);
obj2.setItemSelectedMode("shop");
obj2.setShopItemType("effect");
obj2.setOffset(10L);
obj2.setPageSize(10L);
req.setItemQueryVO(obj2);
UniversalbpNewMaterialItemFindpageResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
UniversalbpNewMaterialItemFindpageRequest req = new UniversalbpNewMaterialItemFindpageRequest();
UniversalbpNewMaterialItemFindpageRequest.TopServiceContextDomain obj1 = new UniversalbpNewMaterialItemFindpageRequest.TopServiceContextDomain();
obj1.BizCode = "xxxxx";
obj1.LoginType = 1L;
obj1.MemberId = 12345L;
obj1.Ext = "{}";
req.TopServiceContext_ = obj1;
UniversalbpNewMaterialItemFindpageRequest.ItemQueryVODomain obj2 = new UniversalbpNewMaterialItemFindpageRequest.ItemQueryVODomain();
obj2.ItemIdList = new long[] { 714894818852, 714901906337 };
;
obj2.TagId = 1L;
obj2.Title = "测试";
obj2.ShopCategoryId = 1714177721L;
obj2.PromotionScene = "promotion_scene_crowd";
obj2.OptimizeTarget = "conv";
obj2.CampaignId = 69340883646L;
obj2.ItemSelectedMode = "shop";
obj2.ShopItemType = "effect";
obj2.Offset = 10L;
obj2.PageSize = 10L;
req.ItemQueryVO_ = obj2;
UniversalbpNewMaterialItemFindpageResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new UniversalbpNewMaterialItemFindpageRequest;
$top_service_context = new TopServiceContext;
$top_service_context->biz_code="xxxxx";
$top_service_context->login_type="1";
$top_service_context->member_id="12345";
$top_service_context->ext="{}";
$req->setTopServiceContext(json_encode($top_service_context));
$item_query_v_o = new ItemQueryVO;
$item_query_v_o->item_id_list="[714894818852, 714901906337]";
$item_query_v_o->tag_id="1";
$item_query_v_o->title="测试";
$item_query_v_o->shop_category_id="1714177721";
$item_query_v_o->promotion_scene="promotion_scene_crowd";
$item_query_v_o->optimize_target="conv";
$item_query_v_o->campaign_id="69340883646";
$item_query_v_o->item_selected_mode="shop";
$item_query_v_o->shop_item_type="effect";
$item_query_v_o->offset="10";
$item_query_v_o->page_size="10";
$req->setItemQueryVO(json_encode($item_query_v_o));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.universalbp.new.material.item.findpage' \
-d 'partner_id=apidoc' \
-d 'session=b9cf879f-4be0-45ac-8ea3-26ac80d03159' \
-d 'sign=6934077816F695CD4FA7AD83B0FB65B7' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+12%3A49%3A30' \
-d 'v=2.0' \
-d 'item_query_v_o=null' \
-d 'top_service_context=TopServiceContext'

# -*- coding: utf-8 -*-
import top.api

req=top.api.UniversalbpNewMaterialItemFindpageRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.top_service_context="TopServiceContext"
req.item_query_v_o=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.universalbp.new.material.item.findpage");
add_param(pRequest,"top_service_context","数据结构JSON示例");
add_param(pRequest,"item_query_v_o","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.universalbp.new.material.item.findpage', {
	'top_service_context':'数据结构JSON示例',
	'item_query_v_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<universalbp_new_material_item_findpage_response>
    <top_result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <item_v_o_top_bulk_data>
            <count>10</count>
            <item_v_o_list>
                <item_v_o>
                    <item_id>714707465203</item_id>
                    <title>测试商品_请不要拍_夏季连衣裙，1</title>
                    <img_url>//img.alicdn.com/bao/uploaded/i4/2212778286564/O1CN018hQuTY1yMMbmQD13V_!!2212778286564.jpg</img_url>
                    <link_url>http://item.taobao.com/item.htm?id=714707465203</link_url>
                    <price>899900</price>
                    <bid_count>899900</bid_count>
                    <quantity>10</quantity>
                    <first_starts_time>2023-04-26 14:51:03</first_starts_time>
                    <starts>2023-04-26 14:51:03</starts>
                    <category_id>16 50010850</category_id>
                    <timing>false</timing>
                </item_v_o>
            </item_v_o_list>
        </item_v_o_top_bulk_data>
    </top_result>
</universalbp_new_material_item_findpage_response>

{
    "universalbp_new_material_item_findpage_response":{
        "top_result":{
            "info":{
                "ok":true,
                "message":"参数错误",
                "error_code":"xxxxx"
            },
            "item_v_o_top_bulk_data":{
                "count":10,
                "item_v_o_list":{
                    "item_v_o":[
                        {
                            "item_id":714707465203,
                            "title":"测试商品_请不要拍_夏季连衣裙，1",
                            "img_url":"\/\/img.alicdn.com\/bao\/uploaded\/i4\/2212778286564\/O1CN018hQuTY1yMMbmQD13V_!!2212778286564.jpg",
                            "link_url":"http:\/\/item.taobao.com\/item.htm?id=714707465203",
                            "price":899900,
                            "bid_count":899900,
                            "quantity":10,
                            "first_starts_time":"2023-04-26 14:51:03",
                            "starts":"2023-04-26 14:51:03",
                            "category_id":"16 50010850",
                            "timing":false
                        }
                    ]
                }
            }
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

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

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

万相台无界API

taobao.universalbp.new.material.item.findpage (分页查询商品信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ