淘宝开放平台 - 文档中心

请求地址：

环境	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_feedback_query_base	FeedbackQueryBase	可选			系统自动生成
└ browser_type String 可选 Chrome 浏览器类别 └ browser_version String 可选 8.0 浏览器版本 └ cfs String 可选自定义属性值map └ city String 可选杭州市城市 └ crawler_keywords String 可选上市社会舆情抓取关键字 └ created_at_begin String 可选 2014-12-12 00:00:00 反馈创建时间范围起始时间 └ created_at_end String 可选 hello world 反馈创建时间范围结束时间 └ description String 可选 hello world 反馈详细描述 └ device_model String 可选 hello world 设备型号，如”GT-I9300“ └ emotion_tendency Number 可选 1 情感极性，0：中性，1：正面，-1：负面 └ feedback_classify String 可选咨询反馈分类，可能值：系统bug、咨询、建议、其他 └ feedback_type Number 可选 0 反馈类型，0：产品反馈，1：外部舆情 └ filter_type Number 可选 6 过滤类型，0关键词，1来源名，2网站URL，3智能过滤，4微博粉丝/转发数，5微博白名单，6未匹配任何正向规则 └ id Number 可选 123 反馈记录ID └ importance Number 可选 1 重要程度，0：unimportant，1：normal，2：important └ ip String 可选 10.0.0.10 用户IP └ is_jailbreak Boolean 可选 false 设备是否被越狱/root/破解 └ is_replied Boolean 可选 false 是否被回复 └ network_operator String 可选电信网络运营商 └ network_type String 可选 WIFI 网络类别 └ os_type Number 可选 0 操作系统类别，0：Android，1：iOs，2：Windows，3：Mac，4：linux，5：unknown └ os_version String 可选 7 操作系统版本 └ page_index Number 可选 1 页号，从1开始，默认值为1 └ page_size Number 可选 20 分页大小，默认值为20 └ priority Number 可选 1 优先级，0:low,1:medium,2:high └ proc_status Number 可选 0 反馈被处理状态，0：未解决，1：已解决，2：已响应 └ product_id Number 可选 123 产品ID └ product_type Number 可选 0 产品类别，0：mobile，1：pc，2：web └ product_version String 可选 1.0.0 产品版本号 └ province String 可选浙江省省份 └ resolution String 可选 1024*768 设备分辨率 └ source String 可选 pc 反馈数据来源标识 └ subject String 可选 hello world 反馈标题 └ tags String [] 可选 ["功能","登录"] 反馈的标签列表 └ tags_empty Boolean 可选 false 标签是否为空 └ tb_nickname String 可选 hello world 淘宝用户nick └ tb_user_id Number 可选 123 淘宝用户ID └ updated_at_begin String 可选 2014-12-12 00:00:00 反馈更新时间范围起始时间 └ updated_at_end String 可选 2014-12-12 00:00:00 反馈更新时间范围结束时间 └ user_agent String 可选 Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Firefox/31.0 http请求的user-agent头域 └ valid_status Number 可选 0 有效状态，0：invalid，1：valid └ monitor_topic_id Number 可选 1 关键词专题id └ read_status Number 可选 0 已读未读标记

名称	类型	示例值	描述
page_size	Number	20	分页大小
result_list	ApsFeedbackResult []		反馈数据列表
└ account_type Number 0 用户类别，0：其他，1：小二 └ attachments String {"1":"http://xxxx.jpg","2":"http://yyy.jpg"} 附件信息map，key为附件ID，value为附件url └ browser_type String Chrome 浏览器类别 └ browser_version String 8.0 浏览器版本 └ cfs String {"1":"value1","2":"value2"} 自定义属性值map └ city String 杭州市城市 └ created_at Date 2014-12-23 10:08:24 创建时间 └ created_at_about_time_format String 1小时前创建时间阅读格式 └ created_at_str String 2014-10-23 15:33:22 创建时间 └ description String hello world 反馈详细描述 └ device_model String GT-I9300 设备型号 └ emotion_tendency Number 1 情感极性，0：中性，1：正面，-1：负面 └ feedback_classify String 咨询反馈分类 └ feedback_type Number 0 反馈类型，0：产品反馈，1：外部舆情 └ filter_type Number 6 过滤类型，0关键词，1来源名，2网站URL，3智能过滤，4微博粉丝/转发数，5微博白名单，6未匹配任何正向规则 └ id Number 123 反馈记录ID └ importance Number 1 重要程度，0：unimportant，1：normal，2：important └ ip String 10.0.0.10 用户IP └ is_jailbreak Boolean false 设备是否被越狱/root/破解 └ is_replied Boolean false 反馈是否已被回复 └ issue_at Date 2014-12-23 10:08:24 反馈数据相关任务的创建时间 └ network_operator String 电信网络运营商 └ network_type String WIFI 网络类别 └ os_type Number 0 操作系统类别，0：Android，1：iOs，2：Windows，3：Mac，4：linux，5：unknown └ os_version String 7 操作系统版本 └ priority Number 1 优先级，0：low，1：medium，2：high └ proc_status Number 0 反馈被处理状态，0：未解决，1：已解决，2：已响应 └ product_id Number 123 产品ID └ product_type Number 0 产品类别，0：mobile，1：pc，2：web └ product_version String 1.0.0 产品版本号 └ province String 浙江省省份 └ referer_url String http://www.taobao.com 反馈相关url └ resolution String 1024*768 设备分辨率 └ source String pc 反馈数据来源标识 └ source_feedback_id Number 123 原始反馈ID └ source_product String hello world 未使用属性 └ subject String hello world 反馈标题 └ tag_ids Number [] [123,456] 未使用属性 └ tags String {"1":"标签1","2":"标签2"} 标签信息map，key为标签ID，value为标签名称 └ tb_nickname String helloworld 淘宝用户nick └ tb_user_id Number 123 淘宝用户ID └ updated_at Date 2014-12-23 10:08:24 更新时间 └ user_agent String Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Firefox/31.0 http请求的user-agent头域 └ valid Boolean false 未使用属性 └ valid_content String demo valid_content └ valid_status Number 0 有效状态，0：invalid，1：valid └ crawler_keywords String 支付宝舆情抓取的关键字 └ emotion_confirm_tendency Number 0 人工标注的情感极性0中性 1正面 -1负面 └ emotion_category Number 0 情感分类 └ emotion_score Number 72 情感分数 └ read_status Number 0 0：未读1：已读
page_index	Number	1	分页号
total_count	Number	200	总记录数

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
KeludeApsFeedbackSimplesearchRequest req = new KeludeApsFeedbackSimplesearchRequest();
KeludeApsFeedbackSimplesearchRequest.FeedbackQueryBase obj1 = new KeludeApsFeedbackSimplesearchRequest.FeedbackQueryBase();
obj1.setBrowserType("Chrome");
obj1.setBrowserVersion("8.0");
obj1.setCfs("");
obj1.setCity("杭州市");
obj1.setCluster("登录功能不可用");
obj1.setCrawlerKeywords("上市");
obj1.setCreatedAtBegin("2014-12-12 00:00:00");
obj1.setCreatedAtEnd("hello world");
obj1.setDescription("hello world");
obj1.setDeviceModel("hello world");
obj1.setEmotionTendency(1L);
obj1.setFeedbackClassify("咨询");
obj1.setFeedbackType(0L);
obj1.setFilterType(6L);
obj1.setId(123L);
obj1.setImportance(1L);
obj1.setIp("10.0.0.10");
obj1.setIsJailbreak(false);
obj1.setIsReplied(false);
obj1.setNetworkOperator("电信");
obj1.setNetworkType("WIFI");
obj1.setOsType(0L);
obj1.setOsVersion("7");
obj1.setPageIndex(1L);
obj1.setPageSize(20L);
obj1.setPriority(1L);
obj1.setProcStatus(0L);
obj1.setProductId(123L);
obj1.setProductType(0L);
obj1.setProductVersion("1.0.0");
obj1.setProvince("浙江省");
obj1.setResolution("1024*768");
obj1.setSource("pc");
obj1.setSubject("hello world");
obj1.setTags(""功能","登录"");
obj1.setTagsAnd(false);
obj1.setTagsEmpty(false);
obj1.setTbNickname("hello world");
obj1.setTbUserId(123L);
obj1.setUpdatedAtBegin("2014-12-12 00:00:00");
obj1.setUpdatedAtEnd("2014-12-12 00:00:00");
obj1.setUserAgent("Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Firefox/31.0");
obj1.setValidStatus(0L);
obj1.setMonitorTopicId(1L);
obj1.setReadStatus(0L);
req.setParamFeedbackQueryBase(obj1);
KeludeApsFeedbackSimplesearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
KeludeApsFeedbackSimplesearchRequest req = new KeludeApsFeedbackSimplesearchRequest();
KeludeApsFeedbackSimplesearchRequest.FeedbackQueryBaseDomain obj1 = new KeludeApsFeedbackSimplesearchRequest.FeedbackQueryBaseDomain();
obj1.BrowserType = "Chrome";
obj1.BrowserVersion = "8.0";
obj1.Cfs = "";
obj1.City = "杭州市";
obj1.Cluster = "登录功能不可用";
obj1.CrawlerKeywords = "上市";
obj1.CreatedAtBegin = "2014-12-12 00:00:00";
obj1.CreatedAtEnd = "hello world";
obj1.Description = "hello world";
obj1.DeviceModel = "hello world";
obj1.EmotionTendency = 1L;
obj1.FeedbackClassify = "咨询";
obj1.FeedbackType = 0L;
obj1.FilterType = 6L;
obj1.Id = 123L;
obj1.Importance = 1L;
obj1.Ip = "10.0.0.10";
obj1.IsJailbreak = false;
obj1.IsReplied = false;
obj1.NetworkOperator = "电信";
obj1.NetworkType = "WIFI";
obj1.OsType = 0L;
obj1.OsVersion = "7";
obj1.PageIndex = 1L;
obj1.PageSize = 20L;
obj1.Priority = 1L;
obj1.ProcStatus = 0L;
obj1.ProductId = 123L;
obj1.ProductType = 0L;
obj1.ProductVersion = "1.0.0";
obj1.Province = "浙江省";
obj1.Resolution = "1024*768";
obj1.Source = "pc";
obj1.Subject = "hello world";
obj1.Tags = ""功能","登录"";
obj1.TagsAnd = false;
obj1.TagsEmpty = false;
obj1.TbNickname = "hello world";
obj1.TbUserId = 123L;
obj1.UpdatedAtBegin = "2014-12-12 00:00:00";
obj1.UpdatedAtEnd = "2014-12-12 00:00:00";
obj1.UserAgent = "Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Firefox/31.0";
obj1.ValidStatus = 0L;
obj1.MonitorTopicId = 1L;
obj1.ReadStatus = 0L;
req.ParamFeedbackQueryBase_ = obj1;
KeludeApsFeedbackSimplesearchResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new KeludeApsFeedbackSimplesearchRequest;
$param_feedback_query_base = new FeedbackQueryBase;
$param_feedback_query_base->browser_type="Chrome";
$param_feedback_query_base->browser_version="8.0";
$param_feedback_query_base->cfs="";
$param_feedback_query_base->city="杭州市";
$param_feedback_query_base->cluster="登录功能不可用";
$param_feedback_query_base->crawler_keywords="上市";
$param_feedback_query_base->created_at_begin="2014-12-12 00:00:00";
$param_feedback_query_base->created_at_end="hello world";
$param_feedback_query_base->description="hello world";
$param_feedback_query_base->device_model="hello world";
$param_feedback_query_base->emotion_tendency="1";
$param_feedback_query_base->feedback_classify="咨询";
$param_feedback_query_base->feedback_type="0";
$param_feedback_query_base->filter_type="6";
$param_feedback_query_base->id="123";
$param_feedback_query_base->importance="1";
$param_feedback_query_base->ip="10.0.0.10";
$param_feedback_query_base->is_jailbreak="false";
$param_feedback_query_base->is_replied="false";
$param_feedback_query_base->network_operator="电信";
$param_feedback_query_base->network_type="WIFI";
$param_feedback_query_base->os_type="0";
$param_feedback_query_base->os_version="7";
$param_feedback_query_base->page_index="1";
$param_feedback_query_base->page_size="20";
$param_feedback_query_base->priority="1";
$param_feedback_query_base->proc_status="0";
$param_feedback_query_base->product_id="123";
$param_feedback_query_base->product_type="0";
$param_feedback_query_base->product_version="1.0.0";
$param_feedback_query_base->province="浙江省";
$param_feedback_query_base->resolution="1024*768";
$param_feedback_query_base->source="pc";
$param_feedback_query_base->subject="hello world";
$param_feedback_query_base->tags="[\"功能\",\"登录\"]";
$param_feedback_query_base->tags_and="false";
$param_feedback_query_base->tags_empty="false";
$param_feedback_query_base->tb_nickname="hello world";
$param_feedback_query_base->tb_user_id="123";
$param_feedback_query_base->updated_at_begin="2014-12-12 00:00:00";
$param_feedback_query_base->updated_at_end="2014-12-12 00:00:00";
$param_feedback_query_base->user_agent="Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Firefox/31.0";
$param_feedback_query_base->valid_status="0";
$param_feedback_query_base->monitor_topic_id="1";
$param_feedback_query_base->read_status="0";
$req->setParamFeedbackQueryBase(json_encode($param_feedback_query_base));
$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.kelude.aps.feedback.simplesearch' \
-d 'partner_id=apidoc' \
-d 'sign=88B036693159DC5B50E81B45FD268C15' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+16%3A05%3A49' \
-d 'v=2.0' \
-d 'param_feedback_query_base=null'

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

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

req.param_feedback_query_base=""
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.kelude.aps.feedback.simplesearch");
add_param(pRequest,"param_feedback_query_base","数据结构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.kelude.aps.feedback.simplesearch', {
	'param_feedback_query_base':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<kelude_aps_feedback_simplesearch_response>
    <page_size>20</page_size>
    <result_list>
        <aps_feedback_result>
            <account_type>0</account_type>
            <attachments>{&quot;1&quot;:&quot;http://xxxx.jpg&quot;,&quot;2&quot;:&quot;http://yyy.jpg&quot;}</attachments>
            <browser_type>Chrome</browser_type>
            <browser_version>8.0</browser_version>
            <cfs>{&quot;1&quot;:&quot;value1&quot;,&quot;2&quot;:&quot;value2&quot;}</cfs>
            <city>杭州市</city>
            <created_at>2014-12-23 10:08:24</created_at>
            <created_at_about_time_format>1小时前</created_at_about_time_format>
            <created_at_str>2014-10-23 15:33:22</created_at_str>
            <description>hello world</description>
            <device_model>GT-I9300</device_model>
            <emotion_tendency>1</emotion_tendency>
            <feedback_classify>咨询</feedback_classify>
            <feedback_type>0</feedback_type>
            <filter_type>6</filter_type>
            <id>123</id>
            <importance>1</importance>
            <ip>10.0.0.10</ip>
            <is_jailbreak>false</is_jailbreak>
            <is_replied>false</is_replied>
            <issue_at>2014-12-23 10:08:24</issue_at>
            <network_operator>电信</network_operator>
            <network_type>WIFI</network_type>
            <os_type>0</os_type>
            <os_version>7</os_version>
            <priority>1</priority>
            <proc_status>0</proc_status>
            <product_id>123</product_id>
            <product_type>0</product_type>
            <product_version>1.0.0</product_version>
            <province>浙江省</province>
            <referer_url>http://www.taobao.com</referer_url>
            <resolution>1024*768</resolution>
            <source>pc</source>
            <source_feedback_id>123</source_feedback_id>
            <source_product>hello world</source_product>
            <subject>hello world</subject>
            <tag_ids>
                <number>[123</number>
                <number>456]</number>
            </tag_ids>
            <tags>{&quot;1&quot;:&quot;标签1&quot;,&quot;2&quot;:&quot;标签2&quot;}</tags>
            <tb_nickname>helloworld</tb_nickname>
            <tb_user_id>123</tb_user_id>
            <updated_at>2014-12-23 10:08:24</updated_at>
            <user_agent>Mozilla/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko/20100101 Firefox/31.0</user_agent>
            <valid>false</valid>
            <valid_content>demo</valid_content>
            <valid_status>0</valid_status>
            <crawler_keywords>支付宝</crawler_keywords>
            <emotion_confirm_tendency>0</emotion_confirm_tendency>
            <emotion_category>0</emotion_category>
            <emotion_score>72</emotion_score>
            <read_status>0</read_status>
        </aps_feedback_result>
    </result_list>
    <page_index>1</page_index>
    <total_count>200</total_count>
</kelude_aps_feedback_simplesearch_response>

{
    "kelude_aps_feedback_simplesearch_response":{
        "page_size":20,
        "result_list":{
            "aps_feedback_result":[
                {
                    "account_type":0,
                    "attachments":"{\"1\":\"http:\/\/xxxx.jpg\",\"2\":\"http:\/\/yyy.jpg\"}",
                    "browser_type":"Chrome",
                    "browser_version":"8.0",
                    "cfs":"{\"1\":\"value1\",\"2\":\"value2\"}",
                    "city":"杭州市",
                    "created_at":"2014-12-23 10:08:24",
                    "created_at_about_time_format":"1小时前",
                    "created_at_str":"2014-10-23 15:33:22",
                    "description":"hello world",
                    "device_model":"GT-I9300",
                    "emotion_tendency":1,
                    "feedback_classify":"咨询",
                    "feedback_type":0,
                    "filter_type":6,
                    "id":123,
                    "importance":1,
                    "ip":"10.0.0.10",
                    "is_jailbreak":false,
                    "is_replied":false,
                    "issue_at":"2014-12-23 10:08:24",
                    "network_operator":"电信",
                    "network_type":"WIFI",
                    "os_type":0,
                    "os_version":"7",
                    "priority":1,
                    "proc_status":0,
                    "product_id":123,
                    "product_type":0,
                    "product_version":"1.0.0",
                    "province":"浙江省",
                    "referer_url":"http:\/\/www.taobao.com",
                    "resolution":"1024*768",
                    "source":"pc",
                    "source_feedback_id":123,
                    "source_product":"hello world",
                    "subject":"hello world",
                    "tag_ids":{
                        "number":[
                            [123,
                            456]
                        ]
                    },
                    "tags":"{\"1\":\"标签1\",\"2\":\"标签2\"}",
                    "tb_nickname":"helloworld",
                    "tb_user_id":123,
                    "updated_at":"2014-12-23 10:08:24",
                    "user_agent":"Mozilla\/5.0 (Windows NT 6.1; WOW64; rv:31.0) Gecko\/20100101 Firefox\/31.0",
                    "valid":false,
                    "valid_content":"demo",
                    "valid_status":0,
                    "crawler_keywords":"支付宝",
                    "emotion_confirm_tendency":0,
                    "emotion_category":0,
                    "emotion_score":72,
                    "read_status":0
                }
            ]
        },
        "page_index":1,
        "total_count":200
    }
}

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

错误码	错误描述	解决方案
isp.query-attachment-failed	查询附件信息失败	联系接口提供方解决
isp.query-feedback-failed	查询反馈数据失败	联系接口提供方解决

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

开放平台

测试API

taobao.kelude.aps.feedback.simplesearch (反馈数据查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ