2024.04.16

Python requestsを徹底解説！インストール・使い方など

Pythonは、オープンソースのプログラミング言語です。構文が比較的シンプルなため、初心者向けの言語としても知られています。

Pythonでプログラムを開発するにあたって、必ず活用するものがライブラリです。ライブラリは頻繁に使う関数やパッケージをまとめたもので、それぞれできることが異なります。requestsは、そんなPythonで利用されるパッケージのひとつです。

今回は、プログラミング経験が浅い方向けに、導入方法や利用方法などの基礎知識を解説します。興味を持った人は、ぜひ最後までご覧ください。

この記事でわかること

Python requestsに関する基礎知識
Python requestsの導入手順
Python requestsの使用方法

1 Python requestsとは
- 1.1 使用場面
- 1.2 urllib.requestとの違い
2 Python requestsのインストール方法
3 Python requestsの使い方
4 まとめ
5 投稿者

Python requestsとは

requestsは、HTTP通信用のライブラリとして知られています。HTTPとは、ウェブサーバーとウェブブラウザの間で、情報のやり取りをするためのプロトコルのことです。このHTTPによって、オンライン上で情報収集やブログを読む際、サーバーとクライアント間のやり取りが可能になります。

requestsを活用すれば、オンライン上にあるウェブサイトの情報取得や画像の収集などが簡単に実行できます。

使用場面

主にウェブスクレイピングで、HTMLやXMLファイルから情報を取得する際に使用されます。ウェブスクレイピングとは、特定の情報を自動的に抽出するコンピュータソフトウェア技術のことです。

オンライン上に散らばっている情報を収集するのは困難ですが、ウェブスクレイピングができれば、作業効率を大幅に向上させられます。オンライン上で閲覧可能なウェブサイトの多くは、HTMLやXMLが使用されているため、活用できる場面も少なくありません。

urllib.requestとの違い

requestと混同されがちな存在として、urllib.requestの名前が挙げられます。urllib.requestとは、URLを取得するためのPythonモジュールのことです。両者の相違点はさまざまですが、一例を挙げるとurllib.requestは標準ライブラリ、requestsは外部ライブラリという違いがあります。

urllib.requestは、Pythonを導入した時点で自動的に組み込まれる標準ライブラリのため、すぐに使用可能です。しかし、情報を取得するまでの一通りの動作を細かに記述しなければなりません。

一方のrequestsは外部ライブラリ、つまり外部の企業や一般のプログラマが開発したもののため、あらかじめ導入していなければ使用できませんが、より簡潔なコードでurllib.requestと同じ動作をさせられます。

Python requestsのインストール方法

requestsパッケージをダウンロードし、パソコンに導入するときは、pipと呼ばれるコマンドを使用してください。Windowsならコマンドプロンプトから、Macならターミナルから以下のようにコマンドを記述します。

pip install requests

あとはエンターキーを押して実行するだけで、ダウンロードが始まります。とくに問題がなければそのまま導入は完了しますが、エラーが発生し、途中で処理が止まってしまうケースも少なくありません。

そのようなときは、インターネット環境に問題がないか、古いバージョンのpipを使用していないか確認してください。pipをアップグレードする際は、以下のコマンドを用います。

pip install –upgrade pip

また、requestsが正常に導入されているか確認したいときは、以下のコマンドを入力すればパッケージの種類やバージョンを確認できます。

pip list

Python requestsの使い方

最後に、requestsをどのように実装するのか、サンプルコードと一緒に解説します。プログラミングを勉強中の方は、ぜひ参考にしてください。

GETリクエストの送信

GETリクエストは、ウェブサーバーから情報を取り出す際に用います。以下は、GETリクエストを実装する際の具体的な記述例です。

import requests

url = “http://example.com/api/items”
params = {“category”: “food”, “order”: “desc”}

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

print(response.status_code)
print(response.text)

GETリクエストの主な目的はデータの取得です。そのため、コードを記述するときはパラメータ指定に注意してください。

POSTリクエストの送信

POSTリクエストは、サーバー上にある情報の更新や、新規リソースを作成する際に使用します。POSTリクエストを送信する基本的なコードの書き方は、以下のとおりです。

import requests

url = “http://example.com/api/”
data = {“key1”: “value1”, “key2”: “value2”}

response = requests.post(url, data=data)

print(response.status_code)
print(response.text)

こちらの例では、第一引数にリクエスト送信先のURL、そしてdata引数にPOSTデータを辞書型で指定しています。

PUTリクエストの送信

PUTリクエストは、リソースの情報をすべて置き換えたいときに用いられます。実装する際は、リクエストのURLは更新対象のリソースを特定しなければなりません。

実際の記述方法は、以下のとおりです。

import requests

url = “http://example.com/api/items/1”
data = {“name”: “new item”, “price”: “100”}

response = requests.put(url, data=data)

print(response.status_code)
print(response.text)

POSTリクエストと混同する人も多いですが、POSTリクエストは新規作成や部分更新をするために実装するものなので、使用目的が異なります。それぞれの相違点を理解したうえで、使い分けられるようにしてください。

DELETEリクエストの送信

DELETEリクエストは、主にリソースの削除に用いられます。リクエストボディは必要ないケースが多く、URLだけを指定するのが一般的です。以下は、具体的な記述方法の例になります。

import requests

url = “http://example.com/api/items/1”

headers = {“Content-Type”: “application/json”}

response = requests.delete(url, headers=headers)

print(response.status_code)

if response.status_code == 204:
print(“Successfully deleted the resource.”)

最後の条件分岐でstatus_codeで削除の成功、または失敗を判定しています。

こちらの記事では、Pythonの「from import」の意味やimportとの違いについて解説します。ぜひあわせてご覧ください。