requests vs Playwright API【2026年版】｜PythonでAPIテストするならどちらを選ぶべきか

PythonでAPIテストを書くとき「requestsとPlaywright API、どちらを使うべきか」と迷うQAエンジニアは多い。requestsはシンプルで学習コストが低く、Playwright APIはE2Eテストとの統合に強い。本記事では15年以上のQA実務経験をもとに、同じAPIテストを両ツールで書き比べながら、使い分けの判断基準を実務目線で解説する。

requestsは「APIテスト専用の軽量ツール」、Playwright APIは「E2E+APIを1つのコードベースで管理するツール」——目的が違うので、どちらが優れているという話ではない。

「APIテストをPythonで書きたい」と思ったとき、最初に候補に挙がるのが requests ライブラリだ。シンプルで学習コストが低く、pytestとの組み合わせは定番中の定番。一方、E2EテストにPlaywrightを使っているチームでは「APIテストもPlaywright APIに統一したい」という声が出てくる。

本記事では「どちらが優れているか」ではなく、「どんなチーム・運用に向いているか」を実務ベースで整理していく。

requestsとPlaywright APIとは｜基本比較

コードで見る違い｜同じAPIテストを書き比べ

同じシナリオ（ユーザー一覧取得・ユーザー作成・認証）を両ツールで書いた場合の違いを見てみよう。

① GETリクエスト・基本的なアサーション

# ✅ requests + pytest
import requests

def test_ユーザー一覧が取得できる():
    response = requests.get(
        "https://jsonplaceholder.typicode.com/users",
        timeout=(3, 10)
    )
    assert response.status_code == 200
    users = response.json()
    assert len(users) > 0
    assert "name" in users[0]

# 🎭 Playwright API + pytest
# ※ playwright fixture を使う場合は pytest-playwright プラグインが必要
from playwright.sync_api import Playwright

def test_ユーザー一覧が取得できる(playwright: Playwright):
    api = playwright.request.new_context(
        base_url="https://jsonplaceholder.typicode.com"
    )
    response = api.get(
        "/users",
        timeout=10_000  # ms指定（10秒）
        # Playwrightにはデフォルト30秒タイムアウトあり。実務ではCI安定化のため明示指定が推奨
    )
    assert response.status == 200
    users = response.json()
    assert len(users) > 0
    assert "name" in users[0]
    # サンプルでは簡略化のため直接disposeしているが、実務ではfixture化して共通管理する
    api.dispose()

② POSTリクエスト・JSONボディ送信

# ✅ requests + pytest
import requests

def test_投稿が作成できる():
    payload = {
        "title": "自動テスト投稿",
        "body": "Playwright APIとrequestsの比較",
        "userId": 1
    }
    response = requests.post(
        "https://jsonplaceholder.typicode.com/posts",
        json=payload,
        timeout=(3, 10)
    )
    assert response.status_code == 201
    data = response.json()
    assert data["title"] == payload["title"]
    assert "id" in data

# 🎭 Playwright API + pytest
def test_投稿が作成できる(playwright: Playwright):
    api = playwright.request.new_context(
        base_url="https://jsonplaceholder.typicode.com"
    )
    payload = {
        "title": "自動テスト投稿",
        "body": "Playwright APIとrequestsの比較",
        "userId": 1
    }
    response = api.post(
        "/posts",
        json=payload,
        timeout=10_000  # ms指定（10秒）。デフォルト30秒あり、実務では明示指定推奨
    )
    assert response.status == 201
    data = response.json()
    assert data["title"] == payload["title"]
    assert "id" in data
    # サンプルでは簡略化のため直接disposeしているが、実務ではfixture化して共通管理する
    api.dispose()

③ 認証トークン付きリクエスト

# ✅ requests + pytest（Cookie認証）
import requests
import pytest

BASE_URL = "https://restful-booker.herokuapp.com"

@pytest.fixture(scope="session")
def auth_token() -> str:
    response = requests.post(
        f"{BASE_URL}/auth",
        json={"username": "admin", "password": "password123"},
        timeout=(3, 10)
    )
    response.raise_for_status()  # HTTPエラーを即検知
    data = response.json()
    assert "token" in data, "認証レスポンスにtokenが含まれていない"
    return data["token"]

def test_予約が削除できる(auth_token: str):
    headers = {"Cookie": f"token={auth_token}"}
    response = requests.delete(
        f"{BASE_URL}/booking/1",
        headers=headers,
        timeout=(3, 10)
    )
    assert response.status_code in (200, 201)

# 🎭 Playwright API + pytest（Cookie認証）
import pytest
from playwright.sync_api import Playwright, APIRequestContext

@pytest.fixture(scope="session")
def api_context(playwright: Playwright) -> APIRequestContext:
    # 実務ではconftest.pyでfixture化して全テストで使い回す
    api = playwright.request.new_context(
        base_url="https://restful-booker.herokuapp.com"
    )
    yield api
    api.dispose()

@pytest.fixture(scope="session")
def auth_token(api_context) -> str:
    response = api_context.post(
        "/auth",
        json={"username": "admin", "password": "password123"},
        timeout=10_000  # ms指定（10秒）
    )
    assert response.status == 200
    data = response.json()
    assert "token" in data, "認証レスポンスにtokenが含まれていない"
    return data["token"]

def test_予約が削除できる(api_context, auth_token: str):
    response = api_context.delete(
        "/booking/1",
        headers={"Cookie": f"token={auth_token}"}
    )
    assert response.status in (200, 201)

④ Playwright APIの真骨頂｜E2E+APIの統合テスト

これが requestsでは実現できない、Playwright APIの最大の強みだ。

# 🎭 Playwright：E2EテストとAPIテストを1つのテストで統合
from playwright.sync_api import Page, expect

def test_ユーザー登録後にAPIでも確認できる(page: Page, playwright):
    # ① UIでユーザーを登録（E2Eテスト）
    page.goto("https://example.com/register")
    page.fill("#email", "test@example.com")
    page.fill("#password", "SecurePass123")
    page.click("#register-btn")
    expect(page.get_by_text("登録完了")).to_be_visible()

    # ② APIでユーザーが作成されたことを確認（APIテスト）
    api = playwright.request.new_context(
        base_url="https://example.com"
    )
    response = api.get("/api/users?email=test@example.com")
    assert response.status == 200
    users = response.json()
    assert len(users) == 1
    assert users[0]["email"] == "test@example.com"
    api.dispose()

    # requests単体ではUI操作を扱えないため、
    # このようなE2E+API統合はPlaywrightとの組み合わせが自然

requestsの強みと弱み

Playwright APIの強みと弱み

どちらを選ぶか｜判断フロー

移行判断チェックリスト｜requests → Playwright API

現在requestsでAPIテストを書いているチームがPlaywright APIに移行すべきかを判断するチェックリストだ。

実務での推奨構成｜Session・fixture・conftest.py

requests.Session() を使うべき場面

ログイン後に複数のAPIを叩くシナリオでは requests.Session() が非常に強力だ。Cookieや認証ヘッダーを自動で引き継ぎ、接続も再利用できる。

import pytest
import requests

BASE_URL = "https://restful-booker.herokuapp.com"

@pytest.fixture(scope="session")
def auth_session() -> requests.Session:
    session = requests.Session()
    # 共通ヘッダーを一括設定
    session.headers.update({
        "Content-Type": "application/json",
        "Accept": "application/json"
    })
    # 認証してCookieを取得
    response = session.post(
        f"{BASE_URL}/auth",
        json={"username": "admin", "password": "password123"},
        timeout=(3, 10)
    )
    response.raise_for_status()     # HTTPエラーを即検知
    data = response.json()
    assert "token" in data, "認証レスポンスにtokenが含まれていない"
    token = data["token"]
    session.cookies.set("token", token)
    yield session       # yieldで後処理が走るようにする
    session.close()     # テスト終了後にセッションを確実に解放

def test_セッションで予約一覧を取得(auth_session: requests.Session):
    response = auth_session.get(f"{BASE_URL}/booking", timeout=(3, 10))
    assert response.status_code == 200
    assert len(response.json()) > 0

conftest.py を使った推奨ディレクトリ構成

tests/
├── conftest.py          # 共通fixture（auth_session, api_context等）
├── api/
│   ├── test_booking.py  # requestsベースのAPIテスト
│   └── test_auth.py
└── e2e/
    ├── test_login.py    # PlaywrightベースのE2Eテスト
    └── test_booking_ui.py

FAQ｜よくある質問

# pytest-playwrightを使わない最小構成
from playwright.sync_api import sync_playwright

def test_ユーザー一覧取得():
    with sync_playwright() as p:
        api = p.request.new_context(
            base_url="https://jsonplaceholder.typicode.com"
        )
        response = api.get("/users", timeout=10_000)
        assert response.status == 200
        users = response.json()
        assert len(users) > 0
        api.dispose()

まとめ

requestsとPlaywright API、どちらが優れているかではなく「自分のチームに何が必要か」で選ぶことが大切だ。迷ったときはこの記事のチェックリストと判断フローを参考にしてほしい。