阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	描述
stat_date_start	String	可选	2025-03-03	日期开始
stat_date_end	String	可选	2025-03-03	日期结束
sq_bid_list	Number	可选	11,22,33	书旗BID集合
book_id_online_list	Number	可选	11,22,33	原创线上书籍BID集合
book_name	String	可选	书籍名称	书籍名称
pen_name	String	可选	作者	作者
channel_id_list	Number	可选	111,222,333	分销渠道Id集合
first_distribute_time_start	String	可选	2025-03-03 16:45:07	开始分销时间-开始
first_distribute_time_end	String	可选	2025-03-03 16:45:07	开始分销时间-结束
sex_list	Number	可选	1,2	男女频 1男2女
class_id_list	Number	可选	123,456	一级分类ID（多选）
second_class_id_list	Number	可选	123,456	二级分类ID（对选）
size_start	String	可选	1	字数区间（支持单选）万字
size_end	String	可选	2	字数区间（支持单选）万字
state_list	Number	可选	1,2	连载状态（多选）1连载2完结
order	String	可选	sq_bid	排序字段
sort	String	可选	desc	升降序字段
page	Number	可选	1	页数
page_size	Number	可选	100	每页条数
is_export	Number	可选	0	是否导出（0不导出 1导出）
emp_id	String	可选	WB873525	导出工号
is_important	Number	可选	0	是否重点书：0.非重点 1.重点

名称	类型	示例值	描述
result	CommResult	1	result
data RankingListResp 1 data └ total Number 1 total └ pages Number 1 pages list BookInfo [] lsit └ stat_date String 2025-03-03 日期 └ sq_bid Number 111 书旗BID └ book_id_online Number 222 原创线上BID └ book_name String 书籍名称书籍名称 └ pen_name String 作者作者 └ channel_name String 分销渠道名称分销渠道 └ reading_num Number 1 在读人数 └ reading_num_dod String 0.2 在读人数-日环比 └ score String 9 评分 └ score_incr String 0.2 评分-变动 └ qimao_bidu_rank Number 1 七猫必读榜排名 └ qimao_bidu_rank_incr Number 7 七猫必读榜排名-变动 └ qimao_biaosheng_rank Number 1 七猫飙升榜排名 └ qimao_biaosheng_rank_incr Number 7 七猫飙升榜排名-变动 └ qimao_dare_rank Number 1 七猫大热榜排名 └ qimao_dare_rank_incr Number 7 七猫大热榜排名-变动 └ fanqie_dianfeng_rank Number 1 番茄巅峰榜排名 └ fanqie_dianfeng_rank_incr Number 7 番茄巅峰榜排名-变动 └ fanqie_yuedu_rank Number 1 番茄阅读榜排名 └ fanqie_yuedu_rank_incr Number 7 番茄阅读榜排名-变动 └ first_distribute_time String 2025-03-03 16:45:07 开始分销时间 └ sex String 男男女频 └ class_name String 一级分类名称一级分类 └ second_class_name String 二级分类名称二级分类 └ size Number 27000 字数 └ state String 完结连载状态 └ id Number 123 ID └ is_important String 重点书是否重点书：0.非重点 1.重点 └ has_compare String 无是否有对比 0.无 1.有 └ state Number 1 state └ message String 1 message

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaShuqiOriginalCrawlerDistributeBooklistRequest req = new AlibabaShuqiOriginalCrawlerDistributeBooklistRequest();
req.setStatDateStart("2025-03-03");
req.setStatDateEnd("2025-03-03");
req.setSqBidList(11,22,33L);
req.setBookIdOnlineList(11,22,33L);
req.setBookName("书籍名称");
req.setPenName("作者");
req.setChannelIdList(111,222,333L);
req.setFirstDistributeTimeStart("2025-03-03 16:45:07");
req.setFirstDistributeTimeEnd("2025-03-03 16:45:07");
req.setSexList(1,2L);
req.setClassIdList(123,456L);
req.setSecondClassIdList(123,456L);
req.setSizeStart("1");
req.setSizeEnd("2");
req.setStateList(1,2L);
req.setOrder("sq_bid");
req.setSort("desc");
req.setPage(1L);
req.setPageSize(100L);
req.setIsExport(0L);
req.setEmpId("WB873525");
req.setIsImportant(0L);
AlibabaShuqiOriginalCrawlerDistributeBooklistResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaShuqiOriginalCrawlerDistributeBooklistRequest req = new AlibabaShuqiOriginalCrawlerDistributeBooklistRequest();
req.StatDateStart = "2025-03-03";
req.StatDateEnd = "2025-03-03";
req.SqBidList = 11,22,33L;
req.BookIdOnlineList = 11,22,33L;
req.BookName = "书籍名称";
req.PenName = "作者";
req.ChannelIdList = 111,222,333L;
req.FirstDistributeTimeStart = "2025-03-03 16:45:07";
req.FirstDistributeTimeEnd = "2025-03-03 16:45:07";
req.SexList = 1,2L;
req.ClassIdList = 123,456L;
req.SecondClassIdList = 123,456L;
req.SizeStart = "1";
req.SizeEnd = "2";
req.StateList = 1,2L;
req.Order = "sq_bid";
req.Sort = "desc";
req.Page = 1L;
req.PageSize = 100L;
req.IsExport = 0L;
req.EmpId = "WB873525";
req.IsImportant = 0L;
AlibabaShuqiOriginalCrawlerDistributeBooklistResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaShuqiOriginalCrawlerDistributeBooklistRequest;
$req->setStatDateStart("2025-03-03");
$req->setStatDateEnd("2025-03-03");
$req->setSqBidList("11,22,33");
$req->setBookIdOnlineList("11,22,33");
$req->setBookName("书籍名称");
$req->setPenName("作者");
$req->setChannelIdList("111,222,333");
$req->setFirstDistributeTimeStart("2025-03-03 16:45:07");
$req->setFirstDistributeTimeEnd("2025-03-03 16:45:07");
$req->setSexList("1,2");
$req->setClassIdList("123,456");
$req->setSecondClassIdList("123,456");
$req->setSizeStart("1");
$req->setSizeEnd("2");
$req->setStateList("1,2");
$req->setOrder("sq_bid");
$req->setSort("desc");
$req->setPage("1");
$req->setPageSize("100");
$req->setIsExport("0");
$req->setEmpId("WB873525");
$req->setIsImportant("0");
$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.shuqi.original.crawler.distribute.booklist' \
-d 'partner_id=apidoc' \
-d 'sign=046F4B4F85DCF1B566DDACCDFCA37BBE' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-27+23%3A34%3A57' \
-d 'v=2.0' \
-d 'book_id_online_list=11%2C22%2C33' \
-d 'book_name=%E4%B9%A6%E7%B1%8D%E5%90%8D%E7%A7%B0' \
-d 'channel_id_list=111%2C222%2C333' \
-d 'class_id_list=123%2C456' \
-d 'emp_id=WB873525' \
-d 'first_distribute_time_end=2025-03-03+16%3A45%3A07' \
-d 'first_distribute_time_start=2025-03-03+16%3A45%3A07' \
-d 'is_export=0' \
-d 'is_important=0' \
-d 'order=sq_bid' \
-d 'page=1' \
-d 'page_size=100' \
-d 'pen_name=%E4%BD%9C%E8%80%85' \
-d 'second_class_id_list=123%2C456' \
-d 'sex_list=1%2C2' \
-d 'size_end=2' \
-d 'size_start=1' \
-d 'sort=desc' \
-d 'sq_bid_list=11%2C22%2C33' \
-d 'stat_date_end=2025-03-03' \
-d 'stat_date_start=2025-03-03' \
-d 'state_list=1%2C2'

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

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

req.stat_date_start="2025-03-03"
req.stat_date_end="2025-03-03"
req.sq_bid_list=11,22,33
req.book_id_online_list=11,22,33
req.book_name="书籍名称"
req.pen_name="作者"
req.channel_id_list=111,222,333
req.first_distribute_time_start="2025-03-03 16:45:07"
req.first_distribute_time_end="2025-03-03 16:45:07"
req.sex_list=1,2
req.class_id_list=123,456
req.second_class_id_list=123,456
req.size_start="1"
req.size_end="2"
req.state_list=1,2
req.order="sq_bid"
req.sort="desc"
req.page=1
req.page_size=100
req.is_export=0
req.emp_id="WB873525"
req.is_important=0
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.shuqi.original.crawler.distribute.booklist");
add_param(pRequest,"stat_date_start","2025-03-03");
add_param(pRequest,"stat_date_end","2025-03-03");
add_param(pRequest,"sq_bid_list","11,22,33");
add_param(pRequest,"book_id_online_list","11,22,33");
add_param(pRequest,"book_name","书籍名称");
add_param(pRequest,"pen_name","作者");
add_param(pRequest,"channel_id_list","111,222,333");
add_param(pRequest,"first_distribute_time_start","2025-03-03 16:45:07");
add_param(pRequest,"first_distribute_time_end","2025-03-03 16:45:07");
add_param(pRequest,"sex_list","1,2");
add_param(pRequest,"class_id_list","123,456");
add_param(pRequest,"second_class_id_list","123,456");
add_param(pRequest,"size_start","1");
add_param(pRequest,"size_end","2");
add_param(pRequest,"state_list","1,2");
add_param(pRequest,"order","sq_bid");
add_param(pRequest,"sort","desc");
add_param(pRequest,"page","1");
add_param(pRequest,"page_size","100");
add_param(pRequest,"is_export","0");
add_param(pRequest,"emp_id","WB873525");
add_param(pRequest,"is_important","0");
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.shuqi.original.crawler.distribute.booklist', {
	'stat_date_start':'2025-03-03',
	'stat_date_end':'2025-03-03',
	'sq_bid_list':'11,22,33',
	'book_id_online_list':'11,22,33',
	'book_name':'书籍名称',
	'pen_name':'作者',
	'channel_id_list':'111,222,333',
	'first_distribute_time_start':'2025-03-03 16:45:07',
	'first_distribute_time_end':'2025-03-03 16:45:07',
	'sex_list':'1,2',
	'class_id_list':'123,456',
	'second_class_id_list':'123,456',
	'size_start':'1',
	'size_end':'2',
	'state_list':'1,2',
	'order':'sq_bid',
	'sort':'desc',
	'page':'1',
	'page_size':'100',
	'is_export':'0',
	'emp_id':'WB873525',
	'is_important':'0'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_shuqi_original_crawler_distribute_booklist_response>
    <result>
        <data>
            <total>1</total>
            <pages>1</pages>
            <list>
                <book_info>
                    <stat_date>2025-03-03</stat_date>
                    <sq_bid>111</sq_bid>
                    <book_id_online>222</book_id_online>
                    <book_name>书籍名称</book_name>
                    <pen_name>作者</pen_name>
                    <channel_name>分销渠道名称</channel_name>
                    <reading_num>1</reading_num>
                    <reading_num_dod>0.2</reading_num_dod>
                    <score>9</score>
                    <score_incr>0.2</score_incr>
                    <qimao_bidu_rank>1</qimao_bidu_rank>
                    <qimao_bidu_rank_incr>7</qimao_bidu_rank_incr>
                    <qimao_biaosheng_rank>1</qimao_biaosheng_rank>
                    <qimao_biaosheng_rank_incr>7</qimao_biaosheng_rank_incr>
                    <qimao_dare_rank>1</qimao_dare_rank>
                    <qimao_dare_rank_incr>7</qimao_dare_rank_incr>
                    <fanqie_dianfeng_rank>1</fanqie_dianfeng_rank>
                    <fanqie_dianfeng_rank_incr>7</fanqie_dianfeng_rank_incr>
                    <fanqie_yuedu_rank>1</fanqie_yuedu_rank>
                    <fanqie_yuedu_rank_incr>7</fanqie_yuedu_rank_incr>
                    <first_distribute_time>2025-03-03 16:45:07</first_distribute_time>
                    <sex>男</sex>
                    <class_name>一级分类名称</class_name>
                    <second_class_name>二级分类名称</second_class_name>
                    <size>27000</size>
                    <state>完结</state>
                    <id>123</id>
                    <is_important>重点书</is_important>
                    <has_compare>无</has_compare>
                </book_info>
            </list>
        </data>
        <state>1</state>
        <message>1</message>
    </result>
</alibaba_shuqi_original_crawler_distribute_booklist_response>

{
    "alibaba_shuqi_original_crawler_distribute_booklist_response":{
        "result":{
            "data":{
                "total":1,
                "pages":1,
                "list":{
                    "book_info":[
                        {
                            "stat_date":"2025-03-03",
                            "sq_bid":111,
                            "book_id_online":222,
                            "book_name":"书籍名称",
                            "pen_name":"作者",
                            "channel_name":"分销渠道名称",
                            "reading_num":1,
                            "reading_num_dod":"0.2",
                            "score":"9",
                            "score_incr":"0.2",
                            "qimao_bidu_rank":1,
                            "qimao_bidu_rank_incr":7,
                            "qimao_biaosheng_rank":1,
                            "qimao_biaosheng_rank_incr":7,
                            "qimao_dare_rank":1,
                            "qimao_dare_rank_incr":7,
                            "fanqie_dianfeng_rank":1,
                            "fanqie_dianfeng_rank_incr":7,
                            "fanqie_yuedu_rank":1,
                            "fanqie_yuedu_rank_incr":7,
                            "first_distribute_time":"2025-03-03 16:45:07",
                            "sex":"男",
                            "class_name":"一级分类名称",
                            "second_class_name":"二级分类名称",
                            "size":27000,
                            "state":"完结",
                            "id":123,
                            "is_important":"重点书",
                            "has_compare":"无"
                        }
                    ]
                }
            },
            "state":1,
            "message":"1"
        }
    }
}

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

书旗内容文巢

alibaba.shuqi.original.crawler.distribute.booklist (分销书籍抓取数据列表展示和导出)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈