文档中心 > API类目 > 书旗内容文巢

alibaba.shuqi.content.backend.rival.searchrival (查询竞对列表)

查询竞对列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sq_bids Number 可选 1 书旗bid(支持批量查询)
inc_cp_date Number 可选 1 新增cp时间 eg:202212
qimao_cp_names String 可选 1 七猫cp名,支持多选
book_level String 可选 1 书籍等级 S、A、B、C、D、E、未知,需要大写
page_size Number 可选 1 每页大小
source Number 可选 1 来源
sq_top_class Number 可选 1 书旗书籍类型
rival_author_name String 可选 1 竞对作者
date_ym Number 可选 1 默认数据归属年月
sq_book_name String 可选 1 书旗书籍名
author_level String 可选 1 作者等级 S、A、B、C 未知
rival_book_name String 可选 1 竞对书名
book_in_copr Number 可选 1 当前书籍是否在书旗版权库 1 是 0 否
order String 可选 1 升序 降序
book_status Number 可选 1 书籍上下架状态,和上个月比较 1上架 2下架
sq_channel String 可选 1 书旗频道
out_cate_name String 可选 1 外层分类名
serial_state Number 可选 1 连载状态 1连载 0 完结
sort String 可选 1 排序字段
inner_cate_name String 可选 1 内层分类名
book_classes String 可选 1 书籍类型 1 男生 2 女生 3图书,支持多选
offline_date Number 可选 1 下架书时间 eg:202212
sq_category String 可选 1 书旗分类id
sq_cp_id Number 可选 1 书旗cpid
online_inc_date Number 可选 1 新增上架书时间 eg:202212
is_short_story Number 可选 1 是否短篇 1 是 0 否
page Number 可选 1 页数
is_broken Number 可选 1 是否断更 1 断更 0 无断更
product_code Number 可选 1 产品码,1:主端,3:UC,4:夸克
product_status Number 可选 1 产品线上状态,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
copr_expire_status Number 可选 1 版权到期状态,1:正常,2:临期,3:到期,正常包括临期
shelf_check_status Number 可选 300001 审核状态,300001:上书待审核、300002:上书驳回、400001:内容待审核、400002:内容审核驳回、400011:内容待排查、400012:内容排查驳回、400003:待定价、500001:待上架、500002:已上架
no_copr_reason String 可选 "" 无法引入原因 包括: 1. 该cp未合作 2. 该cp无代理权 3. 暂时不开放授权 4. 其他平台独家 5. 低质书暂不引入 6. 该书需要保底 7. 其他 8.待引入 9.待回捞 10.无(没有填无法引入原因)
business_belong_list String 可选 "" 七猫归属榜单,包括:必读榜、大热榜、热搜榜、新书榜

响应参数

名称 类型 示例值 描述
data PageResponse 返回数据
  • └ total
  • Number
  • 4
  • 条数
  • list
  • RivalSearchResp []
  • 数据
  • └ month_ticket_num
  • String
  • 1
  • 当月票数
  • └ book_level
  • String
  • 1
  • 作品等级,在读人数相关
  • └ first_category
  • String
  • 1
  • 外层分类
  • └ belong_list
  • String
  • 1
  • 归属榜单
  • └ rival_bid
  • Number
  • 0
  • 竞对书籍id
  • └ source
  • Number
  • 0
  • 归属竞对
  • └ last_chapter
  • String
  • 1
  • 最新章节
  • └ score
  • String
  • 1
  • 书籍评分
  • └ sq_book_name
  • String
  • 1
  • 书旗书籍名
  • └ sq_is_finished
  • Number
  • 0
  • 是否太监, 0:正常, 1:太监
  • └ is_new_online
  • Number
  • 0
  • 是否为本月新增上架,和上个月比较 1 新增 0 无新增
  • └ book_in_copr
  • Number
  • 0
  • 当前书籍是否在书旗版权库 1 是 0 否
  • └ book_intr
  • String
  • 1
  • 书籍简介
  • └ id
  • Number
  • 0
  • 主键
  • └ top_comment
  • String
  • 1
  • 书评精华
  • └ sq_channel
  • String
  • 1
  • 书旗书籍频道
  • └ word_count
  • Number
  • 0
  • 总字数
  • └ cp_name
  • String
  • 1
  • 竞品cp名称
  • └ sq_author_name
  • String
  • 1
  • 书旗作者名
  • └ serial_state
  • Number
  • 0
  • 书籍状态 1:连载2、完结3
  • └ tags
  • String
  • 1
  • 标签
  • └ comment_bad
  • String
  • 1
  • 书评-不好看
  • └ mark_count
  • Number
  • 0
  • 评分人数
  • └ sq_serial_state
  • Number
  • 0
  • 书籍状态 1:连载2、完结3
  • └ author_name
  • String
  • 1
  • 作者名
  • └ sq_bid
  • Number
  • 0
  • 书旗bid
  • └ is_short_story
  • Number
  • 0
  • 是否短篇 1 是 0 否
  • └ rival_book_class
  • Number
  • 0
  • 页面来源 1 男生 2 女生 3图书
  • └ last_chapter_up_time
  • String
  • 1
  • 最新章节更新时间
  • └ second_category
  • String
  • 1
  • 内层分类
  • └ last_month_level
  • String
  • 11
  • 上个月作品等级
  • └ author_comment
  • String
  • 1
  • 书评作者说
  • └ remark
  • String
  • 1
  • 字段备注
  • └ sq_top_class
  • Number
  • 0
  • 书旗书籍类型
  • └ spider_time
  • String
  • 1
  • 抓取时间
  • └ date_ym
  • Number
  • 0
  • 数据归属年月
  • └ author_level
  • String
  • 1
  • 作者等级
  • └ total_mast_read_ticket
  • String
  • 1
  • 累计必读票
  • └ month_ticket_rank
  • String
  • 1
  • 当月票数排行
  • └ book_status
  • Number
  • 0
  • 书籍上下架状态,和上个月比较 0无变化 1上架 2 下架
  • └ is_new_offline
  • Number
  • 0
  • 是否为本月新增下架,和上个月比较 1 新增 0 无新增
  • └ no_copr_reason
  • String
  • 1
  • 无版权原因
  • └ comment_good
  • String
  • 1
  • 书评-好看
  • └ book_comment_count
  • Number
  • 0
  • 书评条数
  • └ book_cover
  • String
  • 1
  • 书籍封面
  • └ book_name
  • String
  • 1
  • 书名
  • └ total_popular
  • String
  • 1
  • 累计人气
  • └ actor
  • String
  • 1
  • 角色
  • └ author_intr
  • String
  • 1
  • 作者简介
  • └ comment_normal
  • String
  • 1
  • 书评-一般
  • └ comment_reward
  • String
  • 1
  • 书评打赏留言
  • └ sq_category
  • String
  • 1
  • 书旗书籍前台分类
  • └ sq_cp_id
  • Number
  • 0
  • 书旗cp id
  • └ month_new_cp
  • Number
  • 0
  • 书籍cp为本月新增 1 是 0 否
  • └ read_num
  • Number
  • 0
  • 在读人数
  • └ is_rival_origin
  • Number
  • 0
  • 是否竞对原创 1是 0否
  • └ is_broken
  • Number
  • 0
  • 疑似断更 1 断更 0 无断更
  • └ sq_belong_list
  • String
  • 1
  • 归属书旗书库id列表
  • └ copr_expire_status
  • Number
  • 1
  • 版权到期状态,1:正常,2:临期,3:到期,正常包括临期
  • └ shelf_check_status
  • Number
  • 300001
  • 审核状态,300001:上书待审核、300002:上书驳回、400001:内容待审核、400002:内容审核驳回、400011:内容待排查、400012:内容排查驳回、400003:待定价、500001:待上架、500002:已上架
  • └ business_belong_list
  • String
  • ""
  • 七猫归属榜单,包括:必读榜、大热榜、热搜榜、新书榜
  • └ operate_reason
  • String
  • ""
  • 下架原因
  • └ sq_and_status
  • Number
  • 1
  • 书旗Android线上状态,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ sq_ios_status
  • Number
  • 1
  • 书旗iOS线上状态,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ uc_and_status
  • Number
  • 1
  • 全搜安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ uc_ios_status
  • Number
  • 1
  • 全搜ios,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ quark_and_status
  • Number
  • 1
  • 夸克安卓,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ quark_ios_status
  • Number
  • 1
  • 夸克iOS,1:正常上架,2:隐藏可阅读-新章节可读,3:隐藏可阅读-新章节不可读,4:下架不能阅读
  • └ reject_reason
  • String
  • ""
  • 驳回原因
state Number 200 状态码
message String success 返回信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaShuqiContentBackendRivalSearchrivalRequest req = new AlibabaShuqiContentBackendRivalSearchrivalRequest();
req.setSqBids(1L);
req.setIncCpDate(1L);
req.setQimaoCpNames("1");
req.setBookLevel("1");
req.setPageSize(1L);
req.setSource(1L);
req.setSqTopClass(1L);
req.setRivalAuthorName("1");
req.setDateYm(1L);
req.setSqBookName("1");
req.setAuthorLevel("1");
req.setRivalBookName("1");
req.setBookInCopr(1L);
req.setOrder("1");
req.setBookStatus(1L);
req.setSqChannel("1");
req.setOutCateName("1");
req.setSerialState(1L);
req.setSort("1");
req.setInnerCateName("1");
req.setBookClasses("1");
req.setOfflineDate(1L);
req.setSqCategory("1");
req.setSqCpId(1L);
req.setOnlineIncDate(1L);
req.setIsShortStory(1L);
req.setPage(1L);
req.setIsBroken(1L);
req.setProductCode(1L);
req.setProductStatus(1L);
req.setCoprExpireStatus(1L);
req.setShelfCheckStatus(300001L);
req.setNoCoprReason("\"\"");
req.setBusinessBelongList("\"\"");
AlibabaShuqiContentBackendRivalSearchrivalResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_shuqi_content_backend_rival_searchrival_response>
    <data>
        <total>4</total>
        <list>
            <rival_search_resp>
                <month_ticket_num>1</month_ticket_num>
                <book_level>1</book_level>
                <first_category>1</first_category>
                <belong_list>1</belong_list>
                <rival_bid>0</rival_bid>
                <source>0</source>
                <last_chapter>1</last_chapter>
                <score>1</score>
                <sq_book_name>1</sq_book_name>
                <sq_is_finished>0</sq_is_finished>
                <is_new_online>0</is_new_online>
                <book_in_copr>0</book_in_copr>
                <book_intr>1</book_intr>
                <id>0</id>
                <top_comment>1</top_comment>
                <sq_channel>1</sq_channel>
                <word_count>0</word_count>
                <cp_name>1</cp_name>
                <sq_author_name>1</sq_author_name>
                <serial_state>0</serial_state>
                <tags>1</tags>
                <comment_bad>1</comment_bad>
                <mark_count>0</mark_count>
                <sq_serial_state>0</sq_serial_state>
                <author_name>1</author_name>
                <sq_bid>0</sq_bid>
                <is_short_story>0</is_short_story>
                <rival_book_class>0</rival_book_class>
                <last_chapter_up_time>1</last_chapter_up_time>
                <second_category>1</second_category>
                <last_month_level>11</last_month_level>
                <author_comment>1</author_comment>
                <remark>1</remark>
                <sq_top_class>0</sq_top_class>
                <spider_time>1</spider_time>
                <date_ym>0</date_ym>
                <author_level>1</author_level>
                <total_mast_read_ticket>1</total_mast_read_ticket>
                <month_ticket_rank>1</month_ticket_rank>
                <book_status>0</book_status>
                <is_new_offline>0</is_new_offline>
                <no_copr_reason>1</no_copr_reason>
                <comment_good>1</comment_good>
                <book_comment_count>0</book_comment_count>
                <book_cover>1</book_cover>
                <book_name>1</book_name>
                <total_popular>1</total_popular>
                <actor>1</actor>
                <author_intr>1</author_intr>
                <comment_normal>1</comment_normal>
                <comment_reward>1</comment_reward>
                <sq_category>1</sq_category>
                <sq_cp_id>0</sq_cp_id>
                <month_new_cp>0</month_new_cp>
                <read_num>0</read_num>
                <is_rival_origin>0</is_rival_origin>
                <is_broken>0</is_broken>
                <sq_belong_list>1</sq_belong_list>
                <copr_expire_status>1</copr_expire_status>
                <shelf_check_status>300001</shelf_check_status>
                <business_belong_list>&quot;&quot;</business_belong_list>
                <operate_reason>&quot;&quot;</operate_reason>
                <sq_and_status>1</sq_and_status>
                <sq_ios_status>1</sq_ios_status>
                <uc_and_status>1</uc_and_status>
                <uc_ios_status>1</uc_ios_status>
                <quark_and_status>1</quark_and_status>
                <quark_ios_status>1</quark_ios_status>
                <reject_reason>&quot;&quot;</reject_reason>
            </rival_search_resp>
        </list>
    </data>
    <state>200</state>
    <message>success</message>
</alibaba_shuqi_content_backend_rival_searchrival_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部