Qiita API v2 を Python の urllib で呼ぶと途中から「HTTP Error 403: Forbidden」。認証なしの上限(1時間60回)で、read_qiita のトークンを付けたら通った

結論

認証なしで Qiita API v2 を呼び続けて、1時間60回の上限に当たっていたのが原因でした。read_qiita だけのアクセストークンを発行して Authorization ヘッダーに付けたら、上限が1時間1,000回になり、止まっていた処理が通りました。

自分の Qiita 記事の本文・題名・タグを API で読み直して確かめる小さなスクリプトを、その日に何本も回していました。最初は普通に動いていたのに、途中から急に 403 が返るようになりました。

症状

同じスクリプトで、何件かは通ったのに、途中から次のエラーで止まりました。

  File "C:\Program Files\WindowsApps\PythonSoftwareFoundation.Python.3.13_3.13.3824.0_x64__qbz5n2kfra8p0\Lib\urllib\request.py", line 613, in http_error_default
    raise HTTPError(req.full_url, code, msg, hdrs, fp)
urllib.error.HTTPError: HTTP Error 403: Forbidden

呼んでいたのは公開記事を読む GET https://qiita.com/api/v2/items/<記事ID> だけです。URL もコードも変えていないのに、急に「権限がない」と言われた形になります。

環境

  • Windows
  • Python 3.13(Microsoft Store 版)の標準の urllib.request
  • Qiita API v2。最初は認証なし(User-Agent ヘッダーだけ付けていた)

原因

Qiita の公式の API の説明(Qiita API v2 ドキュメント)に、利用回数の上限があります。

状態 上限
認証なし IP アドレスごとに、1時間に60回まで
認証あり(アクセストークンを付ける) ユーザーごとに、1時間に1,000回まで

この日は、記事の確認やタグの調査などで認証なしの呼び出しが積み重なり、60回を超えたところで 403 が返り始めました。エラーが 429 ではなく 403 なので、最初は権限の問題に見えて紛らわしいところです。

トークンを付けた後に回数の残りを読むと 999 / 1000 になっていて、上限が切り替わったことが確かめられました。

解決手順

  1. Qiita にログインして「設定 → アプリケーション」(https://qiita.com/settings/applications)を開き、「新しくトークンを発行する」を押します。
  2. スコープは read_qiita だけ にチェックを入れます。記事を読むだけなら書き込みの権限(write_qiita など)は要りません。説明の欄には「記事確認(読み取りのみ)」のように用途が分かる名前を入れます。
  3. 「発行する」を押すと、トークンが一度だけ表示されます。すぐにコピーして、ファイルに1行で保存します(チャットや画面に貼らない)。
QIITA_TOKEN=***
  1. リクエストのヘッダーに Authorization: Bearer <トークン> を足します。今回はヘッダーを作る小さな関数を1つの共通ファイルにまとめ、Qiita を呼ぶスクリプト3本をそれを使う形に替えました。考え方は次のとおりです(ファイルの場所は自分の環境に合わせてください)。
import os

def qiita_headers():
    h = {'User-Agent': 'Mozilla/5.0'}
    path = os.path.expanduser('~/.env_qiita')  # トークンを保存したファイル
    if os.path.exists(path):
        for line in open(path, encoding='utf-8'):
            if line.startswith('QIITA_TOKEN='):
                h['Authorization'] = 'Bearer ' + line.split('=', 1)[1].strip()
    return h

# 使う側
req = urllib.request.Request(f'https://qiita.com/api/v2/items/{item_id}', headers=qiita_headers())
  1. トークンを付けて呼び直すと、止まっていた残り2件も最後まで通りました。

再発防止・気づき

  • 認証なしの60回は、確認の呼び出しを何度も挟むとすぐ使い切ります。1回の処理で同じ記事を何度も読まないよう、確認の呼び出しをまとめると減らせます。
  • 待つだけでも1時間で60回に戻ります。急ぎでなければトークンは無くても回せます。
  • トークンはパスワードと同じ扱いです。スコープは読み取りだけにして、値はファイルに置き、ログや画面に出さないようにしました。
  • 複数のスクリプトや作業場所から Qiita を呼ぶなら、トークンのファイルは1か所にまとめ、ヘッダーを作る関数も共通にしておくと、差し替えが一度で済みます。

この記事を書いた人

realine

Windows の PC で、MT5(MQL5)の EA・インジケーターの開発、WordPress のプラグイン開発とサイト運営、PowerShell・Python での作業の自動化をしています。このサイトには、その作業で実際につまずいたことと、効いた直し方を、確かめた環境と手順つきで残しています。

運営者情報と記事の作り方