影讯API合集
最后更新于：2022-04-02 08:24:40
## 影讯API合集（不再维护）
> 影片信息、评分、影视票房榜,电影院上映信息等API
## 接口费用（ [点击购买](https://market.topthink.com/product/322)）
> 最低 0.01元/次
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
## 接口1：关键字检索影片信息
### 请求地址
```
GET https://api.topthink.com/movie/search
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| title | 是 | string | 需要检索的影片标题,utf8编码的urlencode |
| smode | 否 | int | 是否精确查找，精确:1 模糊:0 默认1 |
| pagesize | 否 | int | 每次返回条数，默认20,最大50 |
| offset | 否 | int | 偏移量，默认0,最大760 |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- | --- |
| movieid | string | 影片唯一标识ID |
| actors | string | 影片的演员列表。 |
| also\_known\_as | string | 影片的其它名称。 |
| country | string | 影片的拍摄国家。 |
| directors | string | 影片的导演列表。 |
| film\_locations | string | 影片的拍摄地。 |
| genres | string | 影片的分类。（如：戏剧，战争） |
| language | string | 影片的对白使用的语言。 |
| plot\_simple | String | 影片的剧情概要。 |
| poster | String | 影片的海报。 |
| rated | String | 影片的分类与评级。 |
| rating | string | 影片的得分。 |
| rating\_count | string | 影片的评分人数。 |
| release\_date | Int | 影片的上映时间。 |
| runtime | string | 影片的持续时间。 |
| title | string | 影片的名称。 |
| type | string | 影片类型. |
| writers | string | 影片的编剧列表。 |
| year | Int | 影片的拍摄年代。 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->airSearch()
->withCity('苏州')
->request();
dump($result);
```
返回示例
```
{
"code": 0,
"message": "成功",
"data":[
{
"movieid": "10641",
"rating": "7.3",
"genres": "动作/惊悚/科幻",
"runtime": "139 min",
"language": "英语/法语/日语",
"title": "哥斯拉",
"poster": "http://v.juhe.cn/movie/img?5146",
"writers": "迪安·德夫林,罗兰·艾默里奇,...",
"film_locations": "美国",
"directors": "罗兰·艾默里奇",
"rating_count": "3191",
"actors": "马修·布罗德里克 Matthew Broderick,让·雷诺 Jean Reno,玛丽亚·皮提罗 Maria Pitillo,汉克·阿扎利亚 Hank Azaria",
"plot_simple": "一道亮光划过天际，太平洋上波涛汹涌，海浪以不可思议的速度将一架货机卷入海里；巴哈马丛林中，出现了巨大的脚印；一股神秘的力量一直朝纽约而来，这座人口稠密的都市即将受到这个怪兽“哥斯拉”的袭击。“哥斯拉”是因为核试验造成气..",
"year": "1998",
"country": "美国",
"type": "null",
"release_date": "19980518",
"also_known_as": "酷斯拉,怪兽哥斯拉"
},
{
"movieid": "133175",
"rating": "-1",
"genres": "动画/短片/喜剧",
"runtime": "2 min",
"language": "无",
"title": "小鹿斑比遇见哥斯拉",
"poster": "http://v.juhe.cn/movie/img?14923",
"writers": "Marv Newland",
"film_locations": "加拿大",
"directors": "Marv Newland",
"rating_count": "7",
"actors": "",
"plot_simple": "null",
"year": "1969",
"country": "加拿大",
"type": "null",
"release_date": "20090418",
"also_known_as": ""
}
]
}
```
## 接口2：检索周边影院
### 请求地址
```
GET https://api.topthink.com/movie/cinemas
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| lat | 是 | string | 纬度，百度地图坐标系 |
| lon | 是 | string | 经度，百度地图坐标系 |
| radius | 是 | string | 检索半径(米)，最大3000 |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| id | string | 电影院ID |
| cityName | string | 影院所属城市 |
| cinemaName | string | 影院名称 |
| address | string | 影院地址 |
| telephone | string | 联系电话 |
| latitude | double | 纬度，适合百度地图 |
| longitude | double | 经度，适合百度地图 |
| trafficRoutes | string | 交通路线 |
| distance | string | 大概距离(米) |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieCinemas()
->withLat('31.30947')
->withLon('31.30947')
->withRadius(2000)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":[
{
"id": "1190",
"cityName": "苏州",
"cinemaName": "苏州幸福蓝海IMAX影城",
"address": "苏州市广济南路219号新苏天地9楼",
"telephone": "0512-65899658",
"latitude": "31.30947",
"longitude": "120.6003",
"trafficRoutes": "",
"distance": 0
},
{
"id": "1196",
"cityName": "苏州",
"cinemaName": "金逸苏州石路永捷店",
"address": "苏州市姑苏区广济南路19号西城永捷生活广场6楼",
"telephone": "0512-65703050",
"latitude": "31.30411",
"longitude": "120.6012",
"trafficRoutes": "游1、7路、88路、204路、34路、",
"distance": 603
},
{
"id": "1201",
"cityName": "苏州",
"cinemaName": "苏州橙天嘉禾影城（来客茂店）",
"address": "苏州金阊区桐泾北路218号来客茂时尚生活广场4F",
"telephone": "0512-86860919",
"latitude": "31.31268",
"longitude": "120.5894",
"trafficRoutes": "311路、400路上行、游5路、317路、949路、441路、34路，到西园东站下车",
"distance": 1097
},
{
"id": "1210",
"cityName": "苏州",
"cinemaName": "苏州星美影城（李公堤店）即将开业",
"address": "苏州市工业园区李公堤四期一幢",
"telephone": "",
"latitude": "31.29889",
"longitude": "120.5853",
"trafficRoutes": "178、207、100、168路公交到达",
"distance": 1850
}
]
}
```
## 接口3：关键字影院检索
### 请求地址
```
GET https://api.topthink.com/movie/cinema_search
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| cityid | 是 | string | 城市ID（参考支持城市列表接口） |
| keyword | 否 | string | 关键字，urlencode utf8 |
| page | 否 | int | 页数，默认1 |
| pagesize | 否 | int | 每页返回条数，默认20，最大20 |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| id | string | 电影院ID |
| cityName | string | 影院所属城市 |
| cinemaName | string | 影院名称 |
| address | string | 影院地址 |
| telephone | string | 联系电话 |
| latitude | double | 纬度，适合百度地图 |
| longitude | double | 经度，适合百度地图 |
| trafficRoutes | string | 交通路线 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieCinemaSearch()
->withCityId(2)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":[
{
"id": "141",
"cityName": "北京",
"cinemaName": "北京博纳影城朝阳门旗舰店",
"address": "北京市朝阳区三丰北里2号楼悠唐生活广场B1层（朝阳门钱柜对面）",
"telephone": "010-59775660",
"latitude": "39.92223",
"longitude": "116.4388",
"trafficRoutes": "乘坐101电，109电，110，112电，420，750路公交在朝阳门外站下车，悠唐生活广场地下一层"
},
{
"id": "142",
"cityName": "北京",
"cinemaName": "北京橙天嘉禾吉彩影城",
"address": "北京海淀区玉海园五里22号配套商业楼（原吉彩体育馆）",
"telephone": "",
"latitude": "39.92282",
"longitude": "116.2596",
"trafficRoutes": "地铁一号线 玉泉路下车，B2出口出，乘坐507、78、981、612、运通114 玉海园东门下车即到。"
},
{
"id": "143",
"cityName": "北京",
"cinemaName": "首都电影院（金融街店）",
"address": "金融大街18号金融街购物中心二期地下一层",
"telephone": "010-66086662",
"latitude": "39.91509",
"longitude": "116.3604",
"trafficRoutes": "7路、21路、38路、44路、50路、46路、68路、84路、387路、423路、456路、477路、618路、691路、694路、939路复兴门南站\n"
},
{
"id": "144",
"cityName": "北京",
"cinemaName": "博纳国际影城通州店",
"address": "北京市通州区杨庄北里天时名苑14号楼F4-01",
"telephone": "010-56351916-800",
"latitude": "39.90354",
"longitude": "116.6367",
"trafficRoutes": "地铁：城铁八通线通州北苑站B出口。\n公交：312、322、649、666、667、668、669、728、801、804、805、810、924、811、938、916、976、916、924、930、372、435、615、647、郊87、通12路到北苑站下车即可。"
},
{
"id": "145",
"cityName": "北京",
"cinemaName": "大地数字影院-北京望京新天地",
"address": "北京市朝阳区望京合生麒麟社影院",
"telephone": "010-57389754",
"latitude": "39.99717",
"longitude": "116.4774",
"trafficRoutes": "420路、467路、470路、471路、538路、621路、运通104线至望京西园四区下车即可"
},
{
"id": "146",
"cityName": "北京",
"cinemaName": "大地数字影院-北京延庆金锣湾",
"address": "北京市延庆县妫水北街39号1幢H座首层（金锣湾商业中心）沃尔玛旁",
"telephone": "010-60165114",
"latitude": "40.46144",
"longitude": "115.9765",
"trafficRoutes": "920、919、921、925路公车到达"
},
{
"id": "147",
"cityName": "北京",
"cinemaName": "大地数字影院-通州马驹桥米拉",
"address": "北京市通州区新油东路1号米拉时尚生活广场七层",
"telephone": "010-80897926",
"latitude": "39.76124",
"longitude": "116.5453",
"trafficRoutes": "凉水河桥南-公交车站：542路环线, 723路, 826路, 846路, 975路,976路, 专41路\n马驹桥新桥-公交车站：28-29联运, 821路, 846路, 927路, 976路,郊87路, 郊87路空调, 通12路, 通28路"
},
{
"id": "148",
"cityName": "北京",
"cinemaName": "大地数字影城--西三旗物美",
"address": "北京海淀区悦秀路99号二层大地影院",
"telephone": "010-60603728",
"latitude": "40.05296",
"longitude": "116.3376",
"trafficRoutes": "2路、753路、478路、315路、614路"
},
{
"id": "149",
"cityName": "北京",
"cinemaName": "UME国际影城(安贞店)",
"address": "北京市东城区北三环东路36号环球贸易中心E座B1/F1/F3",
"telephone": "010-58257733",
"latitude": "39.96822",
"longitude": "116.4103",
"trafficRoutes": "乘公交车：安贞桥东下车：300、683、117、718、302、998、731、954、985、特8、运通104和平西桥南下车：125、430、75\n乘坐地铁5号线可在和平西桥站下车，从A或C出口出站向西行\n"
},
{
"id": "150",
"cityName": "北京",
"cinemaName": "首都电影院（西单店）",
"address": "西城区西单北大街甲131号大悦城商场十层",
"telephone": "010-66086662",
"latitude": "39.91076",
"longitude": "116.3733",
"trafficRoutes": "可乘1、10、22、37、52、70、728在西单路口东下车。可乘102、105、109、22、46、47、603、604、626、690、在西单商场下车。也可乘地铁1号线在西单下车走西北出口。自驾前往，有地下停车场。"
}
],
"page": 1,
"pagesize": 10,
"totalpage": 14
]
}
```
## 接口4：影院上映影片信息
### 请求地址
```
GET https://api.topthink.com/movie/cinema_movies
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| cinemaid | 是 | int | 影院ID |
| movieid | 否 | int | 指定电影ID，默认全部电影 |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| movieId | string | 电影ID |
| movieName | string | 电影名称 |
| pic\_url | string | 电影图片 |
| broadcast | array | 电影的场次信息 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieCinemaMovies()
->withCinemaId(1188)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":[
"cinema_info": {
"id": "1188",
"name": "橙天嘉禾苏州影城",
"city": "苏州",
"telephone": "0512-69566540",
"address": "苏州工业园区现代大道1699号 印象城三层"
},
"lists": [
{
"movieId": "151951",
"movieName": "美国队长2",
"pic_url": "http://img31.mtime.cn/mt/2014/03/16/154554.36400206_96X128.jpg",
"broadcast": [
{
"hall": "7号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709956/",
"time": "11:20"
},
{
"hall": "1号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709930/",
"time": "12:10"
},
{
"hall": "3号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709938/",
"time": "13:00"
},
{
"hall": "5号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709947/",
"time": "13:40"
},
{
"hall": "1号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709931/",
"time": "14:40"
},
{
"hall": "3号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709939/",
"time": "15:30"
},
{
"hall": "5号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709948/",
"time": "16:30"
},
{
"hall": "3号厅",
"price": "93",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709940/",
"time": "18:00"
},
{
"hall": "5号厅",
"price": "93",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709949/",
"time": "19:10"
},
{
"hall": "1号厅",
"price": "93",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709932/",
"time": "19:50"
},
{
"hall": "3号厅",
"price": "93",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709941/",
"time": "20:30"
},
{
"hall": "9号厅",
"price": "93",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709966/",
"time": "21:10"
},
{
"hall": "1号厅",
"price": "93",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709933/",
"time": "22:20"
}
]
},
{
"movieId": "172743",
"movieName": "魔警",
"pic_url": "http://img31.mtime.cn/mt/2014/04/09/085413.72005937_96X128.jpg",
"broadcast": [
{
"hall": "9号厅",
"price": "43",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709967/",
"time": "10:50"
},
{
"hall": "8号厅",
"price": "43",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709962/",
"time": "13:15"
},
{
"hall": "9号厅",
"price": "43",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709968/",
"time": "14:15"
},
{
"hall": "8号厅",
"price": "43",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709963/",
"time": "15:20"
},
{
"hall": "9号厅",
"price": "43",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709969/",
"time": "16:40"
},
{
"hall": "8号厅",
"price": "43",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709964/",
"time": "17:50"
},
{
"hall": "9号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709970/",
"time": "19:00"
},
{
"hall": "2号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709934/",
"time": "20:50"
},
{
"hall": "5号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709950/",
"time": "21:40"
},
{
"hall": "7号厅",
"price": "63",
"ticket_url": "http://piao.mtime.com/onlineticket/showtime/79709957/",
"time": "22:30"
}
]
}
]
}
```
## 接口5：今日上映影片
### 请求地址
```
GET https://api.topthink.com/movie/today
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| cityid | 是 | int | 城市ID |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| movieId | string | 电影ID |
| movieName | string | 影片名称 |
| pic\_url | string | 影片图片 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieCinemaSearch()
->withCityId(3)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":[
{
"movieId": "21250",
"movieName": "白日梦想家",
"pic_url": "http://img31.mtime.cn/mt/2013/11/26/074429.68199128_96X128.jpg"
},
{
"movieId": "134509",
"movieName": "最强囍事",
"pic_url": "http://img21.mtime.cn/mt/2011/01/13/122711.93922385_96X128.jpg"
}
]
}
```
## 接口6：支持城市列表
### 请求地址
```
GET https://api.topthink.com/movie/support_city
```
### 请求参数
无
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| id | string | 城市ID |
| city\_name | string | 城市名称 |
| city\_pre | string | 城市前缀 |
| city\_pinyin | string | 城市拼音 |
| city\_short | string | 城市简写 |
| count | string | 影院数量 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieSupportCity()
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":[
{
"id": "1",
"city_name": "上海",
"city_pre": "S",
"city_pinyin": "Shanghai",
"city_short": "sh",
"count": "141"
},
{
"id": "2",
"city_name": "北京",
"city_pre": "B",
"city_pinyin": "Beijing",
"city_short": "bj",
"count": "137"
}
...
]
}
```
## 接口7：影片上映影院查询
### 请求地址
```
GET https://api.topthink.com/movie/show_cinema
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| cityid | 是 | int | 城市ID |
| movieid | 是 | int | 影片ID |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
cinemaName | string | 影院名称 |
| cinemaId | string | 影院ID |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieShowCinema()
->withCityid(1)
->withMovieid(190465)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":[
{
"cinemaName": "金逸影城上海龙之梦IMAX店",
"cinemaId": "1",
"address": "上海市虹口区西江湾路388号凯德龙之梦B座6F-7F",
"latitude": "31.27125",
"longitude": "121.4787"
},
{
"cinemaName": "上海南桥海上国际影城",
"cinemaId": "2",
"address": "上海奉贤区百齐路288号（百联二期四楼）",
"latitude": "30.91572",
"longitude": "121.4829"
},
...
]
}
```
## 接口8：按影片ID检索影片信息
### 请求地址
```
GET https://api.topthink.com/movie/index
```
### 请求参数
| 名称 | 必填 | 类型 | 说明 |
| --- | --- | --- | --- |
| movieid | 是 | int | 影片ID |
### 返回`data`参数
| 名称 | 类型 | 说明 |
| --- | --- | --- |
| movieid | string | 影片唯一标识ID |
| actors | string | 影片的演员列表。 |
| also\_known\_as | string | 影片的其它名称。 |
| country | string | 影片的拍摄国家。 |
| directors | string | 影片的导演列表。 |
| film\_locations | string | 影片的拍摄地。 |
| genres | string | 影片的分类。（如：戏剧，战争） |
| language | string | 影片的对白使用的语言。 |
| plot\_simple | String | 影片的剧情概要。 |
| poster | String | 影片的海报。 |
| rated | String | 影片的分类与评级。 |
| rating | string | 影片的得分。(-1表示未评分) |
| rating\_count | string | 影片的评分人数。 |
| release\_date | Int | 影片的上映时间。 |
| runtime | string | 影片的持续时间。 |
| title | string | 影片的名称。 |
| type | string | 影片类型. |
| writers | string | 影片的编剧列表。 |
| year | Int | 影片的拍摄年代。 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->movieIndex()
->withMovieid(190465)
->request();
dump($result);
```
返回结果示例:
```
{
"code": 0,
"message": "成功",
"data":{
"movieid": "137742",
"rating": "-1",
"genres": "动作/冒险/科幻",
"runtime": "null",
"language": "英语",
"title": "哥斯拉",
"poster": "http://v.juhe.cn/movie/img?55370",
"writers": "麦克斯·鲍任斯坦,达夫·卡拉汉姆",
"film_locations": "美国|日本",
"directors": "加里斯·爱德华斯",
"rating_count": "288",
"actors": "亚伦·泰勒-约翰逊 Aaron Taylor-Johnson,布莱恩·科兰斯顿 Bryan Cranston,伊丽莎白·奥尔森 Elizabeth Olsen,渡边谦 Ken Watanabe",
"plot_simple": "改编自1954年日本电影《哥斯拉》，围绕一位人类大兵的生活展开。讲述了沉睡的古代巨型怪兽被人们意外唤醒，醒来后的怪兽展现出强大的破坏能力，它的存在也震惊了世界。影片同时强调了原子弹对生物变异带来的直接影响。",
"year": "2014",
"country": "美国|日本",
"type": "null",
"release_date": "20140101",
"also_known_as": ""
}
}
```
';