【Python】Webをもっと手軽に！Requestsライブラリ入門：インストールから簡単な使い方まで 💻

インストールからレスポンス処理まで！Python Requests徹底ガイド

「PythonでWebサイトの情報を取得したいけど、なんだか難しそう…」
「APIってよく聞くけど、どうやって使うの？」

こんにちは！ Pythonを学び始めたばかりの方、あるいはWebとの連携に興味が出てきた方にとって、Requestsライブラリはまさに救世主のような存在です。このライブラリを使うと、驚くほど簡単にWebサイトの情報を取得したり、Web APIを操作したりできるようになります。

この記事では、そんな超人気ライブラリRequestsの基本的な使い方を、インストールから順を追って、サンプルコードを動かしながら分かりやすく解説していきます。

1. Requestsライブラリとは？

Requestsは、「人間のためのHTTP」を謳う、PythonでHTTP通信を行うためのシンプルかつエレガントなライブラリです。標準ライブラリのurllibよりも直感的で扱いやすく、多くのPythonプログラマーに愛用されています。

これを使えば、数行のコードでWebページの内容を取得したり、APIにデータを送信したりといったことが可能になります。

2. Requestsのインストール

まずは、RequestsライブラリをあなたのPython環境にインストールしましょう。
ターミナル（WindowsならコマンドプロンプトやPowerShell、macOSならターミナル.app）を開いて、以下のコマンドを実行してください。

pip install requests

これでインストールは完了です！ 簡単ですね。

💡ちょっと待った！仮想環境は使ってる？
もしあなたがプロジェクトごとにPythonの環境を分けて管理できる「仮想環境（venvなど）」を使っているなら、その仮想環境を有効化してからpip install requestsを実行してくださいね。そうすることで、プロジェクトごとにライブラリをスッキリ管理できます。

venv仮想環境の構築はこちらで紹介しています。

3. Webページを取得してみよう (GETリクエスト)

一番基本的な使い方として、Webページの情報を取得してみましょう。
ここでは、例として架空のAPIテストサイトである https://jsonplaceholder.typicode.com/todos/1 から情報を取得してみます。

サンプルコード:

import requests

# 情報を取得したいURL
url = "https://jsonplaceholder.typicode.com/todos/1"

# GETリクエストを送信
response = requests.get(url)

# レスポンスの内容を表示
print(response.text)

解説:

  1. import requests でRequestsライブラリを読み込みます。
  2. url変数に、情報を取得したいWebページのURLを指定します。
  3. requests.get(url) で、指定したURLに対してGETリクエストを送信します。サーバーからの応答（レスポンス）がresponseオブジェクトに格納されます。
  4. response.text で、レスポンスの本文をテキスト形式で取得し、表示しています。

実行結果 (例):

{
  "userId": 1,
  "id": 1,
  "title": "delectus aut autem",
  "completed": false
}

このように、指定したURLのコンテンツ（この場合はJSON形式のデータ）が取得できました！

4. レスポンスの中身を詳しく見てみよう

responseオブジェクトには、取得した本文以外にも様々な情報が含まれています。

4.1. ステータスコードの確認

HTTPステータスコードは、リクエストが成功したか、失敗したかなどの状態を示す3桁の数字です。
response.status_code で確認できます。

サンプルコード:

import requests

url = "https://jsonplaceholder.typicode.com/todos/1"
response = requests.get(url)

print(f"ステータスコード: {response.status_code}")

# 存在しない可能性のあるURL
url_not_found = "https://jsonplaceholder.typicode.com/todos/999999"
response_not_found = requests.get(url_not_found)
print(f"存在しないURLのステータスコード: {response_not_found.status_code}")

実行結果 (例):

ステータスコード: 200
存在しないURLのステータスコード: 404
  • 200: リクエスト成功 (OK)
  • 404: リソースが見つからない (Not Found)

ステータスコードを見ることで、リクエストが正しく処理されたかを知ることができます。

4.2. レスポンスヘッダーの確認

レスポンスヘッダーには、コンテンツの種類 (Content-Type) やサーバーの情報など、本文以外のメタデータが含まれています。
response.headers で辞書形式で取得できます。

サンプルコード:

import requests

url = "https://jsonplaceholder.typicode.com/todos/1"
response = requests.get(url)

print("レスポンスヘッダー:")
for key, value in response.headers.items():
    print(f"  {key}: {value}")

実行結果 (一部抜粋例):

レスポンスヘッダー:
  Date: Thu, 22 May 2025 05:30:00 GMT
  Content-Type: application/json; charset=utf-8
  Content-Length: 83
  Connection: keep-alive
  ... (その他多くのヘッダー情報)

Content-Typeを見ると、このレスポンスがJSON形式 (application/json) であることが分かりますね。

4.3. JSON形式のレスポンスを扱う

先ほどの例のように、APIからのレスポンスはJSON形式であることが多いです。
Requestsライブラリには、JSONレスポンスを簡単にPythonの辞書やリストに変換してくれるresponse.json()メソッドがあります。

サンプルコード:

import requests

url = "https://jsonplaceholder.typicode.com/todos/1"
response = requests.get(url)

if response.status_code == 200:
    # JSONレスポンスをPythonの辞書に変換
    data = response.json()
    print("取得したデータ (辞書型):", data)
    print(f"タイトル: {data['title']}")
    print(f"ユーザーID: {data['userId']}")
else:
    print(f"エラーが発生しました: {response.status_code}")

実行結果 (例):

取得したデータ (辞書型): {'userId': 1, 'id': 1, 'title': 'delectus aut autem', 'completed': false}
タイトル: delectus aut autem
ユーザーID: 1

response.text で取得した文字列を自分でパースする手間が省け、Pythonの辞書として直接データにアクセスできるので非常に便利です。

5. URLにパラメータを付けてリクエストする (クエリパラメータ)

WebサイトやAPIによっては、URLの末尾に ?キー1=値1&キー2=値2 のような形でパラメータを付けて情報を絞り込んだり、特定の動作を指示したりすることがあります。これをクエリパラメータと呼びます。

Requestsでは、params引数に辞書を渡すことで、簡単にクエリパラメータをURLに追加できます。

サンプルコード:
ここでは、https://httpbin.org/get という、送信した情報をそのまま返してくれるテスト用APIを使います。

import requests

url = "https://httpbin.org/get"

# 送信するパラメータ
my_params = {
    "name": "Taro Yamada",
    "age": 30
}

response = requests.get(url, params=my_params)

# 実際にリクエストされたURLも確認できる
print(f"リクエストURL: {response.url}")

# レスポンス内容 (JSON)
data = response.json()
print("サーバーが受け取ったパラメータ:")
print(data["args"])

実行結果 (例):

リクエストURL: https://httpbin.org/get?name=Taro+Yamada&age=30
サーバーが受け取ったパラメータ:
{'age': '30', 'name': 'Taro Yamada'}

response.url を見ると、辞書で渡したパラメータが適切にURLエンコードされて追加されているのが分かります。
data["args"] に、サーバーが受け取ったパラメータが格納されていますね。

まとめ：Requestsで広がるPythonの世界！

今回は、PythonのRequestsライブラリの基本的な使い方として、

  • インストール方法
  • GETリクエストによる情報取得 (requests.get())
  • レスポンスの確認 (ステータスコード、ヘッダー、本文テキスト)
  • JSONレスポンスの扱い (response.json())
  • クエリパラメータの送信

などを解説しました。

Requestsライブラリは非常に多機能で、今日ご紹介した以外にもPOSTリクエスト（データの送信）、認証、セッション管理など、さまざまなことができます。
この記事をきっかけに、ぜひRequestsライブラリを使って、Web上の情報取得やAPI連携にチャレンジしてみてください。あなたのPythonライフがもっと楽しく、もっと便利になるはずです！

その他の投稿はこちら

コメント

コメントを投稿

このブログの人気の投稿

タイトルまとめ

環境構築 これで迷わない！WindowsでPython環境構築する一番やさしい方法 #0 【Python初心者向け】venvでスッキリ環境構築！プロジェクトごとの独立性を保つ秘訣 #1 超入門〜入門 【Python超入門】プログラミングで計算してみよう！四則演算と便利な算術演算子を徹底解説 #2 【Python超入門】プログラミングの第一歩！「変数」とは？使い方と命名ルールを優しく解説 #3 【Python入門】プログラムの流れを自由自在に！if文を使った条件分岐を徹底マスター #4 【Python入門】繰り返し処理をマスター！for文・while文の基本と使い分けを徹底解説 #5 【Python入門】コードを整理整頓！関数の作り方と使い方をマスターしよう (def, 引数, 戻り値) #6 【Python入門】オブジェクト指向の扉を開こう！クラスの基本と作り方・使い方 (class, __init__, メソッド) #7 【Python入門】クラッシュしないプログラムへ！エラーハンドリング(try-except-else-finally-raise)完全ガイド #8 中級へ向けて > OOP(オブジェクト指向プログラミング) 【Python中級への道】OOPの真髄！クラスの「継承」でコードを再利用・拡張しよう (親クラス・子クラス・super) #8 【Python中級編】OOPの魔法！ポリモーフィズム（多態性）で柔軟なコードを書こう #9 【Python中級編】OOPの守護神！カプセル化で安全なクラスを作ろう (データ隠蔽・プロパティ) #10 標準ライブラリ紹介 【Python標準ライブラリ入門 第1回】日付と時刻を自由自在に！datetimeモジュール徹底活用術 【Python標準ライブラリ入門 第2回】偶然をプログラムに！randomモジュールで乱数を使いこなそう 【Python標準ライブラリ入門 第3回】データ交換の標準！jsonモジュールでJSONを自由自在に扱おう 【Python標準ライブラリ入門 第4回】ファイル・ディレクトリ操作の達人になろう！osモジュール徹底ガイド 【Python標準ライブラリ入門 第5回】表データ処理の相棒！csvモジュールでCSVファイルを自在に操ろう 📊 【Python標準ライブラリ入門 第6回】ファイル操作を極...
続きを読む

【Pythonで学ぶ地理計算】mathライブラリで2点間の方位角を計算する基礎 🌍

「東京駅から見て、大阪城はどの方角にあるんだろう？」 「2つの緯度経度の情報から、片方がもう片方から見てどの方角にあるか、角度で知りたい！」 「地図アプリみたいな計算って、Pythonでどうやってやるの？」 こんにちは！ Pythonプログラミング探検隊、隊長のPythonistaです！ 今回から始まる新シリーズでは、プログラミングと地理情報を組み合わせた、少し専門的で非常に面白い「地理空間計算」の世界に足を踏み入れます。 その第一歩として、今回は 「2つの地点の緯度経度から、始点から見た終点の方位角（ほういかく）を計算する方法」 を探求します。方位角とは、 真北を0度として、時計回りに測った角度 のことです。例えば、真東は90度、真南は180度、真西は270度となります。 この計算を、まずは外部ライブラリを使わずに、Pythonに標準で付属している math モジュール だけを使って実装してみます。三角関数など少し数学的な要素も出てきますが、その原理を理解することで、より深く地理計算の世界を楽しめるようになりますよ。さあ、Pythonで地球を舞台にした計算を始めましょう！ 1. 計算の考え方：地球を「完全な球」として捉える 今回私たちが行う計算は、地球を「完全な球体」と仮定した 球面三角法（きゅうめんさんかくほう） という考え方に基づいています。※詳しくは wikipediaの説明 をご覧ください。 実際の地球は、赤道方向に少し膨らんだ「回転楕円体」に近い形をしていますが、多くのアプリケーションや、特に2点間の距離がそれほど長くない場合には、この「完全な球」というモデルでも非常に精度の良い近似計算が可能です。何より、このモデルは計算の基本的な原理を理解するのに最適です。 2. 方位角計算の「材料」たち 方位角を計算する数式は少し複雑に見えるかもしれませんが、必要な「材料」となるPythonの機能は非常にシンプルです。 2.1. 緯度経度とラジアン (Radian) 私たちが普段使う角度の単位は「度（°）」ですが、Pythonの math モジュールに含まれる三角関数（ sin , cos など）は、角度の単位として 「ラジアン (radian)」 を使います。そのため、計算を始める前に、まず緯度と経度を度からラジアンに変換する必...
続きを読む

これで迷わない！WindowsでPython環境構築する一番やさしい方法 #0

イメージ
はじめに：Python学習、最初の一歩を応援します！ 「Pythonを勉強してみたいけど、何から始めたらいいの？」 「プログラミングって難しそう…環境構築でつまずきたくないな…」 こんにちは！ この記事は、そんなプログラミング初心者さん、特にWindowsユーザーのあなたが、スムーズにPython学習をスタートできるよう、 Pythonの環境構築手順 をどこよりも分かりやすく解説することを目指しています。 私自身もそうでしたが、プログラミング学習の最初のハードルが、この「環境構築」だったりします。でも大丈夫！この記事の手順通りに進めれば、きっとあなたのパソコンでPythonが動くようになります。 一緒にPythonの世界への第一歩を踏み出しましょう！ そもそもPythonって何？ (軽くでOK) Pythonは、読みやすく、書きやすい、そしてとっても人気のあるプログラミング言語です。Webサイト制作、データ分析、AI開発など、本当に色々なことができます。初心者にも比較的学びやすい言語と言われているんですよ。 さっそくPythonをインストールしよう！ (Windows編) それでは、WindowsのパソコンにPythonをインストールしていきましょう。 1. Python公式サイトへアクセス！ まずは、Pythonの「公式」ダウンロードページにアクセスします。 検索エンジンで「Python ダウンロード」と検索するか、こちらのアドレスに直接アクセスしてください。 https://www.python.org/downloads/ 2. 最新版のPythonをダウンロード ダウンロードページを開くと、「Download Python X.X.X」（X.X.Xはバージョン番号）という大きなボタンがあるはずです。基本的には、この最新版をダウンロードすればOKです。 ポイント： もし学習する教材などでPythonのバージョンが指定されている場合は、少し下にスクロールすると過去のバージョンもダウンロードできます。でも、特に理由がなければ最新版を選びましょう。 3. ダウンロードしたインストーラーを実行！ ダウンロードが完了したら、ダウンロードフォルダにある .exe ファイル（例： python-3.12.3-amd64.exe のような名前です）をダブルクリックし...
続きを読む