【Python】API連携の基本と実践!requestsライブラリで簡単実装

2025年3月12日更新(2025年3月12日公開)

Pythonは、Webサービスやアプリケーションと連携するためのAPI連携を容易に行うことができます。

今回の記事では、PythonでのAPI連携の基本から応用まで、具体的なコード例を交えてわかりやすく解説します。

API連携とは?

API(Application Programming Interface)とは、異なるソフトウェア同士が互いに情報をやり取りするための仕組みです。

API連携とは、Pythonプログラムから外部のWebサービスやアプリケーションが提供するAPIを利用します。

  • データを取得する
  • 操作する

ことを指します。

PythonでAPI連携するメリット

開発効率の向上

豊富なライブラリ

Pythonには、requestsurllibなど、API連携に特化した強力なライブラリが豊富に存在します。

これらのライブラリを使うことで、複雑な処理を記述することはありません。

簡単にAPIとの通信を行うことができます。

シンプルな構文

Pythonの構文はシンプルで読みやすく、API連携のコードも直感的に記述できます。

これにより、開発者はAPI連携の実装に集中できます。

開発効率が向上します。

柔軟性と拡張性

多様なAPIに対応

Pythonは、

  • REST API
  • SOAP API
  • GraphQL

など、様々な種類のAPIに対応できます。

これにより、様々なWebサービスやアプリケーションとの連携が容易になります。

データ処理の容易さ

Pythonは、JSONやXMLなどのデータ形式の処理に優れています。

APIから取得したデータを効率的に処理します。

必要な形式に変換することができます。

データ分析との親和性

データ分析ライブラリとの連携

Pythonは、pandasNumPyなどの強力なデータ分析ライブラリを持っています。

APIから取得したデータをこれらのライブラリと連携させることで、高度なデータ分析や可視化を行うことができます。

機械学習との連携

Pythonは機械学習分野でも広く利用されています。

APIから取得したデータを機械学習モデルの学習データとして活用することで、より高度なアプリケーションを開発できます。

クロスプラットフォーム対応

様々な環境で動作

Pythonは、

  • Windows
  • macOS
  • Linux

など、様々なプラットフォームで動作します。

そのため、開発環境や実行環境を選ばずにAPI連携を行うことができます。

活発なコミュニティ

豊富な情報とサポート

Pythonは世界中で広く利用されています。

活発なコミュニティが存在します。

そのため、API連携に関する情報やサポートを容易に得ることができます。

これらのメリットにより、PythonはAPI連携を行う上で非常に強力なツールとなります。

PythonでAPI連携する方法

PythonでAPI連携を行うには、主に以下のライブラリを使用します。

  • requests: 最も人気のあるHTTPライブラリで、Web APIとの連携に最適です。
  • urllib: Python標準のHTTPライブラリで、基本的なAPI連携に使用できます。

ここでは、requestsライブラリを使ったAPI連携の基本的な方法を解説します。

requestsライブラリのインストール

Bash

pip install requests

GETリクエストの送信

Python

import requests

url = "https://api.example.com/data"
response = requests.get(url)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print("APIエラー:", response.status_code)

POSTリクエストの送信

Python

import requests

url = "https://api.example.com/data"
data = {"key": "value"}
response = requests.post(url, json=data)

if response.status_code == 201:
    print("データ送信成功")
else:
    print("APIエラー:", response.status_code)

API連携の実践例

天気予報APIとの連携

天気予報APIを利用することで、現在の天気や気温などの情報を取得できます。

Python

import requests
import json

api_key = "YOUR_API_KEY"  # 天気予報APIのAPIキー
city = "Tokyo"  # 都市名

url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric"
response = requests.get(url)

if response.status_code == 200:
    data = json.loads(response.text)
    print(f"都市: {data['name']}")
    print(f"天気: {data['weather'][0]['description']}")
    print(f"気温: {data['main']['temp']}℃")
else:
    print("天気予報の取得に失敗しました。")

翻訳APIとの連携

翻訳APIを利用することで、テキストを別の言語に翻訳できます。

Python

import requests
import json

api_key = "YOUR_API_KEY"  # 翻訳APIのAPIキー
text = "Hello, world!"  # 翻訳したいテキスト
target_language = "ja"  # 翻訳先の言語

url = f"https://translation.googleapis.com/language/translate/v2?key={api_key}&q={text}&target={target_language}"
response = requests.post(url)

if response.status_code == 200:
    data = json.loads(response.text)
    print(f"翻訳結果: {data['data']['translations'][0]['translatedText']}")
else:
    print("翻訳に失敗しました。")

SNS APIとの連携

SNS APIを利用することで、投稿の取得や投稿など、様々な操作が可能です。

Python

import requests
import json

access_token = "YOUR_ACCESS_TOKEN"  # SNS APIのアクセストークン

url = "https://api.twitter.com/1.1/statuses/home_timeline.json"
headers = {"Authorization": f"Bearer {access_token}"}
response = requests.get(url, headers=headers)

if response.status_code == 200:
    tweets = json.loads(response.text)
    for tweet in tweets:
        print(f"ユーザー: {tweet['user']['name']}")
        print(f"投稿: {tweet['text']}")
        print("-" * 20)
else:
    print("タイムラインの取得に失敗しました。")

株価情報APIとの連携

株価情報APIを利用することで、最新の株価情報を取得できます。

Python

import requests
import json

symbol = "AAPL"  # 銘柄コード

url = f"https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol={symbol}&apikey=YOUR_API_KEY"
response = requests.get(url)

if response.status_code == 200:
    data = json.loads(response.text)
    print(f"銘柄: {data['Global Quote']['01. symbol']}")
    print(f"現在値: {data['Global Quote']['05. price']}")
else:
    print("株価情報の取得に失敗しました。")

これらの例はほんの一部ですが、PythonとAPI連携を活用することで、様々なWebサービスやアプリケーションと連携します。

より高度なアプリケーションを開発できます。

API連携の注意点

APIの利用規約

各APIの利用規約をよく読みましょう。

遵守しましょう。

APIキーの管理

APIキーは安全に管理しましょう。

外部に漏洩しないように注意しましょう。

エラーハンドリング

APIエラーが発生した場合に備えて、適切なエラーハンドリングを行いましょう。

レート制限

APIによっては、短時間に大量のアクセスを行うとレート制限がかかる場合があります。

Pythonを使えば、簡単にAPI連携を行うことができます。

この記事を参考に、様々なAPI連携に挑戦してみてください。

弊社でも、Pythonの外部API連携に対応しております。

お気軽にご相談ください。

読了ありがとうございました!
この記事に関することでお困りの方は
お気軽にご相談ください!
↓ ↓ ↓

この記事について問い合わせる

カテゴリー 一覧CATEGORY