Menerima Email: Membaca
Cari
Cari di kotak surat berdasarkan pengirim, domain, subjek, isi, atau label, dengan operator yang sama seperti kotak pencarian webmail.
https://g.sendcorex.com/v1command: searchTanpa field, pencarian berjalan otomatis: alamat email lengkap mencari pengirim yang persis, domain.com mencari berdasarkan domain, dan selain itu mencari di subjek, isi, dan nama pengirim.
Dengan operator (from:, is:unread…) hasil dikelompokkan per percakapan: satu baris per thread, dengan pesan terbaru yang cocok. Tanpa in:, Spam dan Sampah tidak diikutkan.
Argumen
querystringwajibApa yang dicari, hingga 256 karakter. Dengan beberapa kata, kata pertama diambil dari indeks dan kata lainnya memfilter berdasarkan subjek dan pratinjau.
fieldstringopsionalBatasi pencarian biasa ke
from,to,subject,body,sender, ataulabel. Diabaikan jika kueri memiliki operator.limitnumberopsionalUkuran halaman, 1 sampai 100. Default 25.
cursorstringopsionalnext_cursordari halaman sebelumnya.
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "search",
args: {
query: "ana@client.com",
field: "from",
limit: 5
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respons
{
"type": "SUCCESS",
"results": [
{
"command": "search",
"id": "0",
"type": "SUCCESS",
"data": {
"messages": [
{
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"subject": "Invoice for September",
"preview": "Hi, attached is the invoice for September…",
"from_name": "Ana Costa",
"from_email": "ana@client.com",
"folders": [
"INBOX"
],
"is_read": false,
"is_starred": false,
"is_important": false,
"received_at": "2026-10-09T14:21:07Z"
}
],
"has_more": false,
"next_cursor": null
}
}
]
}Field respons
messages[]Pesan yang cocok, terbaru lebih dulu. Masing-masing memiliki
message_uid,thread_id,subject,preview,from_name,from_email,folders, flag dibaca/bintang/penting, danreceived_at.has_more / next_cursorPaginasi.
Operator
Gabungkan dengan kata biasa. Nilai yang mengandung spasi diberi tanda kutip: subject:"new proposal". Tambahkan - di depan untuk mengecualikan: -from:noreply, -newsletter.
Body request
{
"commands": [
{
"command": "search",
"args": {
"query": "from:ana@client.com has:attachment newer_than:30d invoice"
}
}
]
}from: / to:Pengirim / penerima (to atau cc), sebagian nama atau alamat.
subject: / label:Teks subjek / sebuah label.
in:inbox,sent,archive,trash,spam,drafts,promotions,snoozed,scheduled,agents,not-subscribing, atau id folder kustom.has:attachmentHanya pesan dengan lampiran.
is:unread / is:read / is:starred / is:importantStatus pesan.
after: / before:Tanggal
YYYY/MM/DD(atauYYYY-MM-DD), UTC.newer_than: / older_than:7d,2w,3m(30 hari), atau1y.
Hanya filter, tanpa kata yang dicari (is:unread in:archive), mengembalikan threads (daftar percakapan folder tersebut), bukan messages.
Contoh pencarian
Body request
// subject + body + sender name
{
"commands": [
{
"command": "search",
"args": {
"query": "invoice september"
}
}
]
}
// exact sender
{
"commands": [
{
"command": "search",
"args": {
"query": "ana@client.com",
"field": "from"
}
}
]
}
// everyone from a domain
{
"commands": [
{
"command": "search",
"args": {
"query": "client.com"
}
}
]
}
// messages with a label
{
"commands": [
{
"command": "search",
"args": {
"query": "cliente-vip",
"field": "label"
}
}
]
}Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
TOKEN_EXPIREDAccess token sudah kedaluwarsa. Panggil Refresh Token lalu ulangi request.
- 401
INVALID_TOKENToken salah format, tidak dikenal, atau dicabut.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.
- CMD
INVALID_ARGSArgumen wajib tidak ada atau tidak valid.
- CMD
INVALID_CURSORCursor salah format atau milik akun atau folder lain.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.