淘宝开放平台 - 文档中心

请求地址：

环境	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	TopSearchProjectParam	可选			入参对象
└ category_name String 可选演唱会一级分类名，支持多个（之间是OR关系），以"\|"隔开。演唱会,音乐会,话剧歌剧,舞蹈芭蕾,曲苑杂坛,体育比赛,度假休闲,儿童亲子,旅游演艺,韩流地带,动漫,旅游展览 └ page_number Number 可选 1 页码 └ page_size Number 可选 10 每页大小,上限50条，不传默认10条 └ artist_name String 可选周杰伦关联艺人姓名（之间是OR关系），以"\|"隔开 └ sub_category_name String 可选流行子分类，支持多个（之间是OR关系），以"\|"隔开一级分类对应子分类如下，演唱会:(摇滚,民族,流行,音乐节,其他) 音乐会:(声乐及合唱,室内乐及古乐,独奏,管弦乐,其他) 话剧歌剧:(儿童剧,歌剧,歌舞剧,话剧,音乐剧) 舞蹈芭蕾:(舞剧,舞蹈,芭蕾) 曲苑杂坛:(戏曲,杂技,相声,马戏,魔术,其他) 体育比赛:(冰雪,搏击运动,格斗,球类运动,田径,电竞,篮球,网球,赛车,足球,其它竞技,其他) 度假休闲:(主题公园,代金券,展会,度假村,温泉,游览线路,滑雪,特色体验,风景区) └ keyword String 可选周杰伦搜索关键字 └ filter_city_name String 可选北京过滤城市名，支持多个（之间是OR关系），以"\|"隔开 └ sort_type Number 可选 0 排序类型 1: 上架时间倒排序 2: 最近场次演出时间排序 0:按相关度降序 3:热门排序, 默认 0 └ date_type Number 可选 1 0：无强指定 1:今天 2：明天 3：周末 4:30天内 5:自定义 6: 本周 7：本月 8：本月周末场 └ start_date String 可选 2018-11-12 开始日期，格式yyyy-MM-dd └ end_date String 可选 2018-11-16 结束日期，格式yyyy-MM-dd └ channel String 可选 10001\|10002 渠道（之间是OR关系），以"\|"隔开。10001, "大麦app" * 10002, "大麦pc" * 10003, "大麦h5" * 20000, "天猫" * 30000, "支付宝" * 40000, "淘票票" * 50000, "其他"

名称	类型	示例值	描述
result	MpResult	{}	返回结果
model QueryProjectResult {} model projects ProjectDto [] [] 项目信息 └ city_name String 上海演出城市 └ show_time String 2016.07.01-2016.07.03 演出时间 └ category_name String 演唱会项目主类 └ perform_start_time String 1554982200000 场次开始时间 └ vertical_pic String //pimg.damai.cn/perform/project/951/95181_n.jpg 项目图片地址 └ name String 地表最强世界巡回演唱会-上海站项目名称 └ actors String 艺人: 周杰伦艺人数据 └ venue_city String 上海场馆城市 └ sell_end_time Number 1562153400000 结束售卖时间 └ venue_name String 上海梅赛德斯奔驰文化中心（上海世博文化中心）场馆名称 └ promotion_price String 15-450 优惠价格 └ up_time String 1137724269000 上架时间 └ artist_name String 羽泉\t五月天关联艺人 └ sub_category_name String 流行项目子类 └ tours String 北京站巡演信息 └ brand_name String 开心麻花关联品牌 └ site_status String 3 商品状态 3:售票中 └ sub_head String 一场爆笑、乱套，又暖又搞的麻花新剧即将上演推荐语 extra_info_map Extrainfomap {} 扩展信息 └ buy_url String www.daimai.cn?abc=1 购票链接 └ is_e_ticket String 1 是否电子票 1:是，0:非 └ is_select_seat String 1 是否选座 1:是,0:非 └ sub_title String 婿事待发短标题 └ price_str String 100-300-100 价格字符串 └ venue_id Number 123 演出场馆id └ latitude String 0.1 纬度 └ longitude String 0.1 经度 └ error_msg String 网络异常错误信息 └ success Boolean true 是否调用成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiEcSearchProjectSearchRequest req = new AlibabaDamaiEcSearchProjectSearchRequest();
AlibabaDamaiEcSearchProjectSearchRequest.TopSearchProjectParam obj1 = new AlibabaDamaiEcSearchProjectSearchRequest.TopSearchProjectParam();
obj1.setCategoryName("演唱会");
obj1.setPageNumber(1L);
obj1.setPageSize(10L);
obj1.setArtistName("周杰伦");
obj1.setSubCategoryName("流行");
obj1.setKeyword("周杰伦");
obj1.setFilterCityName("北京");
obj1.setSortType(0L);
obj1.setDateType(1L);
obj1.setStartDate("2018-11-12");
obj1.setEndDate("2018-11-16");
obj1.setChannel("10001|10002");
req.setParam(obj1);
AlibabaDamaiEcSearchProjectSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiEcSearchProjectSearchRequest req = new AlibabaDamaiEcSearchProjectSearchRequest();
AlibabaDamaiEcSearchProjectSearchRequest.TopSearchProjectParamDomain obj1 = new AlibabaDamaiEcSearchProjectSearchRequest.TopSearchProjectParamDomain();
obj1.CategoryName = "演唱会";
obj1.PageNumber = 1L;
obj1.PageSize = 10L;
obj1.ArtistName = "周杰伦";
obj1.SubCategoryName = "流行";
obj1.Keyword = "周杰伦";
obj1.FilterCityName = "北京";
obj1.SortType = 0L;
obj1.DateType = 1L;
obj1.StartDate = "2018-11-12";
obj1.EndDate = "2018-11-16";
obj1.Channel = "10001|10002";
req.Param_ = obj1;
AlibabaDamaiEcSearchProjectSearchResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiEcSearchProjectSearchRequest;
$param = new TopSearchProjectParam;
$param->category_name="演唱会";
$param->page_number="1";
$param->page_size="10";
$param->artist_name="周杰伦";
$param->sub_category_name="流行";
$param->keyword="周杰伦";
$param->filter_city_name="北京";
$param->sort_type="0";
$param->date_type="1";
$param->start_date="2018-11-12";
$param->end_date="2018-11-16";
$param->channel="10001|10002";
$req->setParam(json_encode($param));
$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=alibaba.damai.ec.search.project.search' \
-d 'partner_id=apidoc' \
-d 'sign=1B6A95DD9B4E291DCFE63C4AD33C7843' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-13+09%3A56%3A20' \
-d 'v=2.0' \
-d 'param=null'

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

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

req.param=""
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,"alibaba.damai.ec.search.project.search");
add_param(pRequest,"param","数据结构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('alibaba.damai.ec.search.project.search', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_ec_search_project_search_response>
    <result>
        <model>
            <projects>
                <project_dto>
                    <city_name>上海</city_name>
                    <show_time>2016.07.01-2016.07.03</show_time>
                    <category_name>演唱会</category_name>
                    <perform_start_time>1554982200000</perform_start_time>
                    <vertical_pic>//pimg.damai.cn/perform/project/951/95181_n.jpg</vertical_pic>
                    <name>地表最强世界巡回演唱会-上海站</name>
                    <actors>艺人: 周杰伦</actors>
                    <venue_city>上海</venue_city>
                    <sell_end_time>1562153400000</sell_end_time>
                    <venue_name>上海梅赛德斯奔驰文化中心（上海世博文化中心）</venue_name>
                    <promotion_price>15-450</promotion_price>
                    <up_time>1137724269000</up_time>
                    <artist_name>羽泉\t五月天</artist_name>
                    <sub_category_name>流行</sub_category_name>
                    <tours>北京站</tours>
                    <brand_name>开心麻花</brand_name>
                    <site_status>3</site_status>
                    <sub_head>一场爆笑、乱套，又暖又搞的麻花新剧即将上演</sub_head>
                    <extra_info_map>
                        <buy_url>www.daimai.cn?abc=1</buy_url>
                    </extra_info_map>
                    <is_e_ticket>1</is_e_ticket>
                    <is_select_seat>1</is_select_seat>
                    <sub_title>婿事待发</sub_title>
                    <price_str>100-300-100</price_str>
                    <venue_id>123</venue_id>
                    <latitude>0.1</latitude>
                    <longitude>0.1</longitude>
                </project_dto>
            </projects>
        </model>
        <error_msg>网络异常</error_msg>
        <success>true</success>
    </result>
</alibaba_damai_ec_search_project_search_response>

{
    "alibaba_damai_ec_search_project_search_response":{
        "result":{
            "model":{
                "projects":{
                    "project_dto":[
                        {
                            "city_name":"上海",
                            "show_time":"2016.07.01-2016.07.03",
                            "category_name":"演唱会",
                            "perform_start_time":"1554982200000",
                            "vertical_pic":"\/\/pimg.damai.cn\/perform\/project\/951\/95181_n.jpg",
                            "name":"地表最强世界巡回演唱会-上海站",
                            "actors":"艺人: 周杰伦",
                            "venue_city":"上海",
                            "sell_end_time":1562153400000,
                            "venue_name":"上海梅赛德斯奔驰文化中心（上海世博文化中心）",
                            "promotion_price":"15-450",
                            "up_time":"1137724269000",
                            "artist_name":"羽泉\\t五月天",
                            "sub_category_name":"流行",
                            "tours":"北京站",
                            "brand_name":"开心麻花",
                            "site_status":"3",
                            "sub_head":"一场爆笑、乱套，又暖又搞的麻花新剧即将上演",
                            "extra_info_map":{
                                "buy_url":"www.daimai.cn?abc=1"
                            },
                            "is_e_ticket":"1",
                            "is_select_seat":"1",
                            "sub_title":"婿事待发",
                            "price_str":"100-300-100",
                            "venue_id":123,
                            "latitude":"0.1",
                            "longitude":"0.1"
                        }
                    ]
                }
            },
            "error_msg":"网络异常",
            "success":true
        }
    }
}

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

alibaba.damai.ec.search.project.search (大麦电商对外搜索服务)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ