## 影讯API合集(不再维护) ![](https://img.kancloud.cn/c1/25/c1254945e040af6434ce331e852b6b62_228x213.png) > 影片信息、评分、影视票房榜,电影院上映信息等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": "" } } ```