Batasan

Sekilas

• 1–5/detik

  Permintaan API, per alamat

  Satu tanpa kunci; 2, 3, atau 5 dengan kunci dari paket berbayar. Poll sekali per detik adalah pola yang dimaksudkan.

• 60/menit

  Permintaan API gratis, per menit

  Per alamat IP, tanpa kunci. Paket berbayar tidak dibatasi per menit.

• 1.000/hari

  Permintaan API gratis, per hari

  Per alamat IP, disetel ulang pukul 00:00 UTC. Paket berbayar tidak dibatasi per hari.

• 5hari

  Retensi pesan

  Sejak kedatangan, dibaca atau tidak. Batas keras.

• 5MB

  Ukuran pesan maksimum

  Ditolak saat SMTP, sehingga pengirim diberi tahu.

• ∞

  Alamat per domain

  Tidak ada yang dibuat di muka, jadi tidak ada yang dihitung.

• 200

  Pesan yang dikembalikan per panggilan

  Default 50. Ini membatasi satu respons, bukan mailbox: next menelusuri sisanya, berapa pun jumlahnya.

• 0

  Pesan keluar

  Tidak ada endpoint pengiriman. Memang dirancang begitu.

Batas laju

Gratis, tanpa kunci: 60 permintaan per menit dan 1.000 per hari, per alamat IP. Setiap panggilan ke sebuah kotak masuk ikut dihitung — menampilkan daftar isinya, membaca pesan, badan HTML pesan, lampiran, penghapusan — begitu juga setiap panggilan alat MCP. Hitungan harian disetel ulang pukul 00:00 UTC.

Di dalam jatah itu, satu pembacaan per detik per alamat: melakukan polling kotak masuk sekali per detik adalah irama yang dimaksudkan.

Dengan kunci API gratis, kuota yang sama mengikuti akun Anda, bukan alamat IP Anda — berguna saat panggilan Anda datang dari alamat yang berubah-ubah, seperti runner CI. Akun gratis punya satu kunci, dan kotak masuk yang dibacanya tercantum di kotak masuk Anda. Buat kunci gratis

Paket berbayar bebas dari batas per menit dan batas harian. Kirim kunci paket berbayar sebagai Authorization: Bearer, dan yang tersisa hanyalah batas per alamat dari paket Anda — 2, 3, atau 5 permintaan per detik, di semua domain, dihitung per akun. Premium mulai dari $12,99 per bulan. Lihat paketnya

Kotak masuk di situs ini tidak memakai jatah API gratis: halaman yang dibiarkan terbuka akan terus memeriksa surat masuk selama Anda membutuhkannya.

Melewati batas, Anda akan mendapat 429 dengan header Retry-After dalam detik bulat: rate_limited untuk batas per menit atau per alamat, daily_limit_reached untuk batas harian, disertai sisa waktu hingga tengah malam UTC. Setiap respons atas permintaan gratis menunjukkan sisa jatah Anda: X-RateLimit-Remaining untuk menit berjalan, X-RateLimit-Daily-Remaining untuk hari berjalan.

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", … }
}

Gunakan penundaan berdasarkan Retry-After, bukan jeda tetap. Jika batasnya berubah suatu saat, kode yang membaca header ini akan tetap berfungsi.

Ukuran pesan

Pesan hingga 5 MB, termasuk lampiran. Batas ini diberlakukan oleh server mail selama percakapan SMTP, dan itu penting: server pengirim diberi tahu pada saat mencoba, dan melaporkan kegagalan nyata ke penggunanya, alih-alih pesan menghilang begitu saja.

Apa yang dihitung

Seluruh pesan yang sudah dienkode — header, isi, dan setiap lampiran setelah pengkodean MIME. Base64 memperbesar ukuran biner sekitar sepertiga, jadi berkas sekitar 3,5 MB saja sudah memenuhi batasnya.

Apa yang terjadi di jalur pengiriman

552 pada saat SMTP. Pesan tersebut tidak pernah disimpan dan tidak pernah muncul di kotak surat.

Lampiran per pesan

Dua puluh. Dalam praktiknya, batas ukuran pesanlah yang akan Anda temui lebih dulu — tapi pesan yang membawa lebih dari dua puluh bagian dengan nama berkas hanya menyimpan dua puluh yang pertama.

Retensi

Pesan dihapus 5 hari setelah tiba, dibaca atau tidak, dan hitungan waktu dimulai sejak pengiriman, bukan sejak pertama kali dibaca.

Setiap pesan membawa expires_at, jadi klien tidak perlu menghitung tanggal itu atau melacak kebijakannya.

Ini batas keras, bukan pengaturan: tidak ada parameter, paket, atau akun yang memperpanjangnya. Jika ada yang harus bertahan lebih lama dari jendela waktu ini, ambil dan simpan di sisi Anda.

Alamat dan domain

Alamat per domain

Tak terbatas, dan tidak dihitung. Karena mailbox tidak pernah benar-benar dibuat, tidak ada daftar yang bisa bertambah.

Aturan bagian-lokal

Satu hingga 64 karakter: huruf, angka, titik, tanda hubung, garis bawah, dan tanda tambah. Harus dimulai dan diakhiri dengan huruf atau angka. Selain itu ditolak sebelum mencapai server mail, di browser dan sekali lagi di server.

Alamat plus

name+tag@domain adalah kotak masuk yang berbeda di sini, bukan alias dari name@domain. Itu disengaja — tag adalah cara orang memisahkan pendaftaran, dan menggabungkannya akan menyatukan kotak masuk yang seharusnya tetap terpisah.

Huruf besar/kecil

Semua huruf diubah menjadi huruf kecil. Name@ dan name@ adalah mailbox yang sama.

Domain kustom

Tidak ada batas berapa banyak yang Anda arahkan ke sini. Masing-masing memerlukan rekaman MX-nya sendiri.

Kuota pool premium

Semua di atas menjelaskan layanan gratis, dan tetap begitu: domain publik dan domain milik Anda tidak punya kuota pesan maupun batas alamat, di paket mana pun.

Paket berbayar menambahkan 97 domain .com privat, yang dijauhkan dari daftar hitam surel sekali pakai. Hanya pesan yang masuk ke domain-domain ITU yang dihitung terhadap kuota: 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).

Satu unit kuota adalah sebuah pesan yang diterima di alamat premium atau sebuah alamat premium baru yang dibuka, mana pun yang lebih dulu terjadi. Pembacaan pertama sebuah alamat dengan kunci yang sah membuat alamat itu dipegang oleh akun tersebut; alamat itu tetap dipegang — dan gratis dibaca lagi — sampai dilepaskan dari dasbor atau paketnya berakhir. Tidak ada paket yang membatasi berapa banyak alamat yang dipegang sebuah akun.

Alamat-alamat itu dibaca lewat endpoint yang sama, dengan kunci Authorization: Bearer dari paket berbayar. Tanpa itu, alamat premium menjawab 404 — jawaban yang sama seperti domain yang tidak kami host, secara sengaja, agar kumpulan tidak bisa didaftar dengan menebak nama. Dengan kunci itu, 402 berarti kuota sudah habis dan 403 berarti pelanggan lain sedang memegang alamat itu. Tabel lengkapnya, beserta panggilan untuk memeriksa kunci dan mendaftar kumpulan, ada di referensi API.

Penggunaan wajar

Tidak ada kuota yang bisa dibeli untuk melewati batas ini, dan tidak ada paket yang menaikkan angka-angka ini. Yang ada sebagai gantinya: jika satu sumber membuat layanan menjadi lebih buruk bagi semua orang lain, sumber itu dihentikan.

Polling massal

Ribuan mailbox yang dipolling setiap detik dari satu sumber akan dibatasi di edge sebelum mencapai API.

Banjir surat

Host pengirim yang membuka jumlah koneksi SMTP yang tidak wajar akan diblokir sementara selama sepuluh menit. Pengirim normal tidak akan pernah mendekati batas itu.

Menggunakan kami sebagai relay

Tidak mungkin, bukan sekadar dilarang: server surat hanya menerima pesan yang ditujukan ke domain yang dihosting di sini, jadi tidak bisa meneruskan apa pun ke mana pun.

Tidak ada dari ini yang ditujukan untuk otomatisasi biasa. Polling sekali per detik, sepanjang hari, di ribuan kotak surat — itulah penggunaan yang dimaksudkan, bukan batas ekstremnya.