影视宝开发者文档

11
2月

微瑞数据API主要是向第三方提供数据。授权方式采用OAuth2.0方式。用户取得微瑞对应接口授权,从而可以对该接口进行调用。

目录

1 获取指定时间范围内上映的电影简要信息
2获取详细的电影基本信息
3 获取指定时间段每日网票信息
4获取电影的从上映1一个月前到目前为止,每周内的新浪微博声量
5 获取电影相关的指定网站评论信息
6 获取指定电影所有影人的基本信息
7 获取预告片的统计信息
8 获取指定vid的电影想看量
9 获取指定影人的基本信息
10 获取指定电影主创团队的基本信息

 

1 获取指定时间范围内上映的电影简要信息

请求URL:http://223.223.179.172:10080/api/brief_movie_list.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
starttime 开始时间(可选),如果没有开始时间或者结束时间,则返回距离当前20天内最符合要求的电影,默认是4部
endtime 结束时间(可选)
page 指定页码,默认1(可选)
count 每页包含的数据量,默认4(可选)
mode mode=0按照上映日期排序,mode=1按照票房排序
order order=0返回结果按倒序排列,否则按顺序排列

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
items 电影列表
vid 电影在数据库中的唯一id
vpuid 电影对应的vpuid,如果为0,表明还未对该电影进行分析
name 电影名字
imgurl 电影海报url地址
releasetime 电影上映日期
boxoffice 电影当前总票房
page 当前页码
count 每页返回多少条数据
total 满足条件的结果总数

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "items": [
             {
                "vid":1,
                "vpuid":5317,
                "name": "环太平洋",
                "imgurl": " http://img3.douban.com/view/photo/public/p2039702792.jpg",
                "releasetime":"Wed, 31 Jul 2013 00:00:00 +0800 ",
                "boxoffice": 11111
             },
             {
                "vid":2,
                "vpuid":5318,
                "name": "蓝精灵2,
                "imgurl": " http://img3.douban.com/view/photo/public/p2039702792.jpg",
                "releasetime":"Wed, 31 Jul 2013 00:00:00 +0800 ",
                "boxoffice": 22222
             },
             ......
          ],
          "page": 1,
          "count": 4,
          "total": 100
       }
2 获取详细的电影基本信息

请求URL:http://223.223.179.172:10080/api/movie_list.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vids 电影id列表(用英文逗号分隔,最多50个),每个vid对应唯一一部电影,vides和keyword参数有且仅能有一个
keyword 需要查询的电影名关键词,完整的或不完整的电影名(可选)
page 指定页码,默认1(可选)
count 每页内容,默认4(可选)
mode mode=0按照上映日期排序,mode=1按照票房排序
order order=0返回结果按倒序排列,否则按顺序排列
type 指定查找及返回数据的范围,仅在通过keyword检索时有效,0=全部,1=仅电影,2=仅电视剧,3=仅电视栏目,4=同时包括电视剧和电视栏目。默认是1。

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
videos 电影信息列表
vid 电影在数据库中的唯一id
vpuid 电影对应的vpuid,如果为0,表明还未对该电影进行分析
name 电影名字
byname 别名
imgurl 电影海报url地址
releasetime 电影上映日期
offlinetime 下线日期
boxoffice 票房
viewed 优酷视频观看次数
country 产地
runtime 时长
type 类型
score 评分
imdblink imdb链接
introduction 剧情简介
director 导演
writer 编剧
actor 演员
page 当前页码
count 每页包含的数据量
total 满足条件的数据总量

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "videos": [
             {
                "vid":1,
                "vpuid":5317,
                "name": , "环太平洋"
                "byname": , "悍战太平洋 | Pacific Rim "
                "imgurl": " http://img3.douban.com/view/photo/photo/public/p2039702792.jpg",
                "releasetime":"Wed, 31 Jul 2013 00:00:00 +0800 ",
                "offlinetime":"Sat, 10 Aug 2013 00:00:00 +0800 ",
                "boxoffice":124596656 ,
                "imdblink":"xxxxxxxxx" ,
                "viewed":4589456,
                "country":"美国",
                "runtime ":"129",
                "type":"科幻 | 动作 | 惊悚",
                "score":"8.0 ",
                "introduction":"近未来,地球环境逐步恶化。神秘外星殖民者通过…",
                "director":"吉尔莫•德尔•托罗",
                "writer":"特拉维斯•比彻姆 | 吉尔莫•德尔•托罗",
                "actor":"查理•汉纳姆|菊地凛子|伊德瑞斯•艾尔巴|查理•戴|朗•普尔曼|罗伯特•卡辛斯基|马克斯•马蒂尼|伯恩•戈曼|小克利夫顿•克林斯|芦田爱菜|迪亚哥•克莱特霍夫|希瑟·多克森"
             },
             ......
          ],
          "page": 1,
          "count": 4,
          "total": 100
       }
3 获取指定时间段每日网票信息

请求URL:http://223.223.179.172:10080/api/boxoffice.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vid 电影id(必选)
starttime 开始时间(默认是电影上映当天)
endtime 结束时间(默认是下线日期,如未下线则为当前日期)
注:当系统中电影的下线日期缺失时,endtime默认最多截止到starttime之后100天(不到100天则设置为当前日期)。如果指定日期的数据系统中没有保存,则统一按0或空字符串返回

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
items 每日网票列表,按照时间从小到大排序
pubdate 日期
totalSession 影片总场次
session 统计场次
attendance_rate 上座率
person_time 人次
price 票价
boxoffice 票房

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "items": [
             {
                "pubdate":"Wed, 31 Jul 2013 00:00:00 +0800",
                "total_session": 5562,
                "session":2232,
                "attendance_rate": 0.15,
                "person_time": 34567
                "price": 40,
                "boxoffice": 1505233
             },
             ......
          ]
       }
4 获取电影的从上映1一个月前到目前为止,每周内的新浪微博声量

请求URL:http://223.223.179.172:10080/api/volume.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vpuid 任务id(必选),对应唯一一部电影
starttime 声量的起始日期,返回值从starttime所在周开始(可选)
endtime 声量的结束日期,返回值截至endtime所在周结束(可选)

注:如果不传入starttime和endtime这两个时间参数,按默认逻辑返回结果:
1.目标电影的上映日期在2010年之前,则返回从当前日期开始往前3个月的数据,返回值中缺失的数据将置为0;
2.目标电影的上映日期在2010年之后,则返回从上映前三周开始到下线后三周为止的数据(若暂未下线或下线未满三周,则返回截止至当前的数据)。

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
total_mention 从电影上映前一个月到查询时为止的新浪微博声量总和
datas 统计数据项列表,每项是一周的声量,按照时间从小到大排列
mention 声量值,从pubdate开始一周内的新浪微博声量
pubdate 每一次统计开始的时间,时间段为一周

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "datas": [
             {
                "mention": 267434,
                "pubdate":"Wed, 31 Jul 2013 00:00:00 +0800"
             },
             {
                "mention": 13434,
                "pubdate":"Wed, 07 Aug 2013 00:00:00 +0800"
             },
             {
                "mention": 273245,
                "pubdate":"Wed, 14 Aug 2013 00:00:00 +0800"
             },
             ......
          ],
          "total_mention":345348537
       }
5 获取电影相关的指定网站评论信息

请求URL:http://223.223.179.172:10080/api/comment.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vpuid 任务id(必选)
page 指定页码,默认1(可选)
count 每页内容,默认20(可选)
domain 指定评论来源,支持新浪微博、优酷视频、豆瓣电影和时光网
mode mode=0按照发布日期排序,mode=1时,对于新浪微博按照转发量排序;对于优酷按照转发评论和排序;对于豆瓣按照转发量排序;对于时光网按照评论量排序
order order=0返回结果按倒序排列,否则按顺序排列
starttime 指定发布日期范围的起始时间
endtime 指定发布日期范围的结束时间

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
items 评论列表
eid 评论id
pubdate 评论时间
content 评论内容
link 评论链接
forward 转发量
reply 评论量
emotion 言论情感趋向,-1表示负向,0表示中立,1表示正向
domain 评论来源,(是来自豆瓣、优酷、新浪微博或时光网)
user 评论者信息
nid 评论者id
uri 评论者的主页url地址
name 评论者昵称
imgurl 评论者头像url地址
domain 评论者来源
page 当前页码
count 每页包含的数据量
total 数据总量

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "items": [
             {
                "eid":1200,
                "pubdate": "Wed, 31 Jul 2013 00:00:00 +0800",
                "content": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                "link":http://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
                "emotion":1,
                "domain":http://douban.com",
                "forward":10,
                "reply":5,
                "user": {
                   "nid":231,
	           "uri": " http://movie.douban.com/people/yinxiang/ ",
	           "name": "xxxxxxxxxxxxx",
	           "imgurl": " http://img3.douban.com/icon/u1228445-98.jpg ",
                   "domain": "http://douban.com"
                }
             },
             ......
          ],
          "page": 1,
          "count": 10,
          "total": 500
       }
6 获取指定电影所有影人的基本信息

请求URL:http://223.223.179.172:10080/api/stars.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vid 电影id(必选),对应唯一一个电影

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
starring 演员列表
director 导演列表
writer 编剧列表
sid 明星id
name 影人姓名
name_en 影人英文名字
douban_uri 影人的豆瓣主页
imdbId 影人的imdb id
imgurl 影人的头像链接
gender 性别
birthday 生日
homeplace 出生地
sinfo 新浪微博信息
qinfo 腾讯微博信息
vpuid 微博账户分析对应的vpuid
url 微博账户地址
fans 粉丝数
nick 微博账户名
headImg 微博头像

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "starring": [
             {
                "sid":1,
                "name": "刘德华",
                "name_en": "Andy Lua,
                "douban_uri ":" http://movie.douban.com/celebrity/1054424/,
                "imdbId": "xxxxxxxx",
                "imgurl":"xxxxxx",
                "gender": "男",
                "birthday": " "Wed, 27 Sep 1961 00:00:00 +0800" ",
                "homeplace": "香港 新界",
                "sinfo": {
                   "vpuid": xxx,
                   "url": "http://xxx.xxx.xxx",
                   "fans": 1000,
                   "nick": "aaa",
                   "headImg": "http://tp2.sinaimg.cn/1342158593/180/5627493764/1"
                },
                "qinfo": {
                   "vpuid": xxx,
                   "url": "http://xxx.xxx.xxx",
                   "fans": 1000,
                   "nick": "aaa",
                   "headImg": "http://tp2.sinaimg.cn/1342158593/180/5627493764/1"
                },
              },
              ......
           ],
           "director": [
              {
                 "sid":5,
 		 "name":"杜琪峰",
                 ......
               },
               ......
           ],
           "writer":[ ...... ]
        }
7 获取预告片的统计信息

请求URL:http://223.223.179.172:10080/api/trailer.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vid 电影id(必选),对应唯一一个电影

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
youku 优酷的视频列表,每个预告片的统计量都是最新的那一天的值,下同
qq QQ视频的视频列表
sohu 搜狐视频的视频列表
tudou 土豆的视频列表
iqiyi 爱奇艺的视频列表
letv 乐视的视频列表
url 预告片等视频的url地址
title 预告片等视频的标题
thumbnail 预告片缩略图
type 视频类型,有预告片、花絮、娱乐新闻
pubdate 本次返回的统计量所属的日期
views 播放次数
positive 点赞的次数
negetive 点踩的次数

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "youku": [
              {
                 "url":"http://v.youku.com/v_show/id_XNjMwMzYwMTY4.html",
                 "title":"《无人区》预告片",
                 "thumbnail":"xxxxxxxx",
                 "type ":"预告片",
                 "pubdate":"Thu, 5 Dec 2013 00:00:00 +0800",
                 "views ":"333696",
                 "positive ":"1917",
                 "negetive ":"48"
              },
              {
                 "url":"http://v.youku.com/v_show/id_XNjQxMjczMDUy.html",
                 "title":"《无人区》余男花絮 跳艳舞被活埋生死两重天",
                 "thumbnail":"xxxxxxxx",
                 "type":"花絮",
                 "pubdate":"Thu, 5 Dec 2013 00:00:00 +0800"
                 "views":"3818",
                 "positive ":"5",
                 "negetive ":"0"
              },
              ......
           ],
           "qq": [
              {
                 "url":"http://v.qq.com/prev/7/719xhxkl9qdp267.html?vid=f0013qjqxix",
                 "title":"《无人区》导演花絮 宁浩战天斗地挥洒青春",
                 "thumbnail":"",
                 "type ":"花絮",
                 "pubdate":"Thu, 05 Dec 2013 00:00:00 +0800"
                 "views ":"1409766",
                 "positive ":"2",
                 "negetive ":"0"
              },
               ......
           ],
           "sohu":[ ...... ],
           "tudou":[ ...... ],
           "iqiyi":[ ...... ],
           "letv":[ ...... ]
        }
8 获取指定vid的电影想看量

请求URL:http://223.223.179.172:10080/api/moviewish.json
返回格式:JSONP
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vid 电影id(必选)

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
datas 想看量数据
type 当前电影的想看量来源
data 当前电影当前来源对应的想看量数据
id 未使用
movieId 电影id
movieName 电影名称
pubDate 想看量数据获取时间
type 想看量来源
wish 想看量

返回JSONP实例:

callback({
    "code": 0,
    "datas": [
        {
            "data": [
                {
                    "id": null,
                    "movieId": 3758,
                    "movieName": "智取威虎山",
                    "pubDate": "2014-10-23T00:00:00",
                    "type": "douban.com",
                    "wish": 4
                },
		...
            ],
            "type": "douban.com"
        },
        {
            "data": [
                {
                    "id": null,
                    "movieId": 3758,
                    "movieName": "智取威虎山",
                    "pubDate": "2014-10-23T00:00:00",
                    "type": "meituan.com",
                    "wish": 26
                },
		...
            ],
            "type": "meituan.com"
        },
		...
    ],
    "msg": "ok"
})
9 获取指定影人的基本信息

请求URL:http://223.223.179.172:10080/api/starinfo.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
sid 影人id(若存在则下述参数失效)
name 影人中文名字(无sid时必选)
name_en 影人英文名字(可选)
gender 影人性别
birthday 出生年份(可选,例1962)
homeplace 出生地(可选)

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
sid 明星id
name 影人姓名
name_en 影人英文名字
douban_uri 影人的豆瓣主页
imdbId 影人的imdb id
imgurl 影人的头像链接
gender 性别
birthday 生日
homeplace 出生地
score 影人评分
sinfo 新浪微博信息
qinfo 腾讯微博信息
vpuid 微博账户分析对应的vpuid
url 微博账户地址
fans 粉丝数
nick 微博账户名
headImg 微博头像

返回JSON实例:

       {
  "code": 0,
  "msg": "ok",
  "stars": [
    "sid": 1,
    "name": "宋佳",
    "name_en": "Andy Lua",
    "douban_uri": "http: //movie.douban.com/celebrity/1054424/",
    "imdbId": "xxxxxxxx",
    "imgurl": "xxxxxx",
    "gender": "女",
    "birthday": ""Wed,11 Jan 1962 00: 00: 00 +0800"",
    "homeplace": "山东青岛",
    "score": 129.535,
    "sinfo": {
      "vpuid": xxx,
      "url": "http: //xxx.xxx.xxx",
      "fans": 1000,
      "nick": "aaa",
      "headImg": "http: //tp2.sinaimg.cn/1342158593/180/5627493764/1"
    },
    "qinfo": {
      "vpuid": xxx,
      "url": "http: //xxx.xxx.xxx",
      "fans": 1000,
      "nick": "aaa",
      "headImg": "http: //tp2.sinaimg.cn/1342158593/180/5627493764/1"
    }
  ],
  [
    "sid": 2,
    "name": "宋佳",
    "name_en": "Andy Lua",
    "douban_uri": "http: //movie.douban.com/celebrity/1054425/",
    "imdbId": "xxxxxxxx",
    "imgurl": "xxxxxx",
    "gender": "女",
    "birthday": ""Wed, 13 Nov 1980 00: 00: 00 +0800"",
    "homeplace": "黑龙江哈尔滨",
    "score": 363.768,
    "sinfo": {
      "vpuid": xxx,
      "url": "http: //xxx.xxx.xxx",
      "fans": 1000,
      "nick": "aaa",
      "headImg": "http: //tp2.sinaimg.cn/1342158593/180/5627493764/1"
    },
    "qinfo": {
      "vpuid": xxx,
      "url": "http: //xxx.xxx.xxx",
      "fans": 1000,
      "nick": "aaa",
      "headImg": "http: //tp2.sinaimg.cn/1342158593/180/5627493764/1"
    ]
  }
10 获取指定电影主创团队的基本信息

请求URL:http://223.223.179.172:10080/api/team.json
返回格式:JSON
请求方式:HTTP GET
授权方式:OAuth 2.0(基于APP密钥的授权模式)
请求参数:

参数名称 说明
weiresearch_oauth_token OAuth授权得到的token
vid 电影id(必选)

返回字段说明:

参数名称 说明
code 返回值,0表示正确,非零表示不正确
msg 提示信息,ok表示正确
stars 演员列表
director 导演列表
writer 编剧列表
sid 影人id
name 影人姓名
name_en 影人英文名
gender 影人性别
homeplace 影人出生地
sumcore 主创总评分
avgcore 主创平均评分

返回JSON实例:

       {
          "code": 0,
          "msg": "ok",
          "vid":1,
          "movieName":"无间道",
          "director": [
              {
                 "sid":5,
                 "name":"杜琪峰",
                 "name_en":"Qifeng Du",
                 "gender":"男",
                 "homeplace":"香港"
               },
               ......
           ],
           "writer":[ ...... ],
          "stars": [
             {
                "sid":1,
                "name": "刘德华",
                 ...
              },
              ......
           ],
           "sumscore":6523.467,
           "acgscore":123.23
        }

Leave A Reply