🧛

[Postman]TMDB APIから映画情報を取得する

2023/04/23に公開約11,800字

TMDB APIとは

TMDB(TheMovieDataBase)とはユーザーコミュニティにより構築された、映画やテレビ番組、俳優、テレビ局、番組制作会社などのオンラインデータベースです。
2021年の時点で60万以上の映画、10万以上のテレビ番組、そして200万を超える俳優などの人物の情報が登録されているとのこと。

【気分によって映画を紹介するサイト】を個人開発しているのですが、映画情報を取得する選択肢としてPythonのBeautifulSoupというライブラリを使用し、filmarksから情報をスクレイピングしようと考えていたのですが、今後仮に商用利用したり、規模を大きくする上で規約的にもまずいと思いました。

そこでTMDB APIからaxiosを使って映画情報を呼び出そうという手法に至ったわけですが、あまり日本語の資料がなかったのでこちらに簡単にまとめていきます。

Postman

自作したAPIをプロジェクトに組み込むとき、Postmanを使用するとやりやすいです。
PostmanはHTTPリクエストを送ると、json形式で結果を返してくれます。
Postmanの細かい使い方や挙動は今回割愛させていただきます。

https://api.themoviedb.org/3/discover/movie?api_key={YOUR_API_KEY}&sort_by=popularity.desc&region=JP&language=ja-JP&with_original_language=ja

リクエストをGETにし、{YOUR_API_KEY}の部分にAPIkeyを入れます。
このURLは、人気の映画を人気順にソートし(sort_by=popularity.desc)、リージョンを日本に(region=JP)、言語を日本語に(language=ja-JP)設定しています。また、オリジナル言語が日本語の映画(with_original_language=ja)に絞り込んでいます。
{YOUR_API_KEY}以下は結構色々な条件を指定して絞り込むことが出来て便利ですね。

返ってきた結果がこちら↓(ちょっと長いです。)
**
{
"page": 1,
"results": [
{
"adult": false,
"backdrop_path": "/ceYZCBfwbBwSpGJ6PapNVw5jqLG.jpg",
"genre_ids": [
16,
18,
12,
14
],
"id": 916224,
"original_language": "ja",
"original_title": "すずめの戸締まり",
"overview": "九州の静かな町で暮らす17歳の少女・鈴芽(すずめ)は、「扉を探してるんだ」という旅の青年・草太に出会う。彼の後を追って迷い込んだ山中の廃墟で見つけたのは、ぽつんとたたずむ古ぼけた扉。なにかに引き寄せられるように、すずめは扉に手を伸ばすが…。 扉の向こう側からは災いが訪れてしまうため、草太は扉を閉めて鍵をかける“閉じ師”として旅を続けているという。",
"popularity": 373.299,
"poster_path": "/rx5bIkrYqmweOTBT183xs1yllcx.jpg",
"release_date": "2022-11-11",
"title": "すずめの戸締まり",
"video": false,
"vote_average": 8,
"vote_count": 154
},
{
"adult": false,
"backdrop_path": "/xPpXYnCWfjkt3zzE0dpCNME1pXF.jpg",
"genre_ids": [
16,
28,
12,
14,
53
],
"id": 635302,
"original_language": "ja",
"original_title": "劇場版「鬼滅の刃」無限列車編",
"overview": "蝶屋敷での修業を終えた炭治郎たちは、次なる任務の地、《無限列車》に到着する。 そこでは、短期間のうちに四十人以上もの人が行方不明になっているという。 禰豆子を連れた炭治郎と善逸、伊之助の一行は、 鬼殺隊最強の剣士である《柱》のひとり、炎柱の煉獄杏寿郎と合流し、 闇を往く《無限列車》の中で、鬼と立ち向かうのだった。",
"popularity": 358.569,
"poster_path": "/m9cn5mhW519QKr1YGpGxNWi98VJ.jpg",
"release_date": "2020-10-16",
"title": "劇場版「鬼滅の刃」無限列車編",
"video": false,
"vote_average": 8.2,
"vote_count": 3053
},
{
"adult": false,
"backdrop_path": "/8NEvnVKeGMLEXG45MMNqxJLcM4y.jpg",
"genre_ids": [
28,
16,
14
],
"id": 820232,
"original_language": "ja",
"original_title": "鬼滅の刃 兄妹の絆",
"overview": "",
"popularity": 347.214,
"poster_path": "/99cJLZkNoIFmufJ4yap6ZABl4nk.jpg",
"release_date": "2019-03-29",
"title": "鬼滅の刃 兄妹の絆",
"video": false,
"vote_average": 8,
"vote_count": 81
},
{
"adult": false,
"backdrop_path": "/7PzpnGL4W0oy1NAd0toIZeuDt0G.jpg",
"genre_ids": [
16,
35,
14
],
"id": 28152,
"original_language": "ja",
"original_title": "スーパーマリオブラザーズ ピーチ姫救出大作戦!",
"overview": "",
"popularity": 339.216,
"poster_path": "/wqmGhXHih5MaahYO0JqKW2fvHNy.jpg",
"release_date": "1986-07-20",
"title": "スーパーマリオブラザーズ ピーチ姫救出大作戦!",
"video": false,
"vote_average": 6,
"vote_count": 18
},
{
"adult": false,
"backdrop_path": "/sVa8AA4EpUsSV1Jjj52S8fF77pF.jpg",
"genre_ids": [
16,
28,
12,
35
],
"id": 1027159,
"original_language": "ja",
"original_title": "ルパン三世VSキャッツ・アイ",
"overview": "1981年、東京。昼は喫茶店を営み、夜は怪盗キャッツアイとして世間を騒がす美人三姉妹、瞳・泪・愛は、美術展から一枚の絵画を盗み出す。同じ頃東京に現れた、神出鬼没の大泥棒・ルパン三世。彼もまたとある武装組織を出し抜き、絵画を盗むことに成功した。両者が盗んだ絵はどちらも、画家ミケール・ハインツの描いた作品――三連作「花束と少女」の一枚。キャッツ三姉妹にとっては、父であるハインツの消息を掴むための重要な手がかり。伝説的な泥棒の“獲物”が自分たちと同じであると知った彼女たちは、その眼差しに美しい闘志を宿す――",
"popularity": 242.028,
"poster_path": "/b85EjAMa40gkSs9wOR9P6nuRZhi.jpg",
"release_date": "2023-01-27",
"title": "ルパン三世VSキャッツ・アイ",
"video": false,
"vote_average": 6,
"vote_count": 63
},
{
"adult": false,
"backdrop_path": "/uR0FopHrAjDlG5q6PZB07a1JOva.jpg",
"genre_ids": [
16,
878,
28
],
"id": 610150,
"original_language": "ja",
"original_title": "ドラゴンボール超 スーパーヒーロー",
"overview": "鳥山明による大ヒット漫画「ドラゴンボール」を原作とする劇場版アニメ。2015~18年に放送されたテレビシリーズ「ドラゴンボール超(スーパー)」の映画化第2弾で、2018年公開の前作「ドラゴンボール超 ブロリー」同様に、今作でも原作者の鳥山が脚本やキャラクターデザインを担当した。かつて孫悟空によって壊滅させられた悪の組織「レッドリボン軍」の意志を継ぐ者たちが現れ、新たに最強の人造人間ガンマ1号、2号を生み出す。彼らは自らを「スーパーヒーロー」と名乗り、ピッコロや悟飯たちを襲い始める。ガンマ1号と2号の声を、神谷浩史と宮野真守という人気声優がそれぞれ担当。そのほかにも新生レッドリボン軍の天才科学者Dr.ヘド役を演じる入野自由や、ボルケーノ太田、竹内良太らが出演。監督は前作「ドラゴンボール超 ブロリー」でも3Dパートの制作などに参加した児玉徹郎。",
"popularity": 226.665,
"poster_path": "/uohymzBVaIYjbnoQstbnlia6ZPJ.jpg",
"release_date": "2022-06-11",
"title": "ドラゴンボール超 スーパーヒーロー",
"video": false,
"vote_average": 7.9,
"vote_count": 2361
},
{
"adult": false,
"backdrop_path": "/deVDWpainW9FoZ4hhjaUE2xaQR1.jpg",
"genre_ids": [
16,
12,
14
],
"id": 846993,
"original_language": "ja",
"original_title": "グッバイ、ドン・グリーズ!",
"overview": "東京から少し離れた田舎町に暮らす少年・ロウマ。 周囲と上手く馴染むことができないロウマは、 同じように浮いた存在であったトトと二人だけのチーム"ドン・グリーズ"を結成する。 その関係はトトが東京の高校に進学して、離れ離れになっても変わらないはずだった。 「ねえ、世界を見下ろしてみたいと思わない?」 高校1年生の夏休み。それは新たに"ドン・グリーズ"に加わったドロップの何気ない一言から始まった。 ドロップの言葉にのせられた結果、山火事の犯人に仕立て上げられてしまったロウマたちは、 無実の証拠を求めて、空の彼方へと消えていったドローンを探しに行く羽目に。 ひと夏の小さな冒険は、やがて少年たちの“LIFE”(生き方)を一変させる大冒険へと発展していく。",
"popularity": 189.899,
"poster_path": "/p1myUka0HPSIog6ofMo9YTmrurh.jpg",
"release_date": "2022-02-18",
"title": "グッバイ、ドン・グリーズ!",
"video": false,
"vote_average": 6.6,
"vote_count": 15
},
{
"adult": false,
"backdrop_path": "/921vUyXdfIYpaXqu5Lnf3nVb4IJ.jpg",
"genre_ids": [
16,
28,
14
],
"id": 810693,
"original_language": "ja",
"original_title": "劇場版 呪術廻戦 0",
"overview": "幼少のころ、幼なじみの祈本里香を交通事故により目の前で失った乙骨憂太。「約束だよ 里香と憂太は大人になったら結婚するの」怨霊と化した里香の呪いに苦しみ、自身の死を望む乙骨だったが、最強の呪術師・五条悟によって、呪術高専に迎え入れられた。そして、同級生の禪院真希・狗巻 棘・パンダと出会い、乙骨はある決意をする。「生きてていいって自信が欲しいんだ」「僕は呪術高専で里香ちゃんの呪いを解きます」一方、乙骨たちの前にかつて一般人を大量虐殺し高専を追放された最悪の呪詛師・夏油 傑が現れる。「来たる12月24日 我々は百鬼夜行を行う」呪術師だけの楽園を標榜する夏油は、非術師を殲滅させんと、ついに新宿・京都に千の呪いを放ち――果たして、乙骨は夏油を止められるのか、そして、里香の解呪の行方は‥‥。",
"popularity": 174.777,
"poster_path": "/m8nyqnn2K7WzxcAKzCxPxuX7Yd1.jpg",
"release_date": "2021-12-24",
"title": "劇場版 呪術廻戦 0",
"video": false,
"vote_average": 8.2,
"vote_count": 897
},
{
"adult": false,
"backdrop_path": "/aLLTfRD7EfbE9GVyosknReARNHI.jpg",
"genre_ids": [
16,
18,
12,
878
],
"id": 843269,
"original_language": "ja",
"original_title": "EUREKA/交響詩篇エウレカセブン ハイエボリューション",
"overview": "エウレカが作り上げたスカブコーラル(珊瑚状の情報生命体)の中の仮想世界。 その崩壊とともに、仮想世界の人々がこの地球に姿を現して10年が経過した。この“大融合”の結果、仮想世界の人類は「グリーンアース」を、旧来の地球人類は「ブルーアース」を名乗り、水面下でさまざまな衝突を繰り返すことになった。そしてグリーンアース軍の高官デューイ・ノヴァクは、自分たちの尊厳を守るため、仲間とともに決起し、大規模なテロ計画をついに実行へと移す。 混乱の元凶として世界中から憎まれるエウレカは、国連の独立師団無任所部隊A.C.I.D.(アシッド)の上級戦闘員となっていた。この世界を平和に保つために生きる。それがエウレカの選んだ贖罪の道だった。そんなエウレカに、スカブコーラルを操る能力を持つ新たな“EUREKA”、少女アイリスを保護する命令が下る。最初は対立するばかりだった2人は、孤独な逃避行を通じて、次第に互いのことを理解していく。そして世界が危機に直面した時、エウレカは極限まで自らの力を振り絞って戦う。「アイリスとこの世界を守りたい」。エウレカの願いの果てに待つ未来とは――",
"popularity": 170.636,
"poster_path": "/orLSgCXqgD461f8u2hrFwoXZGl4.jpg",
"release_date": "2021-11-26",
"title": "EUREKA/交響詩篇エウレカセブン ハイエボリューション",
"video": false,
"vote_average": 6.5,
"vote_count": 10
},
{
"adult": false,
"backdrop_path": "/mUC2BS04DlszdqJQ9vz9MFuPiDd.jpg",
"genre_ids": [
16,
28,
14
],
"id": 20982,
"original_language": "ja",
"original_title": "劇場版 NARUTO -ナルト- 疾風伝",
"overview": "かつて世界を破滅寸前まで追い込めた魔物・魍魎は、かつてその力を借りて大陸を蹂躙した黄泉によって封印から解放され、暗黒忍術によって黄泉の体内に魂を移植された。復活した魍魎率いる幽霊軍団の襲撃を前に、ナルト・サクラ・ネジ・リーの4人は、火影である綱手の命を受けて、この世で唯一魍魎を封印する力を持つことから魍魎に命を狙われる鬼の国の巫女・紫苑の護衛に当たる。",
"popularity": 135.02,
"poster_path": "/gHRnY4zRZkH9vo1TF6VoZaOlw0r.jpg",
"release_date": "2007-08-04",
"title": "劇場版 NARUTO -ナルト- 疾風伝",
"video": false,
"vote_average": 7.2,
"vote_count": 654
},
{
"adult": false,
"backdrop_path": "/bNYDRRgmKogbPjhsR0PTPkqITnh.jpg",
"genre_ids": [
14,
16,
12
],
"id": 4935,
"original_language": "ja",
"original_title": "ハウルの動く城",
"overview": "父親の帽子店で帽子を作って暮らしていた18歳のソフィーは、荒野の魔女の呪いで90歳の老婆の姿になってしまう。彼女はハンサムだが気弱な魔法使いハウルと出会って、彼の居城でいっしょに暮らすようになるが、その城は4本足で歩く動く城だった。",
"popularity": 134.149,
"poster_path": "/xNIz1UpNUywSjecaPsJHJG6Ilb3.jpg",
"release_date": "2004-11-19",
"title": "ハウルの動く城",
"video": false,
"vote_average": 8.4,
"vote_count": 8201
},
{
"adult": false,
"backdrop_path": "/dIWwZW7dJJtqC6CgWzYkNVKIUm8.jpg",
"genre_ids": [
10749,
16,
18
],
"id": 372058,
"original_language": "ja",
"original_title": "君の名は。",
"overview": "1,000年に1度のすい星来訪が、1か月後に迫る日本。山々に囲まれた田舎町に住む女子高生の三葉は、町長である父の選挙運動や、家系の神社の風習などに鬱屈(うっくつ)していた。それゆえに都会への憧れを強く持っていたが、ある日彼女は自分が都会に暮らしている少年になった夢を見る。夢では東京での生活を楽しみながらも、その不思議な感覚に困惑する三葉。一方、東京在住の男子高校生・瀧も自分が田舎町に生活する少女になった夢を見る。やがて、その奇妙な夢を通じて彼らは引き合うようになっていくが……。",
"popularity": 131.935,
"poster_path": "/gCYGhDtlsHr5hPjpe2Yh0MSrntG.jpg",
"release_date": "2016-08-26",
"title": "君の名は。",
"video": false,
"vote_average": 8.5,
"vote_count": 9714
},
{
"adult": false,
"backdrop_path": "/eN1TMy5hT72G2v92x5cNM5trdFv.jpg",
"genre_ids": [
16,
878,
28
],
},
"total_pages": 1421,
"total_results": 28419
}
**

まぁまぁ、有名どころが返ってきましたね。
ここからjavascriptなりpythonなりで、映画のタイトル、ディスクリプション、画像パスだけを出力したりしてカスタマイズしていけそうです。

Discussion

ログインするとコメントできます