猫眼电影API-杨标的博客

猫眼电影API接口文档

文档说明

运行平台：nodejs
服务器语言：NodeJS+mysql
服务器地址：www.softeem.xin
编写人员：杨标
编写时间：2019年9月10日星期二

一、获取城市列表

描述

该功能主要是用于获取所有城市的列表
请求地址

操作名称 /maoyanApi/dianying/cities.json

协议 https

请求方式 GET

URL全径请参考第5点
请求参数

无
返回数据

返回的数据是一个json对象，里面字段如下

序号名称类型备注

1 cts Array 城市列表数组

2 Id Number 序号

3 nm String 城市中文名称

4 py String 城市英文名称
请求URL实例

https://www.softeem.xin/maoyanApi/dianying/cities.json
返回数据实例

实例数据

Json数据实例 {"cts": [{"id": 1,"nm": "北京","py": "beijing"}......]}

操作名称	/maoyanApi/dianying/cities.json
协议	https
请求方式	GET
URL全径	请参考第5点

序号	名称	类型	备注
1	cts	Array	城市列表数组
2	Id	Number	序号
3	nm	String	城市中文名称
4	py	String	城市英文名称

实例	数据
Json数据实例	{"cts": [{"id": 1,"nm": "北京","py": "beijing"}......]}

二、获取即将上映电影信息

描述

调用此接口可获取某一个城市某一个时间段内即将上映的电影信息
请求地址

操作名称 /maoyanApi/ajax/comingList

协议 https

请求方式 GET

URL全径请参考第5点

操作名称	/maoyanApi/ajax/comingList
协议	https
请求方式	GET
URL全径	请参考第5点

请求参数

序号	参数名	中文名称	必选	数据类型	备注
1	ci	城市编码	Y	Number	需市编码，通过上一个接口获取的城市编码
2	token	随机效果码	Y	String	此参数请留空
3	limit	获取多少条	Y	Number	获取多少条记录

返回数据

返回的数据是一个json对象

序号	名称	类型	备注
1	coming	Array	即将上映的电影
2	movieIds	Array	所有电影的ID

电影详细信息，movieList里面单个对象

序号	名称	类型	备注
1	globalReleased	Boolean	是否全球上映
2	haspromotionTag	Boolean	是否有推荐标志(是否是推荐电影)
3	id	Number	电影的编号
4	img	String	电影图片的URL地址，请将图片地址中的”w.h”更改为”128.180”,“128.180”是图片的大小
5	nm	String	电影名称
6	preShow	Boolean	是否是预告片
7	rt	String	上映时间
8	sc	String	电影评分
9	showInfo	String	电影的上映信息
10	showst	Number	无实际意义，用户请忽略
11	star	String	电影演员明星
12	version	String	电影版本
13	wish	Number	多少人想看
14	wishst	Number	无实际意义，用户请忽略
15	comingTitle	String	电影上映日期

请求URL实例

https://www.softeem.xin/maoyanApi/ajax/comingList?ci=57&token=&limit=10

返回数据实例

数据	实例
Json数据实例	{"coming": [{"id": 1227611,"haspromotionTag": false,"img": "http://p0.meituan.net/w.h/movie/d18915868f6e3e6e287162354700690f2338229.jpg","version": "","nm": "小小的愿望","preShow": false,"sc": 0,"globalReleased": false,"wish": 233489,"star": "彭昱畅,王大陆,魏大勋","rt": "2019-09-12","showInfo": "2019-09-12 本周四上映","showst": 4,"wishst": 0,"comingTitle": "9月12日周四"},.......],movieIds:[]}

数据

实例

Json数据实例

{"coming": [{"id": 1227611,"haspromotionTag": false,"img": "http://p0.meituan.net/w.h/movie/d18915868f6e3e6e287162354700690f2338229.jpg","version": "","nm": "小小的愿望","preShow": false,"sc": 0,"globalReleased": false,"wish": 233489,"star": "彭昱畅,王大陆,魏大勋","rt": "2019-09-12","showInfo": "2019-09-12 本周四上映","showst": 4,"wishst": 0,"comingTitle": "9月12日周四"},.......],movieIds:[]}

三、获取正在热映电影信息

描述

调用此接口获取猫眼电影正在热映的电影信息
请求地址

操作名称 /maoyanApi/ajax/movieOnInfoList

协议 https

请求方式 GET

URL全径请参考第5点
请求参数

无

操作名称	/maoyanApi/ajax/movieOnInfoList
协议	https
请求方式	GET
URL全径	请参考第5点

返回数据

返回的数据是一个json对象

序号	名称	类型	备注
1	coming	Array	即将上映的电影，此项为空
2	movieIds	Array	所有电影的ID
3	movieList	Array	所有电影信息的列表
4	stid	String	当前请求的随机状态码，请用户忽略
5	stids	Array	所有电影的随机状态码，请用户忽略
6	total	Number	一共有多少电影信息

电影详细信息，movieList里面单个对象

序号	名称	类型	备注
1	globalReleased	Boolean	是否全球上映
2	haspromotionTag	Boolean	是否有推荐标志(是否是推荐电影)
3	id	Number	电影的编号
4	img	String	电影图片的URL地址，请将图片地址中的”w.h”更改为”128.180”,“128.180”是图片的大小
5	nm	String	电影名称
6	preShow	Boolean	是否是预告片
7	rt	String	上映时间
8	sc	String	电影评分
9	showInfo	String	电影的上映信息
10	showst	Number	无实际意义，用户请忽略
11	star	String	电影演员明星
12	version	String	电影版本
13	wish	Number	多少人想看
14	wishst	Number	无实际意义，用户请忽略

请求URL实例

https://www.softeem.xin/maoyanApi/ajax/movieOnInfoList

返回数据实例

数据	实例
Json数据实例	{"coming": [],"movieIds": [],"stid": "576591972453269000","stids": [],"total": 62,"movieList": [{"id": 359377,"haspromotionTag": false,"img": "http://p0.meituan.net/w.h/movie/2918a5e403dde6e4254941968d7719ce3942369.jpg","version": "","nm": "罗小黑战记","preShow": false,"sc": 9.4,"globalReleased": true,"wish": 167173,"star": "刘明月","rt": "2019-09-07","showInfo": "今天127家影院放映1685场","showst": 3,"wishst": 0}....]}

数据

实例

Json数据实例

{"coming": [],"movieIds": [],"stid": "576591972453269000","stids": [],"total": 62,"movieList": [{"id": 359377,"haspromotionTag": false,"img": "http://p0.meituan.net/w.h/movie/2918a5e403dde6e4254941968d7719ce3942369.jpg","version": "","nm": "罗小黑战记","preShow": false,"sc": 9.4,"globalReleased": true,"wish": 167173,"star": "刘明月","rt": "2019-09-07","showInfo": "今天127家影院放映1685场","showst": 3,"wishst": 0}....]}

四、获取城市电影院信息

描述

调用此接口获取某一城市电影院信息
请求地址

操作名称 /maoyanApi/ajax/cinemaList

协议 https

请求方式 GET

URL全径请参考第5点

操作名称	/maoyanApi/ajax/cinemaList
协议	https
请求方式	GET
URL全径	请参考第5点

请求参数

序号	参数名	中文名称	必选	数据类型	备注
1	day	当前日期	Y	String	请求的日期如2019-9-10
2	cityId	当前城市的编号	Y	Number	某一城市ID，传入此ID后可获取当前城市的电影院信息
3	updateShowDay	更新显示日期	Y	Boolean	填写默认值true
4	limit	获取记录条数	Y	Number	默认请填写20

返回数据

返回的数据是一个json对象

序号	名称	类型	备注
1	cinemas	Array	当前请求城市的电影院列表
2	ct_pois	Array	当前电影院的地址ID
3	paging	Object	分页的对象信息

电影院详细信息，cinemas里面单个对象

序号	名称	类型	备注
1	addr	String	当前电影院的地址
2	distance	String	电影院距离
3	id	Number	电影院院编号
4	mark	Boolean	是否有标记（收藏）
5	nm	String	电影院名称
6	promotion	Object	电影院促销信息
7	sellPrice	String	电影票价
8	tag	Object	当前电影标标签
tag属性	allowRefund	Number	是否允许退款
buyout	Number	无实际意义，用户请忽略
cityCardTag	Number	城市卡标记
vipTag	Number	VIP是否有折扣卡
snack	Number	是否有小吃
endorse	Number	是否可以改签
hallTypeVOList	Object	其它信息

分页信息里面的paging里面的对象信息

序号	名称	类型	备注
1	hasMore	Boolean	是否还有更多数据
2	limit	Number	当前要取多少条
3	offset	Number	当前跳过了多少条
4	total	Number	当前一共有多少条数据

请求URL实例

https://www.softeem.xin/maoyanApi/ajax/cinemaList?day=2019-9-11&cityId=57&updateShowDay=true&limit=20

返回数据实例

Json数据实例

"cinemas": [{"id": 6092,"mark": 0,"nm": "汉南影城","sellPrice": "23","addr": "汉南区汉南大道315号武商量贩五楼","distance": "887.5km","tag": {"allowRefund": 1,"buyout": 0,"cityCardTag": 0,"deal": 0,"endorse": 1,"hallTypeVOList": [],"sell": 1,"snack": 1,"vipTag": "折扣卡"},"promotion": {}},ct_pois:[{"ct_poi": "936879945111165696_a6092_c0","poiid": 2499576},......],"paging": {"hasMore": true,"limit": 20,"offset": 0,"total": 140}}

五、获取获取票房信息

描述

获取猫眼电影的票房信息
请求地址

操作名称 /maoyanApi/box/promovie/api/box/second.json

协议 https

请求方式 GET

URL全径请参考第5点
请求参数

无

操作名称	/maoyanApi/box/promovie/api/box/second.json
协议	https
请求方式	GET
URL全径	请参考第5点

返回数据

返回的数据是一个json对象

序号	名称	类型	备注
1	success	Boolean	是否请求成功，成功为true
2	data	Object	请求
	crystal	Object	电影当日上映信息
	list	Array	电影票房信息列表
	queryDate	String	查询日期
	serverTime	String	服务器时间
	serverTimestamp	Number	服务器时间戳
	splitTotalBox	String	分账总票房
	splitTotalBoxInfo	String	分账总票房信息
	splitTotalBoxUnit	String	单位
	splitTotalBoxUnitInfo	String	单位
	totalBox	String	总票房
	totalBoxInfo	String	总票房信息
	totalBoxUnit	String	单位
	totalBoxUnitInfo	String	单位
	updateInfo	String	票房更新时间

单个票房信息数据展示

序号	名称	类型	备注
1	avgSeatView	String	平均上座率
2	avgShowView	String	均场人次
3	avgViewBox	String	忽略
4	boxInfo	String	实时票房
5	boxRate	String	票房占比
6	movieId	String	电影编号
7	movieName	String	电影名称
8	releaseInfo	String	上映信息
9	seatRate	String	电影上座率
10	showRate	String	排版占比

请求URL实例

https://www.softeem.xin/maoyanApi/box/promovie/api/box/second.json

返回数据实例

Json数据实例数据量过大，请直接请求数据以作参考

六、获取电影详细信息

描述

获取猫眼中某一个电影的详细信息
请求地址

操作名称 /maoyanApi/ajax/detailmovie

协议 https

请求方式 GET

URL全径请参考第5点
请求参数

序号参数名中文名称必选数据类型长度备注

1 movieId 电影ID Y String 电影的编号

操作名称	/maoyanApi/ajax/detailmovie
协议	https
请求方式	GET
URL全径	请参考第5点

序号	参数名	中文名称	必选	数据类型	长度	备注
1	movieId	电影ID	Y	String		电影的编号

返回数据

返回的数据是一个json对象，快递的主要信息在detailMovie里面

序号	名称	类型	备注
1	detailMovie	Boolean	是否请求成功，成功为true
detailMovie中的属性	albumImg	String	海报图片
availableEpisodes	Number	可用的插曲
awardUrl	String	URL地址
backgroundColor	String	背景颜色
bingeWatch	Number	一次看完人数
bingeWatchst	Number	无实际意义
cat	String	电影分类
dra	String	电影简介信息
dur	Number	持续时间，分钟为单位
enm	String	电影的外文名称
episodeDur	String	电影一集时长
episodes	Number	电影有几段
globalReleased	Boolean	电影是否有全球上映
id	Number	电影编号
img	String	电影图片URL，请将”w.h”换成具体图片大小如`128.180`
musicName	String	电影音乐名称
musicNum	Number	音乐数量
musicStar	Number	唱歌的演员
nm	String	电影名称
onSale	Boolean	是否正在售票
onlinePlay	Boolean	是否可在线播放
oriLang	String	电影语言
photos	Array	电影图片集（海报集）
pubDesc	String	电影上映信息
rt	String	电影上映时间
sc	String	电影评分
star	String	电影明星演员
ver	String	电影版本，如2D/4DX
videourl	String	电影预告片URL
videoName	String	电影预告片名称
videoImg	String	电影预告片图片
wish	Number	多少人想看
watched	Number	多少人已经观看

请求URL实例

https://www.softeem.xin/maoyanApi/ajax/detailmovie?movieId=359377
返回数据实例

Json数据实例数据量过大，请直接请求数据以作参考

目录CONTENT

猫眼电影API

猫眼电影API接口文档

文档说明

一、获取城市列表

二、获取即将上映电影信息

三、获取正在热映电影信息

四、获取城市电影院信息

五、获取获取票房信息

六、获取电影详细信息

评论区