Python×Web API×JSON入門｜requestsでの取得・解析・保存まで

{
  "name": "Alice",
  "age": 25,
  "tags": ["python", "api"]
}

data = {
    "name": "Alice",     # str
    "age": 25,           # int
    "tags": ["python", "api"]  # list of str
}

pip install requests

import requests  # requestsライブラリをインポート

# アクセスしたいURLを指定
url = "https://api.example.com/data"

# GETリクエストを送信し、レスポンスオブジェクトを取得
response = requests.get(url)

# レスポンスのステータスコード(200なら成功)を確認
print("ステータスコード:", response.status_code)

# レスポンスボディ(中身のテキスト)を表示
print("レスポンス本文:")
print(response.text)

import requests

url = "https://api.example.com/search"

# クエリパラメータをdictで指定
params = {
    "q": "python",  # 検索キーワード
    "limit": 10     # 取得件数
}

# params引数で渡すと、自動的にURLに付与される
response = requests.get(url, params=params)

print("最終的にアクセスしたURL:", response.url)

import requests

url = "https://api.example.com/data"

# APIキーやユーザーエージェントなどをヘッダーに設定
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN_HERE",
    "User-Agent": "MyPythonApp/1.0"
}

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

import requests

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

if response.status_code == 200:
    print("成功しました")
else:
    print("失敗しました。ステータスコード:", response.status_code)
    print("レスポンス本文:", response.text)

import requests

url = "https://api.example.com/data"

try:
    response = requests.get(url, timeout=10)  # タイムアウトも設定
    # エラーコード(4xx/5xx)ならHTTPError例外を発生させる
    response.raise_for_status()
    print("通信成功")
except requests.exceptions.HTTPError as e:
    print("HTTPエラーが発生しました:", e)
except requests.exceptions.Timeout:
    print("タイムアウトしました")
except requests.exceptions.RequestException as e:
    # その他の通信エラーの総称
    print("リクエストエラーが発生しました:", e)

import requests

def fetch_todo(todo_id: int) -> None:
    """
    指定したIDのToDoデータをJSONPlaceholderから取得して表示する関数です。
    """
    url = f"https://jsonplaceholder.typicode.com/todos/{todo_id}"

    try:
        # GETリクエストを送信
        response = requests.get(url, timeout=5)

        # エラーコードなら例外を発生させる
        response.raise_for_status()

        # レスポンスをJSONとしてパース
        todo = response.json()  # dictとして取得される

        # 結果を整形して表示
        print("取得したToDoデータ:")
        print("ID        :", todo.get("id"))
        print("ユーザーID:", todo.get("userId"))
        print("タイトル  :", todo.get("title"))
        print("完了済み  :", todo.get("completed"))

    except requests.exceptions.RequestException as e:
        # 通信に関するあらゆる例外を一括で捕捉
        print("APIへのアクセス中にエラーが発生しました:", e)

if __name__ == "__main__":
    # ID=1のToDoデータを取得
    fetch_todo(1)

import json

# JSON形式の文字列
json_str = '{"name": "Alice", "age": 25, "is_active": true}'

# json.loadsでPythonオブジェクト(dict)に変換
data = json.loads(json_str)

print(type(data))  # <class 'dict'>
print(data["name"], data["age"], data["is_active"])

import json

# Pythonのdict
data = {
    "name": "Bob",
    "age": 30,
    "is_active": False,
    "tags": ["python", "api"]
}

# json.dumpsでJSON文字列に変換
json_str = json.dumps(data, ensure_ascii=False, indent=2)

print(json_str)

{
  "id": 1,
  "title": "sample",
  "completed": false
}

todo = {
    "id": 1,
    "title": "sample",
    "completed": False
}

print(todo["title"])      # キーでアクセス
print(todo.get("title"))  # getでアクセス(存在しない場合None)

[
  {"id": 1, "title": "sample1"},
  {"id": 2, "title": "sample2"}
]

todos = [
    {"id": 1, "title": "sample1"},
    {"id": 2, "title": "sample2"}
]

# 先頭要素のtitle
print(todos[0]["title"])

# すべてのtitleをfor文で表示
for todo in todos:
    print(todo["id"], todo["title"])

{
  "user": {
    "id": 123,
    "name": "Alice",
    "profile": {
      "email": "alice@example.com",
      "address": {
        "city": "Tokyo",
        "zip": "100-0001"
      }
    }
  }
}

data = {
    "user": {
        "id": 123,
        "name": "Alice",
        "profile": {
            "email": "alice@example.com",
            "address": {
                "city": "Tokyo",
                "zip": "100-0001"
            }
        }
    }
}

# 直接インデックスで辿る場合
city = data["user"]["profile"]["address"]["city"]
print("city:", city)

# getを使って安全に辿る例(途中が存在しない場合Noneを返す)
user = data.get("user", {})
profile = user.get("profile", {})
address = profile.get("address", {})
city_safe = address.get("city")

print("安全に取得したcity:", city_safe)

import json

def parse_json_safely(json_str: str) -> dict:
    """
    JSON文字列をdictに変換します。
    パースに失敗した場合は空のdictを返します。
    """
    try:
        data = json.loads(json_str)
        return data
    except json.JSONDecodeError as e:
        print("JSONのパースに失敗しました:", e)
        return {}

# 正しいJSON
valid_json = '{"name": "Alice"}'
print(parse_json_safely(valid_json))

# 間違ったJSON(末尾のカンマが余分)
invalid_json = '{"name": "Alice",}'
print(parse_json_safely(invalid_json))

def get_user_name(user_data: dict) -> str:
    """
    user_dataからnameキーを取り出します。
    存在しない場合は'不明'を返します。
    """
    try:
        return user_data["name"]
    except KeyError:
        print("nameキーが存在しませんでした")
        return "不明"

user1 = {"name": "Alice", "age": 25}
user2 = {"age": 30}

print(get_user_name(user1))  # 'Alice'
print(get_user_name(user2))  # '不明'

import json
import requests

def fetch_and_save_json(url: str, filepath: str) -> None:
    """
    指定されたURLからJSONデータを取得し、ファイルに保存する関数です。
    """
    response = requests.get(url, timeout=10)
    response.raise_for_status()

    # レスポンスボディをJSONとして取得(dictまたはlist)
    data = response.json()

    # ファイルに保存(UTF-8、整形付き)
    with open(filepath, "w", encoding="utf-8") as f:
        json.dump(data, f, ensure_ascii=False, indent=2)

    print(f"JSONデータを{filepath}に保存しました")

if __name__ == "__main__":
    url = "https://jsonplaceholder.typicode.com/todos"
    fetch_and_save_json(url, "todos.json")

import json

def load_json(filepath: str):
    """
    JSONファイルを読み込んでPythonオブジェクトとして返す関数です。
    """
    with open(filepath, "r", encoding="utf-8") as f:
        data = json.load(f)
    return data

if __name__ == "__main__":
    todos = load_json("todos.json")
    print("読み込んだ件数:", len(todos))
    print("先頭要素:", todos[0])

import json
import csv

def json_to_csv(json_filepath: str, csv_filepath: str) -> None:
    """
    JSONファイル(配列形式)を読み込み、CSVに変換して保存する関数です。
    """
    # JSONファイルを読み込む
    with open(json_filepath, "r", encoding="utf-8") as f:
        data = json.load(f)

    # dataはlist[dict]であることを想定
    if not data:
        print("データが空のため、CSVを作成しませんでした")
        return

    # 1件目のキー一覧をCSVのヘッダーとする
    fieldnames = list(data[0].keys())

    # CSVファイルに書き出す
    with open(csv_filepath, "w", encoding="utf-8", newline="") as f:
        writer = csv.DictWriter(f, fieldnames=fieldnames)
        writer.writeheader()      # ヘッダー行を書き込む
        writer.writerows(data)    # 各行を書き込む

    print(f"JSONをCSVに変換しました: {csv_filepath}")

if __name__ == "__main__":
    json_to_csv("todos.json", "todos.csv")

pip install pandas matplotlib

import json
from collections import Counter

import matplotlib.pyplot as plt
import pandas as pd

def analyze_todos(json_filepath: str) -> None:
    """
    ToDoリストのJSONからユーザーごとの完了件数を集計し、棒グラフで表示する関数です。
    """
    # JSONファイルを読み込み
    with open(json_filepath, "r", encoding="utf-8") as f:
        todos = json.load(f)

    # 完了済み(completed=True)のタスクだけを抽出
    completed_todos = [t for t in todos if t.get("completed")]

    # ユーザーIDごとに件数をカウント
    user_ids = [t.get("userId") for t in completed_todos]
    counts = Counter(user_ids)

    # pandasのDataFrameに変換
    df = pd.DataFrame(
        {"userId": list(counts.keys()), "completed_count": list(counts.values())}
    ).sort_values("userId")

    print("ユーザーごとの完了件数:")
    print(df)

    # 棒グラフで可視化
    plt.figure(figsize=(8, 4))
    plt.bar(df["userId"].astype(str), df["completed_count"])
    plt.xlabel("ユーザーID")
    plt.ylabel("完了済みToDo件数")
    plt.title("ユーザーごとの完了済みToDo件数")
    plt.tight_layout()
    plt.show()

if __name__ == "__main__":
    analyze_todos("todos.json")