淘宝开放平台

请求地址：

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

名称	类型	是否必须	描述
param_cspu_criteria	CspuCriteria	可选	组合查询对象
└ art_nos String [] 可选 68325 货号 └ barcodes String [] 可选 68325-02 条码列表 └ brand_ids String [] 可选 19835 品牌id列表 └ cat_ids String [] 可选 1535 类目 └ create_date_end Date 可选 2018-02-01 11:11:11 按创建时间查询结束条件 └ create_date_start Date 可选 2018-02-01 11:11:11 按创建时间查询开始条件 └ cspu_ids String [] 可选 10000337658602 cspu编码 └ keyword String 可选阿迪达斯男士上衣" 模糊查询 └ property_value_ids String [] 可选 1585 属性值id列表 └ spu_ids String [] 可选 100000336689 spuId列表 └ style_no String 可选 6843548 款号
param_paginator	Paginator	必须	分页参数
└ page Number 可选 1 当前页码 └ page_size Number 可选 100 每页显示多少条记录

名称	类型	示例值	描述
data	PagedList		data
└ current_page Number 1 当前页 list Cspudto [] 数据结果集 └ art_no String 234234 货号 └ barcode String 4857694444 条码 └ created Date 2017-11-11 11:11:11 创建时间 └ creator_id String 2017-11-11 11:11:11 创建人唯一标识 └ id String 123123 唯一标识 └ level Number 1 商品级别 └ modified Date 2017-11-23 12:11:12 修改时间 └ modifier_id String 123231 修改人唯一标识 └ out_id String 34344 外部商品Id properties PropertyDto [] 商品属性 └ p_alias String 属性别名 └ p_custom_name String 自定义属性名称 └ p_id String 属性ID └ p_name String 属性名称，如：颜色 └ v_alias String 属性别名 └ v_custom_name String 自定义属性值名称 └ v_id String 属性值Id └ v_name String 属性值名称 └ img_url String https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg 图片地址 └ order Number 1 排序值 └ property_type String sale 属性类型：sale, nonCritical, critical spu Spudto spu └ barcode_str String 023343434 条码信息 └ brand_id String 23485 品牌唯一标识 └ brand_name String 阿迪达斯品牌名称 └ cat_name String 女士类目名称 └ cid String 1000098 类目唯一标识 └ created Date 2017-06-09 11:20:32 创建时间 └ id String 56756 唯一标识 └ is_new Boolean true 是否新品,默认true └ level Number 4 商品级别:1.天猫，2.线上，3.单品，4.原始 └ material String 图片地址透明素材图 └ mdesc String 女士运动卫衣 m站产品描述 └ modified Date 2017-11-12 11:11:11 修改时间 └ pc_desc String 女士运动卫衣 pc端产品描述 └ pic_url String https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg 图片地址 └ price String 200.12 吊牌价,单位:元 └ product_id String 23455445 产品唯一标识 product_imgs ProductImgDto [] 商品图片集合 └ id Number 234234 唯一标识 └ position Number 1 排序值 └ url String https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg 图片绝对地址 props PropertyDto [] 属性 └ p_alias String 属性别名 └ p_custom_name String 自定义属性名称 └ p_id String 属性Id └ p_name String 属性名称 └ v_alias String 属性别名 └ v_custom_name String 自定义属性值名称 └ v_id String 属性值Id └ v_name String 属性值名称，如：36 └ img_url String https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg 图片地址 └ order Number 1 排序值 └ property_type String sale 属性类型:销售属性(sale),非关键属性(nonCritical), 关键属性(critical) └ rate_num Number 1 产品评分次数 └ sell_pt String 明细同款产品卖点描述，长度限制在20个汉字 └ status Number 1 产品状态：删除(-1),正常(1) └ style_no String 020714898342 款号 └ sub_title String 短款卫衣子标题 └ tags String {"colorCode":"0901","colorName":"红色"} 扩展属性 └ title String 女士卫衣产品名称 └ standard Boolean true 是否标准产品 └ status Number 1 当前状态:删除(-1),正常(1） └ style_no String 020714898342 款号 └ sub_title String 卫衣子标题 └ tag_price String 40.15 吊牌价,单位:元 └ title String 卫衣标题 └ user_type String userType └ page_size Number 10 每页获取多少条记录 └ total_count Number 20 总记录数 └ total_page Number 2 总页数

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosGoodsSearchcspuRequest req = new AlibabaMosGoodsSearchcspuRequest();
AlibabaMosGoodsSearchcspuRequest.CspuCriteria obj1 = new AlibabaMosGoodsSearchcspuRequest.CspuCriteria();
obj1.setArtNos("68325");
obj1.setBarcodes("68325-02");
obj1.setBrandIds("19835");
obj1.setCatIds("1535");
obj1.setCreateDateEnd(StringUtils.parseDateTime("2018-02-01 11:11:11"));
obj1.setCreateDateStart(StringUtils.parseDateTime("2018-02-01 11:11:11"));
obj1.setCspuIds("10000337658602");
obj1.setKeyword("阿迪达斯男士上衣\"");
obj1.setPropertyValueIds("1585");
obj1.setSpuIds("100000336689");
obj1.setStyleNo("6843548");
req.setParamCspuCriteria(obj1);
AlibabaMosGoodsSearchcspuRequest.Paginator obj2 = new AlibabaMosGoodsSearchcspuRequest.Paginator();
obj2.setPage(1L);
obj2.setPageSize(100L);
req.setParamPaginator(obj2);
AlibabaMosGoodsSearchcspuResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaMosGoodsSearchcspuRequest req = new AlibabaMosGoodsSearchcspuRequest();
AlibabaMosGoodsSearchcspuRequest.CspuCriteriaDomain obj1 = new AlibabaMosGoodsSearchcspuRequest.CspuCriteriaDomain();
obj1.ArtNos = "68325";
obj1.Barcodes = "68325-02";
obj1.BrandIds = "19835";
obj1.CatIds = "1535";
obj1.CreateDateEnd = DateTime.Parse(2018-02-01 11:11:11");
obj1.CreateDateStart = DateTime.Parse(2018-02-01 11:11:11");
obj1.CspuIds = "10000337658602";
obj1.Keyword = "阿迪达斯男士上衣\"";
obj1.PropertyValueIds = "1585";
obj1.SpuIds = "100000336689";
obj1.StyleNo = "6843548";
req.ParamCspuCriteria_ = obj1;
AlibabaMosGoodsSearchcspuRequest.PaginatorDomain obj2 = new AlibabaMosGoodsSearchcspuRequest.PaginatorDomain();
obj2.Page = 1L;
obj2.PageSize = 100L;
req.ParamPaginator_ = obj2;
AlibabaMosGoodsSearchcspuResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaMosGoodsSearchcspuRequest;
$param_cspu_criteria = new CspuCriteria;
$param_cspu_criteria->art_nos="68325";
$param_cspu_criteria->barcodes="68325-02";
$param_cspu_criteria->brand_ids="19835";
$param_cspu_criteria->cat_ids="1535";
$param_cspu_criteria->create_date_end="2018-02-01 11:11:11";
$param_cspu_criteria->create_date_start="2018-02-01 11:11:11";
$param_cspu_criteria->cspu_ids="10000337658602";
$param_cspu_criteria->keyword="阿迪达斯男士上衣\"";
$param_cspu_criteria->property_value_ids="1585";
$param_cspu_criteria->spu_ids="100000336689";
$param_cspu_criteria->style_no="6843548";
$req->setParamCspuCriteria(json_encode($param_cspu_criteria));
$param_paginator = new Paginator;
$param_paginator->page="1";
$param_paginator->page_size="100";
$req->setParamPaginator(json_encode($param_paginator));
$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=alibaba.mos.goods.searchcspu' \
-d 'partner_id=apidoc' \
-d 'session=51ddf44b-f3a3-4caf-9a4e-c36d0afbbeeb' \
-d 'sign=3BEA31D287C6A1AE4379DE9CC4CE7204' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-23+01%3A35%3A36' \
-d 'v=2.0' \
-d 'param_cspu_criteria=null' \
-d 'param_paginator=null'

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

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

req.param_cspu_criteria=""
req.param_paginator=""
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,"alibaba.mos.goods.searchcspu");
add_param(pRequest,"param_cspu_criteria","数据结构JSON示例");
add_param(pRequest,"param_paginator","数据结构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('alibaba.mos.goods.searchcspu', {
	'param_cspu_criteria':'数据结构JSON示例',
	'param_paginator':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_mos_goods_searchcspu_response>
    <data>
        <current_page>1</current_page>
        <list>
            <cspudto>
                <art_no>234234</art_no>
                <barcode>4857694444</barcode>
                <created>2017-11-11 11:11:11</created>
                <creator_id>2017-11-11 11:11:11</creator_id>
                <id>123123</id>
                <level>1</level>
                <modified>2017-11-23 12:11:12</modified>
                <modifier_id>123231</modifier_id>
                <out_id>34344</out_id>
                <properties>
                    <property_dto>
                        <p_alias></p_alias>
                        <p_custom_name></p_custom_name>
                        <p_id></p_id>
                        <p_name></p_name>
                        <v_alias></v_alias>
                        <v_custom_name></v_custom_name>
                        <v_id></v_id>
                        <v_name></v_name>
                        <img_url>https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg</img_url>
                        <order>1</order>
                        <property_type>sale</property_type>
                    </property_dto>
                </properties>
                <spu>
                    <barcode_str>023343434</barcode_str>
                    <brand_id>23485</brand_id>
                    <brand_name>阿迪达斯</brand_name>
                    <cat_name>女士</cat_name>
                    <cid>1000098</cid>
                    <created>2017-06-09 11:20:32</created>
                    <id>56756</id>
                    <is_new>true</is_new>
                    <level>4</level>
                    <material>图片地址</material>
                    <mdesc>女士运动卫衣</mdesc>
                    <modified>2017-11-12 11:11:11</modified>
                    <pc_desc>女士运动卫衣</pc_desc>
                    <pic_url>https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg</pic_url>
                    <price>200.12</price>
                    <product_id>23455445</product_id>
                    <product_imgs>
                        <product_img_dto>
                            <id>234234</id>
                            <position>1</position>
                            <url>https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg</url>
                        </product_img_dto>
                    </product_imgs>
                    <props>
                        <property_dto>
                            <p_alias></p_alias>
                            <p_custom_name></p_custom_name>
                            <p_id></p_id>
                            <p_name></p_name>
                            <v_alias></v_alias>
                            <v_custom_name></v_custom_name>
                            <v_id></v_id>
                            <v_name></v_name>
                            <img_url>https://gdp.alicdn.com/imgextra/i3/912835464/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg</img_url>
                            <order>1</order>
                            <property_type>sale</property_type>
                        </property_dto>
                    </props>
                    <rate_num>1</rate_num>
                    <sell_pt>明细同款</sell_pt>
                    <status>1</status>
                    <style_no>020714898342</style_no>
                    <sub_title>短款卫衣</sub_title>
                    <tags>{&quot;colorCode&quot;:&quot;0901&quot;,&quot;colorName&quot;:&quot;红色&quot;}</tags>
                    <title>女士卫衣</title>
                </spu>
                <standard>true</standard>
                <status>1</status>
                <style_no>020714898342</style_no>
                <sub_title>卫衣</sub_title>
                <tag_price>40.15</tag_price>
                <title>卫衣</title>
                <user_type></user_type>
            </cspudto>
        </list>
        <page_size>10</page_size>
        <total_count>20</total_count>
        <total_page>2</total_page>
    </data>
</alibaba_mos_goods_searchcspu_response>

{
    "alibaba_mos_goods_searchcspu_response":{
        "data":{
            "current_page":1,
            "list":{
                "cspudto":[
                    {
                        "art_no":"234234",
                        "barcode":"4857694444",
                        "created":"2017-11-11 11:11:11",
                        "creator_id":"2017-11-11 11:11:11",
                        "id":"123123",
                        "level":1,
                        "modified":"2017-11-23 12:11:12",
                        "modifier_id":"123231",
                        "out_id":"34344",
                        "properties":{
                            "property_dto":[
                                {
                                    "p_alias":"",
                                    "p_custom_name":"",
                                    "p_id":"",
                                    "p_name":"",
                                    "v_alias":"",
                                    "v_custom_name":"",
                                    "v_id":"",
                                    "v_name":"",
                                    "img_url":"https:\/\/gdp.alicdn.com\/imgextra\/i3\/912835464\/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg",
                                    "order":1,
                                    "property_type":"sale"
                                }
                            ]
                        },
                        "spu":{
                            "barcode_str":"023343434",
                            "brand_id":"23485",
                            "brand_name":"阿迪达斯",
                            "cat_name":"女士",
                            "cid":"1000098",
                            "created":"2017-06-09 11:20:32",
                            "id":"56756",
                            "is_new":true,
                            "level":4,
                            "material":"图片地址",
                            "mdesc":"女士运动卫衣",
                            "modified":"2017-11-12 11:11:11",
                            "pc_desc":"女士运动卫衣",
                            "pic_url":"https:\/\/gdp.alicdn.com\/imgextra\/i3\/912835464\/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg",
                            "price":"200.12",
                            "product_id":"23455445",
                            "product_imgs":{
                                "product_img_dto":[
                                    {
                                        "id":234234,
                                        "position":1,
                                        "url":"https:\/\/gdp.alicdn.com\/imgextra\/i3\/912835464\/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg"
                                    }
                                ]
                            },
                            "props":{
                                "property_dto":[
                                    {
                                        "p_alias":"",
                                        "p_custom_name":"",
                                        "p_id":"",
                                        "p_name":"",
                                        "v_alias":"",
                                        "v_custom_name":"",
                                        "v_id":"",
                                        "v_name":"",
                                        "img_url":"https:\/\/gdp.alicdn.com\/imgextra\/i3\/912835464\/TB2jlCOdr1YBuNjSszeXXablFXa_!!912835464.jpg",
                                        "order":1,
                                        "property_type":"sale"
                                    }
                                ]
                            },
                            "rate_num":1,
                            "sell_pt":"明细同款",
                            "status":1,
                            "style_no":"020714898342",
                            "sub_title":"短款卫衣",
                            "tags":"{\"colorCode\":\"0901\",\"colorName\":\"红色\"}",
                            "title":"女士卫衣"
                        },
                        "standard":true,
                        "status":1,
                        "style_no":"020714898342",
                        "sub_title":"卫衣",
                        "tag_price":"40.15",
                        "title":"卫衣",
                        "user_type":""
                    }
                ]
            },
            "page_size":10,
            "total_count":20,
            "total_page":2
        }
    }
}

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下载

银泰scm-openapi

alibaba.mos.goods.searchcspu (cspu查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ