注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 数娱搜索

yunos.tvsearch.ranking.get (数娱TV内容推荐接口)

获取电影,电视剧,综艺等类型的热门排名视频

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query RankingVideoQuery 可选 接口条件对象
  • └ page_name
  • String
  • 可选
  • home
  • 应用的页面名,不同页面可能对应不同的搜推荐资源
  • └ package_name
  • String
  • 必须
  • com.yunos.tv.homeshell
  • 应用标识,一般用包名替代
  • └ system_info
  • String
  • 可选
  • {"device_sn":"7EE7125248BB4662","device_model":"MagicBox2","device_system_version":"3.0.3","charge_type":"2,3,5","bcp":"1","area_code":"","device_media":"dts,dolby,drm,h265_720p","uuid":"7EE7125248BB46622D6C27F53BB0DA95","from":"0,4,5,6,7","device_firmware_version":"3.0.3-D-20150922.1534","sw":"sw1080","version_code":2100302010}
  • 设备信息
  • └ package_info
  • String
  • 可选
  • {"com.moretv.android":"403021000","com.iflytek.aichang.tv":"1167677984","com.panda.stb":"2145344702","com.yunos.tv.yingshi.boutique":"1807858364","cn.ljwl.bn.dvb":"431700165","com.skyworthdigital.stb.app":"1465076221","com.yunos.tv.appstore":"2123148606","com.yunos.tv.videochat":"674037304","cn.ccdt.dvbplayer":"1037634139","com.um.dvb":"757187321","com.yinhe.hunan.dtv":"985977772","com.yunos.tbsdk":"1233741395","com.cibn.yktv":"40874909","com.yunos.tvtaobao":"1152075576","com.multak.LoudSpeakerKaraoke":"1702427516","com.yunos.tv.homeshell":"1321960044","com.ali.tv.gamecenter":"211607779","com.audiocn.kalaok.tv.haier.amlogict866":"620106974","com.xiami.tv":"1627674729"}
  • 应用版本
  • └ locale_info
  • String
  • 可选
  • {"language":"zh","country":"CN"}
  • 区域语言
  • └ version
  • String
  • 可选
  • 2100101000
  • 应用版本号 暂时无用,可传可不传
  • └ limit
  • Number
  • 可选
  • 20
  • 返回个数,取值限制1-100

响应参数

名称 类型 示例值 描述
result Result {} 返回结果
  • list
  • Model []
  • []
  • 返回结果,内容列表
  • └ sort
  • Number
  • 1
  • 排序
  • └ source
  • String
  • VIDEO_ALL_HOT
  • 排行资源标识:VIDEO_ALL_HOT热门影视,VIDEO_MOVIE_HOT热门电影,VIDEO_SERIAL_HOT热门电视剧,VIDEO_VARIETY_HOT热门综艺,VIDEO_CARTOON_HOT热门动漫,VIDEO_DOCUMENTARY_HOT热门记录片,VIDEO_NEWSREEL_HOT热门资讯,VIDEO_MV_HOT热门音乐视频,VIDEO_EDU_HOT热门教育视频,VIDEO_TRAINING_HOT热门课程培训视频
  • └ title
  • String
  • 热门影视
  • 排行名称
  • └ type
  • String
  • VIDEO
  • 数据类型
  • └ total
  • Number
  • 15
  • 总记录数数
  • └ cur_page
  • Number
  • 1
  • 当前页码
  • └ page_size
  • Number
  • 20
  • 每页返回个数
  • └ total_page
  • Number
  • 1
  • 总页数
  • └ has_next
  • Boolean
  • false
  • 是否有下一页
  • └ more_uri
  • String
  • yunostv_yingshi://search/?keyword=BXJG&from=tvsearch
  • 更多uri
  • list
  • Data []
  • []
  • data
  • └ id
  • String
  • 121739
  • 内容ID:影视ID,音乐ID,应用ID等
  • └ title
  • String
  • 变形金刚:领袖之证第1季
  • 内容名称:电影名,歌曲名,应用名等
  • └ pic_url
  • String
  • http://galitv.alicdn.com/product/20161027/attachment/video/program/2016/1027/dn/942609af7e892941abc9dcfd30c40fcc.jpg
  • 内容图片
  • └ uri
  • String
  • yunostv_yingshi://yingshi_detail/?id=121739&showType=3&from=com.yunos.tv.universalsearch&sourceFrom=0&from_self=com.yunos.tv.universalsearch
  • 客户端跳转的uri
  • └ match_word
  • String
  • 变形金刚
  • 搜索匹配的词
  • └ match_slot
  • String
  • title
  • 搜索匹配的词的属性名
  • └ introduction
  • String
  • 文字
  • 动画明星简介
  • └ pic_bg
  • String
  • http://galitv.alicdn.com/product/20161027/attachment/video/program/2016/1027/dn/942609af7e892941abc9dcfd30c40fcc.jpg
  • 动画明背景图
  • └ birthday
  • String
  • 1976-02-02
  • 人物对象的:生日,yyyy-MM-dd
  • └ die_day
  • String
  • 1976-02-02
  • 人物对象的:祭日,yyyy-MM-dd
  • └ gender
  • String
  • 0
  • 性别 0男,1,女,2混合,3未知
  • └ alias_name
  • String
  • 韩琦
  • 别名
  • └ en_name
  • String
  • hanqi
  • 英文名
  • └ area
  • String
  • 香港
  • 地区
  • └ job
  • String
  • 歌手
  • 职业
  • └ nation
  • String
  • 汉族
  • 民族
  • └ homeplace
  • String
  • 浙江杭州
  • 籍贯
  • └ keyword
  • String
  • 变形金刚
  • 关键词
  • └ weight
  • Number
  • 1
  • 权重值
  • └ scm
  • String
  • adasdfqe23421
  • 埋点用: 推荐平台的scm标记,包含推荐场景、方案信息
  • └ package_name
  • String
  • com.yunos.tvtaobao
  • 应用包名
  • └ score
  • String
  • 8.1
  • 评分
  • └ label
  • String
  • 最新
  • 角标
  • └ download_times
  • String
  • 212323
  • 下载次数
  • └ label_type
  • String
  • 0
  • 角标类型
  • └ label_name
  • String
  • 独播
  • 角标内容
  • └ tips
  • String
  • 26集全
  • 提示
  • └ show_type
  • String
  • 3
  • 影视类型 0咨询,1电影,3电视剧,4综艺
  • └ singer
  • String
  • 刘德华
  • 歌手
  • └ pic_url_horizontal
  • String
  • 横图
  • └ sub_title
  • String
  • 副标题
  • └ genre
  • String
  • 分类
  • └ casts
  • String
  • 导演
  • └ crews
  • String
  • 演职员
  • └ year
  • Number
  • 发行年份
  • └ program_type
  • String
  • 节目类型
  • └ description
  • String
  • 描述
  • └ show_total_vv
  • Number
  • 123412
  • 播放量
  • └ show_id
  • String
  • 优酷节目id
  • └ shaoer
  • Number
  • 1
  • 是否是少儿,0不是,1是

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
YunosTvsearchRankingGetRequest req = new YunosTvsearchRankingGetRequest();
YunosTvsearchRankingGetRequest.RankingVideoQuery obj1 = new YunosTvsearchRankingGetRequest.RankingVideoQuery();
obj1.setPageName("home");
obj1.setPackageName("com.yunos.tv.homeshell");
obj1.setSystemInfo("{\"device_sn\":\"7EE7125248BB4662\",\"device_model\":\"MagicBox2\",\"device_system_version\":\"3.0.3\",\"charge_type\":\"2,3,5\",\"bcp\":\"1\",\"area_code\":\"\",\"device_media\":\"dts,dolby,drm,h265_720p\",\"uuid\":\"7EE7125248BB46622D6C27F53BB0DA95\",\"from\":\"0,4,5,6,7\",\"device_firmware_version\":\"3.0.3-D-20150922.1534\",\"sw\":\"sw1080\",\"version_code\":2100302010}");
obj1.setPackageInfo("{\"com.moretv.android\":\"403021000\",\"com.iflytek.aichang.tv\":\"1167677984\",\"com.panda.stb\":\"2145344702\",\"com.yunos.tv.yingshi.boutique\":\"1807858364\",\"cn.ljwl.bn.dvb\":\"431700165\",\"com.skyworthdigital.stb.app\":\"1465076221\",\"com.yunos.tv.appstore\":\"2123148606\",\"com.yunos.tv.videochat\":\"674037304\",\"cn.ccdt.dvbplayer\":\"1037634139\",\"com.um.dvb\":\"757187321\",\"com.yinhe.hunan.dtv\":\"985977772\",\"com.yunos.tbsdk\":\"1233741395\",\"com.cibn.yktv\":\"40874909\",\"com.yunos.tvtaobao\":\"1152075576\",\"com.multak.LoudSpeakerKaraoke\":\"1702427516\",\"com.yunos.tv.homeshell\":\"1321960044\",\"com.ali.tv.gamecenter\":\"211607779\",\"com.audiocn.kalaok.tv.haier.amlogict866\":\"620106974\",\"com.xiami.tv\":\"1627674729\"}");
obj1.setLocaleInfo("{\"language\":\"zh\",\"country\":\"CN\"}");
obj1.setVersion("2100101000");
obj1.setLimit(20L);
req.setQuery(obj1);
YunosTvsearchRankingGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<yunos_tvsearch_ranking_get_response>
    <result>
        <list>
            <model>
                <sort>1</sort>
                <source>VIDEO_ALL_HOT</source>
                <title>热门影视</title>
                <type>VIDEO</type>
                <total>15</total>
                <cur_page>1</cur_page>
                <page_size>20</page_size>
                <total_page>1</total_page>
                <has_next>false</has_next>
                <more_uri>yunostv_yingshi://search/?keyword=BXJG&amp;from=tvsearch</more_uri>
                <list>
                    <data>
                        <id>121739</id>
                        <title>变形金刚:领袖之证第1季</title>
                        <pic_url>http://galitv.alicdn.com/product/20161027/attachment/video/program/2016/1027/dn/942609af7e892941abc9dcfd30c40fcc.jpg</pic_url>
                        <uri>yunostv_yingshi://yingshi_detail/?id=121739&amp;showType=3&amp;from=com.yunos.tv.universalsearch&amp;sourceFrom=0&amp;from_self=com.yunos.tv.universalsearch</uri>
                        <match_word>变形金刚</match_word>
                        <match_slot>title</match_slot>
                        <introduction>文字</introduction>
                        <pic_bg>http://galitv.alicdn.com/product/20161027/attachment/video/program/2016/1027/dn/942609af7e892941abc9dcfd30c40fcc.jpg</pic_bg>
                        <birthday>1976-02-02</birthday>
                        <die_day>1976-02-02</die_day>
                        <gender>0</gender>
                        <alias_name>韩琦</alias_name>
                        <en_name>hanqi</en_name>
                        <area>香港</area>
                        <job>歌手</job>
                        <nation>汉族</nation>
                        <homeplace>浙江杭州</homeplace>
                        <keyword>变形金刚</keyword>
                        <weight>1</weight>
                        <scm>adasdfqe23421</scm>
                        <package_name>com.yunos.tvtaobao</package_name>
                        <score>8.1</score>
                        <label>最新</label>
                        <download_times>212323</download_times>
                        <label_type>0</label_type>
                        <label_name>独播</label_name>
                        <tips>26集全</tips>
                        <show_type>3</show_type>
                        <singer>刘德华</singer>
                        <pic_url_horizontal></pic_url_horizontal>
                        <sub_title></sub_title>
                        <genre></genre>
                        <casts></casts>
                        <crews></crews>
                        <year></year>
                        <program_type></program_type>
                        <description></description>
                        <show_total_vv>123412</show_total_vv>
                        <show_id></show_id>
                        <shaoer>1</shaoer>
                    </data>
                </list>
            </model>
        </list>
    </result>
</yunos_tvsearch_ranking_get_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

返回
顶部