## 影訊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": "" } } ```