淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
req	SeoItemRequest	必须			请求对象
└ item_ids String [] 可选 ["123","456"] 商品列表，可指定商品，单次最多50条, 指定商品时batch和limit和为空 └ batch String 可选 batch_1_xx 查询批次, 调用方自己保障含义，同一批次查询会根据当前进度获取最新数据，有效期90天，未指定商品必填 └ limit Number 可选 100 返回条数，单次最多100条，未指定商品必填 └ source String 必须 xx 请求来源, 联系接口管理员分配 └ update_time Number 可选 1722328654779 更新时间，毫秒时间戳

名称	类型	示例值	描述
result	Result		请求响应信息
└ code Number 200 code data SeoItemResult [] 商品信息 └ reserve_price String 10.00 商品价格（元） sku_list ItemSkuTable [] sku信息 └ sku_pc_url String https://xxx.htm sku pc端链接 └ price String 10.00 sku价格（元） └ sku_mobile_url String https://xxx.htm sku移动端链接 └ sku_id String xxx sku主键 └ property_pic String https://xxx.jpg sku颜色属性图片 └ properties String [] sku属性，格式：属性:属性值 └ delivery_time String 5 发货时效（小时） └ city String 上海发货城市 └ pict_url String https://xxx.jpg 商品主图 └ item_pc_url String https://xxx.htm 商品PC端链接 └ title String xxx 商品标题 └ sold_quantity String 1000 销量 └ tags String [] 商品服务保障标签 └ item_id String xxx 商品主键 └ secure_trade_fast_post_fee String 5.00 快递费用 └ shop_id String xxx 归属商家信息 └ item_mobile_url String https://xxx.htm 商品移动端链接 └ update_time Number 1722328654779 最后修改时间，毫秒时间戳 └ category String 女装>>裤子>>西裤类目1>>....>>类目n └ success Boolean true success └ message String OK message └ attributes String {\"total\":225623814,\"offset\":10} offset: 当前已抓取数量, total: 总数

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PcSeoItemQueryRequest req = new PcSeoItemQueryRequest();
PcSeoItemQueryRequest.SeoItemRequest obj1 = new PcSeoItemQueryRequest.SeoItemRequest();
obj1.setItemIds(""123","456"");
obj1.setBatch("batch_1_xx");
obj1.setLimit(100L);
obj1.setSource("xx");
obj1.setUpdateTime(1722328654779L);
req.setReq(obj1);
PcSeoItemQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
PcSeoItemQueryRequest req = new PcSeoItemQueryRequest();
PcSeoItemQueryRequest.SeoItemRequestDomain obj1 = new PcSeoItemQueryRequest.SeoItemRequestDomain();
obj1.ItemIds = ""123","456"";
obj1.Batch = "batch_1_xx";
obj1.Limit = 100L;
obj1.Source = "xx";
obj1.UpdateTime = 1722328654779L;
req.Req_ = obj1;
PcSeoItemQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new PcSeoItemQueryRequest;
$req = new SeoItemRequest;
$req->item_ids="[\"123\",\"456\"]";
$req->batch="batch_1_xx";
$req->limit="100";
$req->source="xx";
$req->update_time="1722328654779";
$req->setReq(json_encode($req));
$resp = $c->execute($req);

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.pc.seo.item.query' \
-d 'partner_id=apidoc' \
-d 'sign=E75669DF05A7A835FD665C0D2AB03193' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-29+11%3A41%3A12' \
-d 'v=2.0' \
-d 'req=null'

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

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

req.req="数据结构示例JSON格式"
try:
	resp= req.getResponse()
	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.pc.seo.item.query");
add_param(pRequest,"req","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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.pc.seo.item.query', {
	'req':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<pc_seo_item_query_response>
    <result>
        <code>200</code>
        <data>
            <seo_item_result>
                <reserve_price>10.00</reserve_price>
                <sku_list>
                    <item_sku_table>
                        <sku_pc_url>https://xxx.htm</sku_pc_url>
                        <price>10.00</price>
                        <sku_mobile_url>https://xxx.htm</sku_mobile_url>
                        <sku_id>xxx</sku_id>
                        <property_pic>https://xxx.jpg</property_pic>
                    </item_sku_table>
                </sku_list>
                <delivery_time>5</delivery_time>
                <city>上海</city>
                <pict_url>https://xxx.jpg</pict_url>
                <item_pc_url>https://xxx.htm</item_pc_url>
                <title>xxx</title>
                <sold_quantity>1000</sold_quantity>
                <item_id>xxx</item_id>
                <secure_trade_fast_post_fee>5.00</secure_trade_fast_post_fee>
                <shop_id>xxx</shop_id>
                <item_mobile_url>https://xxx.htm</item_mobile_url>
                <update_time>1722328654779</update_time>
                <category>女装&gt;&gt;裤子&gt;&gt;西裤</category>
            </seo_item_result>
        </data>
        <success>true</success>
        <message>OK</message>
        <attributes>{\&quot;total\&quot;:225623814,\&quot;offset\&quot;:10}</attributes>
    </result>
</pc_seo_item_query_response>

{
    "pc_seo_item_query_response":{
        "result":{
            "code":200,
            "data":{
                "seo_item_result":[
                    {
                        "reserve_price":"10.00",
                        "sku_list":{
                            "item_sku_table":[
                                {
                                    "sku_pc_url":"https:\/\/xxx.htm",
                                    "price":"10.00",
                                    "sku_mobile_url":"https:\/\/xxx.htm",
                                    "sku_id":"xxx",
                                    "property_pic":"https:\/\/xxx.jpg"
                                }
                            ]
                        },
                        "delivery_time":"5",
                        "city":"上海",
                        "pict_url":"https:\/\/xxx.jpg",
                        "item_pc_url":"https:\/\/xxx.htm",
                        "title":"xxx",
                        "sold_quantity":"1000",
                        "item_id":"xxx",
                        "secure_trade_fast_post_fee":"5.00",
                        "shop_id":"xxx",
                        "item_mobile_url":"https:\/\/xxx.htm",
                        "update_time":1722328654779,
                        "category":"女装>>裤子>>西裤"
                    }
                ]
            },
            "success":true,
            "message":"OK",
            "attributes":"{\\\"total\\\":225623814,\\\"offset\\\":10}"
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案
isv.1000	参数错误	检查传入参数合法性
isv.1001	指定商品数量超过最大限制	不要超过100
isv.1002	并发请求过高	降低并发，稍后再试
isv.1003	商品ID解析失败	传入正确商品ID
isv.1004	更新时间字段无效	传入正确毫秒时间戳格式
isv.1005	远程服务执行错误	稍后再试或联系管理员
isv.1006	商品未找到	商品可能已下架或传入商品ID有误

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

用户增长

taobao.pc.seo.item.query (seo获取商品信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ