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

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

yunos.tvsearch.data.search (数娱TV内容搜索)

数娱TV内容搜索,包括:影视、音乐、应用、商品等

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query TvSearchQuery 必须 入参对象
  • └ app
  • String
  • 必须
  • com.yunos.tv.homeshell
  • 进入搜索的应用标识,一般用当前应用包名替代
  • └ keyword
  • String
  • 必须
  • BXJG
  • 搜索的关键字,支持拼音首字母,全拼,汉字
  • └ page_size
  • Number
  • 可选
  • 20
  • 每页返回个数
  • └ search_id
  • String
  • 可选
  • 877C50501EF1A3FE8BA833731FD40C7B_1490087268558
  • 每次搜索标识
  • └ from
  • String
  • 可选
  • com.yunos.tv.universalsearch
  • 请求来源
  • └ locale_info
  • String
  • 可选
  • {"language":"zh","country":"CN"}
  • 表示区域语言
  • └ page
  • Number
  • 可选
  • 1
  • 当前页码
  • └ system_info
  • String
  • 可选
  • {"uuid":"877C50501EF1A3FE8BA833731FD40C7B","device_model":"MagicBox_M13","device_system_version":"6.0.2","device_sn":"877C50501EF1A3FE","device_firmware_version":"6.0.2-RS-20170111.1210","firmware":"6.0.2-RS-20170111.1210","charge_type":"2,3,5","sw":"sw1080","version_code":2100502346,"yingshi_version":2100502346,"device_media":"dolby,h265_4k2k,drm","mac":"1899F51E7804","ethmac":"1899F51E7804","from":"0,7,9","license":"1","bcp":"1","v_model":"F"}
  • 设备信息
  • biz_ext
  • Bizext
  • 可选
  • 业务扩展字段
  • └ memory
  • String
  • 可选
  • 817
  • 设备内存,单位M
  • └ xm_pub
  • String
  • 可选
  • true
  • 虾米特有参数:是否发布, 默认true
  • └ cate_ids
  • String
  • 可选
  • 1,2
  • 阿里影视特有参数:类目ID,多个ID用英文逗号分割
  • └ show_type
  • String
  • 可选
  • 3
  • 阿里影视特有参数:影视节目类型 null全部, 0咨询,电影,3电视剧,4综艺
  • └ key_type
  • String
  • 可选
  • 0
  • 阿里影视特有参数:搜索方式,0-普通(不转换,是啥搜啥)|1-T9(数字)(键盘上的每个键的对应的几个字母数字)|2-首拼|3-笔画(根据笔画顺序搜索),默认0
  • └ tb_sort
  • String
  • 可选
  • s
  • 商品特有参数:商品搜索排序类型。类型包括: s: 默认排序 p: 价格从低到高; pd: 价格从高到低; d: 月销量从高到低; td: 总销量从高到低
  • └ gender
  • String
  • 可选
  • 1
  • 性别1-female,2-male
  • └ parent
  • String
  • 可选
  • 1
  • 是否是家长, 1是家长,
  • └ birthday
  • String
  • 可选
  • 2012-07-02
  • 生日,格式:yyyy-MM-dd
  • └ package_info
  • String
  • 可选
  • {"com.yunos.tv.yingshi.boutique":"2100502346","com.yunos.tv.edu":"2100305023","com.yunos.tv.appstore":"2101401004","com.ali.tv.gamecenter":"2100203016","com.xiami.tv":"2100230103","com.yunos.tvtaobao":"2100400512"}
  • 应用安装信息
  • └ uuid
  • String
  • 可选
  • 877C50501EF1A3FE8BA833731FD40C7B
  • UUID
  • └ spell
  • Boolean
  • 必须
  • false
  • 是否是拼音,首拼和全拼都是拼音

响应参数

名称 类型 示例值 描述
msg_info String 搜索结果为空 错误提示文案
http_status_code Number 200 httpStatusCode
msg_code String QUERY_NO_RESOURCE 错误代码
is_sucess Boolean true 是否成功
model Map {} 数据
  • └ show_tab
  • Boolean
  • true
  • 是否显示模块名
  • └ search_id
  • String
  • 877C50501EF1A3FE8BA833731FD40C7B_1490087268558
  • 本次搜索的标识
  • └ bg_img_url
  • String
  • http://image.tv.yunos.com/product/search/pic/appbg/2017/02/7ba66ad7bfa00606.png
  • 背景图片
  • list
  • Result []
  • []
  • 各个模块搜索结果
  • └ sort
  • Number
  • 1
  • 排序
  • └ source
  • String
  • ALI_VIDEO
  • ALI_VIDEO全部视频,ALI_MOVIE电影,ALI_SERIAL电视剧,ALI_VARIETY综艺,ALI_CHILDREN少儿,ALI_APP游戏应用,ALI_GAME游戏,XM_MUSIC虾米音乐,ALI_ITEM淘宝商品,ALI_CHARACTER演职员,ALI_CARTOON_STAR动画明星
  • └ 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 []
  • []
  • 搜索的结果,内容列表
  • └ 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
  • Number
  • 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
  • adasdf234
  • 埋点用: 推荐平台的scm标记,包含推荐场景、方案信息
  • └ price
  • String
  • 100.00
  • sku最低价(原价)
  • └ sold
  • String
  • 100
  • 销售量
  • └ location
  • String
  • 浙江杭州西湖区
  • 商品所在地
  • └ seller_loc
  • String
  • 浙江杭州西湖区
  • 店铺所在地
  • └ nick
  • String
  • eppler
  • 卖家昵称
  • └ user_id
  • String
  • 1123123
  • 卖家ID
  • └ price_with_rate
  • String
  • 56.98
  • 商品sku最低价的折扣价。如果无折扣,值与price相同。
  • └ fast_post_fee
  • String
  • 10.00
  • 商品邮费
  • └ shipping
  • Number
  • -1
  • 是否免邮: -1表示免邮
  • └ spu_id
  • Number
  • 1
  • 商品所属spu id
  • └ is_cod
  • Number
  • 0
  • 是否货到付款: 1表示货到付款
  • └ is_promotion
  • Boolean
  • true
  • 商品是否有折扣。true表示有折扣,false表示无折扣
  • └ wm_price
  • String
  • 56.80
  • 商品sku最低价的折扣价。如果无折扣,值与price相同。
  • └ cat_id
  • Number
  • 1
  • 商品后台类目id
  • └ package_name
  • String
  • com.yunos.tvtaobao
  • 应用包名
  • └ score
  • String
  • 8.1
  • 评分
  • └ label
  • String
  • 最新
  • 应用:角标
  • └ download_times
  • String
  • 11231434
  • 应用:下载次数
  • └ label_type
  • Number
  • 0
  • 影视:角标类型
  • └ label_name
  • String
  • 独播
  • 影视:角标内容
  • └ tips
  • String
  • 26集全
  • 影视:提示
  • └ show_type
  • Number
  • 3
  • 影视:类型 0咨询,1电影,3电视剧,4综艺
  • └ singer
  • String
  • 刘德华
  • 歌手
  • └ pic_url_horizontal
  • String
  • http://cn-vmc-images.alicdn.com/vmac/10000000050C00005A90CD2D859B5E05630243EA
  • 横图
  • └ sub_title
  • String
  • 跑男
  • 副标题
  • └ genre
  • String
  • 真人,格斗,科幻
  • 分类
  • └ casts
  • String
  • 杜军
  • 导演
  • └ crews
  • String
  • 张一山,刘威,傅淼,山崎敬一,刘小溪,王挺,程琤,王桂峰,苏茂洋,大柳真一郎,许瑶璇,戴墨,魏震,段炼,李吉昌,孙锡堃,杨念生,郝刚,唐昕,武鑫羽,王从懿,杨清文,毕超,柴尧,苇青,李林煊,冮明华,钱佑洋
  • 演职员
  • └ year
  • Number
  • 2018
  • 发行年份
  • └ program_type
  • String
  • TS
  • 节目类型
  • └ description
  • String
  • 银河·奥特曼S》为《银河·奥特曼》的续作。全新TV剧情,共16集。 片名中的\"S\"为\"Storium\"的首字母,指的是银河奥特曼在本作中获得的新形态——银河奥特曼斯特利姆。银河·奥特曼仍然是本作的主角。此外,片中将会有新的奥特英雄登场,他的名字是——维克特利·奥特曼。
  • 描述
  • └ show_total_vv
  • Number
  • 34234
  • 播放量
  • └ total_text
  • String
  • 99+
  • 总记录数的文本标识
  • └ is_recommend
  • Boolean
  • false
  • 是否是推荐内容
  • └ search_id
  • String
  • 877C50501EF1A3FE8BA833731FD40C7B_1490087268558
  • 本次搜索标识,埋点、跟踪

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
YunosTvsearchDataSearchRequest req = new YunosTvsearchDataSearchRequest();
YunosTvsearchDataSearchRequest.TvSearchQuery obj1 = new YunosTvsearchDataSearchRequest.TvSearchQuery();
obj1.setApp("com.yunos.tv.homeshell");
obj1.setKeyword("BXJG");
obj1.setPageSize(20L);
obj1.setSearchId("877C50501EF1A3FE8BA833731FD40C7B_1490087268558");
obj1.setFrom("com.yunos.tv.universalsearch");
obj1.setLocaleInfo("{\"language\":\"zh\",\"country\":\"CN\"}");
obj1.setPage(1L);
obj1.setSystemInfo("{\"uuid\":\"877C50501EF1A3FE8BA833731FD40C7B\",\"device_model\":\"MagicBox_M13\",\"device_system_version\":\"6.0.2\",\"device_sn\":\"877C50501EF1A3FE\",\"device_firmware_version\":\"6.0.2-RS-20170111.1210\",\"firmware\":\"6.0.2-RS-20170111.1210\",\"charge_type\":\"2,3,5\",\"sw\":\"sw1080\",\"version_code\":2100502346,\"yingshi_version\":2100502346,\"device_media\":\"dolby,h265_4k2k,drm\",\"mac\":\"1899F51E7804\",\"ethmac\":\"1899F51E7804\",\"from\":\"0,7,9\",\"license\":\"1\",\"bcp\":\"1\",\"v_model\":\"F\"}");
YunosTvsearchDataSearchRequest.Bizext obj2 = new YunosTvsearchDataSearchRequest.Bizext();
obj2.setMemory("817");
obj2.setXmPub("true");
obj2.setCateIds("1,2");
obj2.setShowType("3");
obj2.setKeyType("0");
obj2.setTbSort("s");
obj2.setGender("1");
obj2.setParent("1");
obj2.setBirthday("2012-07-02");
obj1.setBizExt(obj2);
obj1.setPackageInfo("{\"com.yunos.tv.yingshi.boutique\":\"2100502346\",\"com.yunos.tv.edu\":\"2100305023\",\"com.yunos.tv.appstore\":\"2101401004\",\"com.ali.tv.gamecenter\":\"2100203016\",\"com.xiami.tv\":\"2100230103\",\"com.yunos.tvtaobao\":\"2100400512\"}");
obj1.setUuid("877C50501EF1A3FE8BA833731FD40C7B");
obj1.setSpell(false);
req.setQuery(obj1);
YunosTvsearchDataSearchResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<yunos_tvsearch_data_search_response>
    <msg_info>搜索结果为空</msg_info>
    <http_status_code>200</http_status_code>
    <msg_code>QUERY_NO_RESOURCE</msg_code>
    <is_sucess>true</is_sucess>
    <model>
        <show_tab>true</show_tab>
        <search_id>877C50501EF1A3FE8BA833731FD40C7B_1490087268558</search_id>
        <bg_img_url>http://image.tv.yunos.com/product/search/pic/appbg/2017/02/7ba66ad7bfa00606.png</bg_img_url>
        <list>
            <result>
                <sort>1</sort>
                <source>ALI_VIDEO</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>adasdf234</scm>
                        <price>100.00</price>
                        <sold>100</sold>
                        <location>浙江杭州西湖区</location>
                        <seller_loc>浙江杭州西湖区</seller_loc>
                        <nick>eppler</nick>
                        <user_id>1123123</user_id>
                        <price_with_rate>56.98</price_with_rate>
                        <fast_post_fee>10.00</fast_post_fee>
                        <shipping>-1</shipping>
                        <spu_id>1</spu_id>
                        <is_cod>0</is_cod>
                        <is_promotion>true</is_promotion>
                        <wm_price>56.80</wm_price>
                        <cat_id>1</cat_id>
                        <package_name>com.yunos.tvtaobao</package_name>
                        <score>8.1</score>
                        <label>最新</label>
                        <download_times>11231434</download_times>
                        <label_type>0</label_type>
                        <label_name>独播</label_name>
                        <tips>26集全</tips>
                        <show_type>3</show_type>
                        <singer>刘德华</singer>
                        <pic_url_horizontal>http://cn-vmc-images.alicdn.com/vmac/10000000050C00005A90CD2D859B5E05630243EA</pic_url_horizontal>
                        <sub_title>跑男</sub_title>
                        <genre>真人,格斗,科幻</genre>
                        <casts>杜军</casts>
                        <crews>张一山,刘威,傅淼,山崎敬一,刘小溪,王挺,程琤,王桂峰,苏茂洋,大柳真一郎,许瑶璇,戴墨,魏震,段炼,李吉昌,孙锡堃,杨念生,郝刚,唐昕,武鑫羽,王从懿,杨清文,毕超,柴尧,苇青,李林煊,冮明华,钱佑洋</crews>
                        <year>2018</year>
                        <program_type>TS</program_type>
                        <description>银河·奥特曼S》为《银河·奥特曼》的续作。全新TV剧情,共16集。   片名中的\&quot;S\&quot;为\&quot;Storium\&quot;的首字母,指的是银河奥特曼在本作中获得的新形态——银河奥特曼斯特利姆。银河·奥特曼仍然是本作的主角。此外,片中将会有新的奥特英雄登场,他的名字是——维克特利·奥特曼。</description>
                        <show_total_vv>34234</show_total_vv>
                    </data>
                </list>
                <total_text>99+</total_text>
                <is_recommend>false</is_recommend>
                <search_id>877C50501EF1A3FE8BA833731FD40C7B_1490087268558</search_id>
            </result>
        </list>
    </model>
</yunos_tvsearch_data_search_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

返回
顶部