FAQ Lookup API

Lookup menjawab pertanyaan tentang penerima sebelum Anda mengirim kepada mereka. Berikan nomor telepon dan ia memberi tahu Anda apa nomor tersebut: jaringan yang melayaninya, negara, apakah nomor tersebut telah berpindah jaringan, dan jenis salurannya. Berikan alamat email dan ia memberi tahu Anda apakah alamat tersebut layak untuk dikirim.

Dua hal, masing-masing satu operasi. Pencarian nomor telepon mengembalikan negara, jaringan yang melayani nomor tersebut, jaringan yang menerbitkannya, apakah nomor tersebut telah berpindah antara keduanya, dan jenis saluran, ditambah properti apa pun yang Anda minta. Pencarian alamat email mengembalikan satu putusan, skor kepercayaan, dan flag di baliknya.

Setiap pencarian adalah satu permintaan dan satu jawaban. Tidak ada yang perlu dibuat, tidak ada yang perlu di-poll, dan tidak ada yang perlu dibersihkan setelahnya. Method bertipe tersedia di SDK Go, TypeScript, Python, dan PHP, serta bird lookup phone-number dan bird lookup email melakukan hal yang sama dari CLI.

Ya. Halaman Lookup di dashboard menjalankan dua operasi yang sama satu per satu, yang merupakan cara tercepat untuk melihat seperti apa hasilnya sebelum Anda membangun di atasnya.

Kunci API dengan scope lookup, dan wallet organisasi yang dapat menanggung biayanya. Harga dihitung per kueri tanpa biaya per pengguna, jadi tidak ada paket yang perlu dipilih terlebih dahulu.

Gunakan saat Anda ingin memutuskan sebelum berkomitmen: menyaring pendaftaran, mengevaluasi prospek sebelum ditindaklanjuti, atau merutekan pesan secara berbeda tergantung jenis salurannya. Anda mendapatkan jawaban yang bisa ditindaklanjuti tanpa perlu mengirim apa pun terlebih dahulu.

Per kueri. Setiap pencarian ditagihkan ke dompet organisasi Anda. Pencarian nomor telepon ditagih sekali untuk pencarian dasar, ditambah satu tagihan untuk setiap properti yang dikembalikan dengan jawaban. Pencarian alamat email ditagih sekali per alamat yang terjawab. Tidak ada biaya per pengguna.

Halaman harga Lookup mencantumkan tarif untuk pencarian dasar, untuk setiap properti, dan untuk pencarian alamat email. Tarif bervariasi berdasarkan properti, karena masing-masing berasal dari sumber data yang berbeda.

Tidak. Properti ditagih hanya jika berhasil dikirimkan. Properti yang tidak dapat dijawab kembali dengan status yang menjelaskan hal tersebut dan tidak dikenakan biaya, serta pencarian dasar tetap disajikan bersamanya.

Tidak ada yang ditagih. Nomor yang salah format, alamat yang kami tolak, dan sumber data yang tidak dapat dijangkau semuanya tidak dikenakan biaya.

Ya. Setiap alamat yang terjawab ditagih, termasuk yang tidak dapat dikirim. Itulah jawaban yang Anda minta, dan itulah jawaban yang menghindarkan Anda dari bounce.

Tidak jika Anda mengirim Idempotency-Key. Pengulangan permintaan yang sama akan memutar ulang jawaban yang tersimpan alih-alih menjalankan pencarian baru. Form GET, yang menempatkan nomor atau alamat di URL, tidak dapat membawa idempotency key, jadi gunakan POST untuk apa pun yang diotomatisasi.

Batas rate pencarian dimulai dari 10 permintaan per menit, dihitung per kredensial yang bertindak, sehingga satu kunci yang sibuk tidak dapat menghabiskan jatah kunci lainnya. Setiap pencarian menjangkau sumber data eksternal dan mengenakan biaya ke wallet Anda untuk jawabannya, itulah mengapa batasnya dimulai di titik yang sama dengan batas pengiriman.

Belum saat ini. Tidak ada operasi yang memiliki bentuk batch, jadi memeriksa seluruh daftar bukan tujuan desainnya. Minta kami untuk menaikkan batas jika itu yang Anda butuhkan, alih-alih mencari solusi sendiri.

Scope lookup di level write. Tidak ada level read: setiap endpoint pencarian membutuhkan write, termasuk mengambil hasil yang sudah Anda bayar. Owner dan admin memilikinya secara default, sedangkan member tidak.

Empat yang penting. E22000 ketika nomor tidak valid dalam format internasional, E22003 ketika alamat bukan alamat email yang valid, E22001 ketika wallet organisasi tidak dapat menanggung biaya pencarian, dan E22002 ketika Lookup tidak tersedia sementara. Tidak ada yang dikenakan biaya.

Tidak. Properti yang gagal dikembalikan sebagai status di bloknya sendiri, dengan pencarian dasar disajikan bersamanya. Hanya kegagalan pencarian dasar yang membuat permintaan gagal, dan saat itu gagal sepenuhnya alih-alih mengembalikan jawaban setengah kosong yang harus Anda periksa untuk mengetahui bahwa hasilnya kosong.

Pencarian dasar menjawab negara nomor tersebut, jaringan yang melayaninya saat ini, jaringan yang menerbitkan rentang nomornya, apakah nomor tersebut pernah berpindah jaringan, dan jenis saluran secara umum. Pencarian dasar selalu dijalankan, dan jika tidak dapat dijawab, seluruh permintaan gagal alih-alih mengembalikan jawaban setengah kosong.

Kode panggilan negara terlebih dahulu, lalu nomor nasional. Tanda plus di depan bersifat opsional dan 00 dapat digunakan sebagai pengganti, jadi +31612345678, 31612345678, dan 0031612345678 semuanya adalah nomor yang sama.

Nomor yang ditulis untuk panggilan di dalam satu negara, tanpa kode negara, mengembalikan E22000 alih-alih ditebak. Menambahkan kode negara ke 0612345678 akan merujuk ke nomor nyata di tempat lain dan menagih Anda untuk pencarian nomor tersebut.

mobile, fixed_line, voip, toll_free, premium_rate, satellite, pager, payphone, m2m, service, other, atau unknown. unknown berarti platform operator tidak memiliki klasifikasi untuk rentang tersebut, dan other berarti platform memiliki klasifikasi yang tidak memiliki padanan di sini. Minta properti classification untuk layanan yang dialokasikan dengan presisi lebih tinggi.

network_info adalah jaringan yang melayani nomor saat ini dan original_network_info adalah jaringan yang menerbitkan rentang nomornya. Keduanya berbeda setelah nomor dipindahkan, dan flags berisi ported dalam kasus tersebut. Minta properti porting jika Anda juga membutuhkan tanggal dan catatan lengkapnya.

Karena nomor tersebut tidak termasuk dalam satu negara tertentu, seperti halnya rentang non-geografis. Kolom tanpa nilai dihilangkan alih-alih dikembalikan sebagai null, jadi setiap kolom yang ada dalam jawaban telah berhasil diselesaikan.

Tidak. Pencarian tidak pernah menghubungi nomor itu sendiri. Pencarian membaca data operator dan inteligensi nomor, dan properti presence serta roaming mengirim kueri ke jaringan tempat nomor terdaftar, jadi tidak ada yang berdering dan tidak ada yang sampai ke perangkat.

Enam, disebutkan dalam type. classification untuk layanan yang dialokasikan secara tepat dari rentang tersebut, porting untuk kapan nomor terakhir berpindah jaringan dan setiap perpindahan yang tercatat, presence untuk apakah nomor aktif di jaringan saat ini, roaming untuk apakah nomor sedang roaming dan di jaringan mana, sim_swap untuk kapan SIM terakhir diganti, dan score untuk skor kredibilitas dari 0 hingga 100.

Ya. classification, porting, dan score membaca data tersimpan dan kembali dengan cepat. presence, roaming, dan sim_swap menjangkau jaringan langsung, sehingga lebih lambat dan cakupannya bervariasi berdasarkan operator. Harapkan unavailable atau inconclusive untuk ketiganya lebih sering dibandingkan properti yang menggunakan data tersimpan.

ok berarti properti terjawab, nilainya ada di respons, dan ditagih. unavailable berarti tidak ada jawaban yang diterima, dan tidak ditagih. inconclusive berarti jawaban diterima tetapi tidak menyelesaikan properti, yang merupakan temuan nyata, dan juga tidak ditagih.

Ya, status adalah kosakata terbuka. Cabangkan pada ok dan perlakukan yang lainnya sebagai tidak terjawab, dan kode Anda tetap benar bagaimanapun kosakata berkembang.

porting memberi Anda tanggal dan riwayat lengkap, sedangkan flag ported pada pencarian dasar hanya menyatakan apakah perpindahan pernah terjadi. classification menerjemahkan line_type ke layanan yang dialokasikan secara tepat, dari sumber berbeda dengan kosakata lebih luas, dan dilaporkan secara terpisah sehingga Anda selalu dapat membedakan keduanya.

Karena jaringan tidak memberikan angka pasti. sim_swap mengembalikan min_days dan max_days alih-alih last_swapped_at jika hanya rentang kebaruan yang diketahui. porting melakukan hal serupa: menyetel last_ported_at_is_approximate jika registri mencatat periode perpindahan tetapi bukan tanggal pastinya.

Tidak. Itu berarti registri telah dikonsultasikan dan tidak memiliki catatan perpindahan untuk nomor ini, yang merupakan temuan tentang nomor tersebut, bukan celah dalam jawaban. Status pada blok itulah yang memberi tahu Anda apakah pemeriksaan berjalan atau tidak.

Sebagai satu sinyal di antara beberapa sinyal lainnya. Skor berkisar dari 0 untuk kredibilitas rendah hingga 100 untuk kredibilitas tinggi, merupakan skor komposit, dan tidak dapat diturunkan dari properti lainnya. Pertimbangkan skor ini bersama dengan hasil jawaban lainnya, jangan hanya mengandalkan skor ini saja.

Apakah alamat tersebut akan menerima email. Satu panggilan mengembalikan putusan di result, skor delivery_confidence, flag yang menjelaskan jenis alamat, dan koreksi jika alamat tersebut terlihat seperti salah ketik.

valid berarti alamat ada dan menerima email, jadi kirim. neutral berarti tidak dapat dikonfirmasi ke arah mana pun, biasanya karena domain penerima menjawab setiap penerima dengan cara yang sama. risky berarti kemungkinan menerima email tetapi lebih mungkin bounce atau mengajukan keluhan. undeliverable berarti tidak menerima email. typo berarti alamat terlihat salah eja.

reason menjelaskan mana dari tiga hal yang salah: invalid_syntax untuk alamat yang formatnya salah, invalid_domain ketika domain tidak menerima email sama sekali, dan invalid_recipient ketika domain menerima email tetapi kotak surat ini tidak ada.

Tawarkan did_you_mean kepada siapa pun yang mengetik alamat asli, alih-alih langsung mengirim ke alamat tersebut tanpa diminta. Koreksi tersebut adalah tebakan, dan alamat yang dimaksud mungkin bukan keduanya.

Skor ini berkisar dari 0, pasti tidak terkirim, hingga 100, pasti terkirim. Skor yang sama bisa berada di bawah putusan berbeda untuk alasan berbeda, jadi baca bersama result, bukan menggantikannya. Ini adalah field yang diandalkan ketika Anda menginginkan satu ambang batas untuk semua putusan, termasuk putusan yang ditambahkan di kemudian hari.

Tidak, dan perbedaannya penting. Field valid lebih sempit: ia menyatakan apakah alamat tersebut memiliki format yang benar dan domainnya dikonfigurasi untuk menerima email. Ia tidak mengatakan apa pun tentang kotak surat, jadi alamat dengan domain yang berfungsi tetapi kotak surat tidak ada akan bernilai true di sana dan undeliverable di result.

role berarti alamat tersebut menamai fungsi, bukan orang, seperti support@ atau info@, sehingga balasan dan persetujuan menjadi ambigu dan keluhan lebih mungkin terjadi. disposable berarti penyedia alamat sekali pakai, sehingga alamat tersebut biasanya akan berhenti ada. free_provider berarti penyedia kotak surat konsumen seperti Gmail atau Outlook.com, yang hanya menjadi sinyal ketika Anda mengharapkan alamat bisnis.

Kirim alamat polos, persis seperti yang Anda simpan. Bentuk display-name, dengan nama di depan dan alamat dalam tanda kurung siku, akan ditolak alih-alih dibuka, karena membukanya akan mencari alamat yang tidak Anda kirim. Bagian sebelum tanda at diteruskan apa adanya, dan mengubah kapitalisasinya dapat mengubah delivery_confidence yang Anda dapatkan.

Tidak. Suppressions melakukannya secara otomatis dan gratis, untuk alamat yang sudah bounce atau mengajukan keluhan. Gunakan Lookup untuk alamat yang belum pernah Anda kirimi, saat pendaftaran atau sebelum Anda menindaklanjuti prospek.