Лимиты

Кратко

• 1–5/сек

  Запросы к API на адрес

  Один запрос без ключа; 2, 3 или 5 — с ключом платного тарифа. Опрос раз в секунду — предусмотренный режим работы.

• 60/мин

  Бесплатных запросов к API в минуту

  С одного IP-адреса, без ключа. На платных тарифах поминутного лимита нет.

• 1 000/сут

  Бесплатных запросов к API в сутки

  С одного IP-адреса; счётчик обнуляется в 00:00 UTC. На платных тарифах суточного лимита нет.

• 5дней

  Срок хранения сообщений

  С момента получения, прочитано или нет. Жёсткий лимит.

• 5MB

  Максимальный размер сообщения

  Отклоняется на этапе SMTP, поэтому отправитель об этом узнаёт.

• ∞

  Адресов на домен

  Заранее ничего не создаётся, поэтому и считать нечего.

• 200

  Сообщений за один запрос

  По умолчанию 50. Это ограничивает один ответ, а не сам ящик: next листает всё остальное, сколько бы его ни было.

• 0

  Исходящие сообщения

  Эндпоинта для отправки нет. Так и задумано.

Лимиты запросов

Бесплатно, без ключа: до 60 запросов в минуту и до 1 000 в сутки с одного IP-адреса. Учитывается каждый вызов к ящику — получение списка, чтение письма, его HTML-версии или вложения, удаление, — а также каждый вызов инструмента MCP. Суточный счётчик обнуляется в 00:00 UTC.

В этих пределах действует одно чтение в секунду на адрес: опрашивать ящик раз в секунду — предусмотренный ритм.

С бесплатным ключом API тот же лимит привязан к вашему аккаунту, а не к IP-адресу — удобно, когда вызовы идут с меняющихся адресов, например с CI-раннера. У бесплатного аккаунта один ключ, а ящики, которые он читает, появляются в ваших ящиках. Создать бесплатный ключ

У платных тарифов нет ни поминутного, ни суточного лимита. Передайте ключ платного тарифа в заголовке Authorization: Bearer — и останется только лимит тарифа на адрес: 2, 3 или 5 запросов в секунду на любом домене, а счёт ведётся по аккаунту. Premium — от $12,99 в месяц. Посмотреть тарифы

Ящик на этом сайте не расходует бесплатный лимит API: оставьте страницу открытой — она будет проверять почту столько, сколько вам нужно.

При превышении лимита вы получите 429 с заголовком Retry-After в целых секундах: 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,5 МБ уже заполняет собой весь предел.

Что происходит на линии

Код 552 во время сеанса SMTP. Сообщение никогда не сохраняется и никогда не появляется в почтовом ящике.

Вложений на сообщение

Двадцать. На практике предел размера наступает раньше — но если сообщение несёт больше двадцати частей с именами файлов, сохраняются только первые двадцать.

Срок хранения

Сообщение удаляется через 5 дней после получения, прочитано оно или нет, и отсчёт начинается с момента доставки, а не первого прочтения.

У каждого сообщения есть expires_at, так что клиенту никогда не нужно вычислять эту дату или отслеживать политику.

Это жёсткий лимит, а не настройка: ни параметр, ни тариф, ни аккаунт его не продлевают. Если что-то должно пережить это окно, получите это и сохраните у себя.

Адреса и домены

Адресов на домен

Без ограничений и без подсчёта. Поскольку почтовый ящик никогда не создаётся, нет и списка, который мог бы расти.

Правила локальной части

От одного до 64 символов: буквы, цифры, точка, дефис, подчёркивание и плюс. Должен начинаться и заканчиваться буквой или цифрой. Всё остальное отклоняется ещё до почтового сервера — и в браузере, и повторно на сервере.

Плюс-адресация

name+tag@domain здесь отдельный почтовый ящик, а не псевдоним name@domain. Это сделано намеренно — тегами люди разделяют регистрации, и объединение адресов слило бы ящики, которые должны были оставаться раздельными.

Регистр

Всё приводится к нижнему регистру. Name@ и name@ — один и тот же ящик.

Собственные домены

Нет ограничений на число доменов, которые вы сюда направите. Каждому нужна своя MX-запись.

Квоты премиум-пула

Всё сказанное выше описывает бесплатный сервис, и он таким и остаётся: у публичных доменов и ваших собственных нет ни квоты на письма, ни лимита адресов ни на одном тарифе.

Платный тариф добавляет 97 частных доменов .com, которые держат вне чёрных списков одноразовой почты. В квоту засчитываются только письма, приходящие именно на ЭТИ домены: Premium USD 12.99/month (2 000 premium messages/month, 1 API key, 2 req/s per address, no per-minute or daily API cap); Pro USD 49.99/month (15 000 premium messages/month, 5 API keys, 3 req/s per address, no per-minute or daily API cap); Scale USD 99.99/month (36 000 premium messages/month, 20 API keys, 5 req/s per address, no per-minute or daily API cap).

Единица квоты — это письмо, полученное на премиум-адрес, или открытый новый премиум-адрес, смотря что наступит раньше. Первое чтение адреса действующим ключом закрепляет его за аккаунтом; он остаётся удерживаемым — и бесплатным для повторного чтения — пока не будет освобождён в панели или пока тариф не станет просроченным. Ни один тариф не ограничивает число адресов, которые может удерживать аккаунт.

Они читаются через те же эндпоинты, с ключом платного тарифа в заголовке Authorization: Bearer. Без него премиум-адрес отвечает 404 — тот же ответ, что и для домена, который мы не обслуживаем, — намеренно, чтобы пул нельзя было раскрыть перебором имён. С ключом 402 значит, что квота исчерпана, а 403 — что адрес удерживает другой подписчик. Полная таблица, а также вызовы для проверки ключа и получения списка пула — в справочнике API.

Добросовестное использование

Нет квоты, которую можно купить, и нет тарифа, повышающего эти цифры. Вместо этого есть другое: если один источник ухудшает сервис для всех остальных, его останавливают.

Массовый опрос

Тысячи почтовых ящиков, опрашиваемых каждую секунду с одного источника, будут ограничены на краю сети ещё до того, как запрос дойдёт до API.

Почтовые потоки

Отправляющий хост, открывающий неоправданно много SMTP-соединений, блокируется на десять минут. Обычные отправители никогда не приближаются к этому пределу.

Использование нас в качестве ретранслятора

Невозможно, а не запрещено: почтовый сервер принимает только сообщения, адресованные размещённым здесь доменам, поэтому он не может ничего никуда пересылать.

Всё это не рассчитано на обычную автоматизацию как исключение. Опрашивать раз в секунду, весь день, по тысячам почтовых ящиков — это и есть предполагаемое использование, а не его крайний случай.