制限
上限のあるものすべてを一箇所にまとめました。発見されるのではなく公開するものです。予告なく出会う制限は、ドキュメントの不備です。
概要
1–5/sec
APIリクエスト数(アドレスごと)
キーなしなら1、有料プランのキーがあれば2、3または5です。1秒に1回のポーリングが想定された使い方です。
60/min
一分あたりの無料APIリクエスト数
IPアドレスごと、キーなしの場合。有料プランなら毎分の上限はありません。
1,000/day
一日あたりの無料APIリクエスト数
IPアドレスごと、00:00 UTCにリセット。有料プランなら一日の上限はありません。
5日
メッセージの保存期間
到着時から、読んでも読まなくても。上限は厳格です。
5MB
メッセージの最大サイズ
SMTP時点で拒否されるため、送信者に通知されます。
∞
ドメインごとのアドレス数
事前に何も作成されないため、何もカウントされません。
200
1回の呼び出しで返されるメッセージ数
既定値は50です。これは1回のレスポンスの上限であり、メールボックス自体の上限ではありません。
nextを使えば、残りが何件あっても続きをたどれます。0
送信メッセージ
送信用のエンドポイントはありません。意図的な設計です。
レート制限
無料・キーなしなら、IPアドレスごとに毎分 60 リクエスト、一日 1,000 リクエストまで。メールボックスへの呼び出しはすべて数えられます。一覧の取得、メッセージの読み取り、そのHTML本文、添付ファイル、削除のいずれも対象で、MCPツールの呼び出しも同様です。一日のカウントは 00:00 UTC にリセットされます。
その範囲内で、読み取りはアドレスごとに一秒に一回です。メールボックスを一秒に一回ポーリングする、それが想定されたリズムです。
無料APIキーを使うと、同じ利用枠がIPアドレスではなくアカウントに紐づきます。CIランナーのように、呼び出し元のアドレスが変わる場合に便利です。無料アカウントのキーは1つで、そのキーで読み取った受信箱はあなたの受信箱に表示されます。 無料キーを作成
有料プランには、毎分の上限も一日の上限もありません。有料プランのキーを Authorization: Bearer として送れば、残るのはプランごとのアドレスあたりの速度だけです——毎秒2、3または5リクエストで、すべてのドメインに適用され、アカウントごとに数えられます。Premiumは月 $12.99 からです。 プランを見る
このサイトの受信箱は、無料APIの枠を消費しません。ページを開いたままにしておけば、必要なあいだずっとメールの到着を確認し続けます。
上限を超えると Retry-After ヘッダー付きの 429 が返ります。値は秒単位の整数です。毎分の上限またはアドレスごとの上限なら rate_limited、一日の上限なら daily_limit_reached で、後者の場合は UTC で日付が変わるまでの残り時間が入ります。無料のレスポンスには、現在の残りが毎回含まれます——その分の残りは X-RateLimit-Remaining、その日の残りは X-RateLimit-Daily-Remaining です。
HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 0
Content-Type: application/json
{
"error": "daily_limit_reached",
"message": "free daily limit reached: 1000 requests a day per IP address, resets at 00:00 UTC — paid plans have no daily cap",
"upgrade": { "from": "$12.99/month", "url": "https://grabmail.io/pricing", … }
}固定時間の待機ではなく、Retry-Afterに従って調整してください。制限が変わっても、このヘッダーを参照するコードなら動作し続けます。
メッセージサイズ
添付ファイルを含めて5 MBまでのメッセージを受け付けます。この上限はSMTPのやり取りの中でメールサーバーが強制するため重要です。送信側サーバーは送ろうとしたその場で通知を受け、利用者に実際のエラーを報告できます。メッセージが黙って消えることはありません。
- 何がカウントされるか
- エンコード後のメッセージ全体です — ヘッダー、本文、そしてMIMEエンコード後のすべての添付ファイルを含みます。base64はバイナリを約3分の1膨張させるため、およそ3.5MBのファイルですでに上限に達してしまいます。
- 通信経路で起きること
- SMTP時点での
552です。メッセージは保存されず、メールボックスにも表示されません。 - メッセージごとの添付ファイル数
- 20個です。実際には容量の上限のほうが先に来ますが、ファイル名を持つパーツが20個を超えるメッセージでは、最初の20個だけが保持されます。
保存期間
メッセージは到着から5日後に削除されます。既読かどうかは関係なく、カウントは初回閲覧時ではなく到着時から始まります。
すべてのメッセージにexpires_atが付与されるため、クライアント側で削除日を計算したりポリシーを追跡したりする必要はありません。
これは設定ではなく厳格な上限です。パラメータでもプランでもアカウントでも延長できません。この期間を超えて残す必要があるものは、取得してご自身の側に保存してください。
アドレスとドメイン
- ドメインごとのアドレス数
- 無制限で、カウントもされません。メールボックスは作成されるものではないため、増えていくリストというもの自体が存在しません。
- ローカルパートのルール
- 1〜64文字で、英字・数字・ピリオド・ハイフン・アンダースコア・プラス記号のみ使用できます。先頭と末尾は英字か数字である必要があります。それ以外はメールサーバーに届く前に、ブラウザ側とサーバー側の両方で拒否されます。
- プラスアドレス
name+tag@domainはここではname@domainのエイリアスではなく、別個のメールボックスとして扱われます。これは意図的な仕様です — タグはサインアップを区別するためのものであり、まとめてしまうと本来分けておくべき受信箱が統合されてしまいます。- 大文字小文字
- すべて小文字に変換されます。
Name@とname@は同じメールボックスです。 - カスタムドメイン
- ここに向けられるドメイン数に制限はありません。それぞれに独自のMXレコードが必要です。
フェアユース
課金して回避できる枠はなく、これらの数値を引き上げるプランもありません。その代わりにあるのは、単一の送信元が他の全員にとってサービスを悪化させれば止められる、という仕組みです。
- 一括ポーリング
- 同一送信元から毎秒数千件のメールボックスをポーリングすると、APIに届く前にエッジで制限されます。
- メールの大量流入
- SMTP接続を過剰に開く送信元ホストは10分間ブロックされます。通常の送信元がこれに近づくことはありません。
- 中継サーバーとして利用する場合
- 禁止ではなく不可能です。メールサーバーはここでホストされているドメイン宛のメッセージしか受け付けないため、どこにも転送できません。
これは通常の自動化を想定したものではありません。1秒ごとにポーリングし、それを1日中、何千ものメールボックスにわたって行う、それが想定された使い方であり、限界ではありません。