Bird Lookup
Periksa penerima sebelum Anda mengirim pesan kepada mereka.
Check whether an email address can receive mail or find the carrier behind a phone number.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
const answer = await bird.lookup.phoneNumber({
phone_number: "+31612345678",
type: ["porting", "score"],
});
console.log(answer.country_code, answer.line_type);
// → "NL" "mobile"
console.log(answer.network_info?.carrier_name, answer.flags);
// → "KPN" ["ported"]
// Only a block whose status is ok carries a value,
// and only that one is billed.
if (answer.score?.status === "ok") console.log(answer.score.value);
// → 84
Check an email address
Sign in to Bird to check an email address. Paste it into the Lookup form in your dashboard. You can also check addresses from your code, one API call per address.
The result helps you decide whether to send to that address. A correctly spelled address can still bounce.
See what the check tells you in email address lookup. Follow the email lookup guide to add it to your code.
5 menit dari npm install ke pencarian pertama
Cari nomor atau alamat dari bahasa pemrograman yang sudah Anda gunakan.
Metode bertipe di SDK Go, TypeScript, Python, dan PHP, serta bird lookup di CLI. Dashboard menjalankan dua operasi yang sama satu per satu, yang merupakan cara tercepat untuk melihat jawaban sebelum Anda menulis kode apa pun.
const answer = await bird.lookup.phoneNumber({
phone_number: "+31612345678",
type: ["classification", "score"],
});
console.log(answer.country_code, answer.line_type);
// Only a block whose status is ok carries a value, and only that one is billed.
if (answer.score?.status === "ok") console.log(answer.score.value);Apa yang dijawab oleh lookup, dan berapa biaya setiap jawabannya.
Field bernama dari sumber data nyata, bukan tebakan model. Setiap field memberi tahu apakah berhasil dijawab, dan Anda hanya ditagih untuk yang berhasil dijawab.
- 01
Negara dan kedua jaringan
Negara nomor tersebut, jaringan yang melayaninya saat ini, dan jaringan yang menerbitkan rentangnya. Keduanya berbeda jika nomor tersebut telah diportasi.
- 02
Deteksi tipe saluran
Seluler, saluran tetap, VoIP, bebas pulsa, tarif premium, satelit, pager, telepon umum, M2M, layanan. Tentukan apakah SMS memungkinkan sebelum Anda mengirim.
- 03
Flag portasi, gratis dengan jawaban dasar
Apakah nomor tersebut pernah berpindah jaringan tersedia di setiap lookup. Minta properti porting jika Anda juga membutuhkan tanggal dan catatan lengkapnya.
- 04
Enam properti sesuai permintaan
Klasifikasi nama, porting, kehadiran, roaming, sim_swap, atau score dalam type. Layanan yang dialokasikan dari rentang, catatan portasi, apakah saluran aktif, apakah sedang roaming, kapan SIM terakhir diganti, dan skor kredibilitas 0-100.
- 05
Status di setiap properti
Setiap blok melaporkan ok, unavailable, atau inconclusive. Hanya ok yang membawa nilai, jadi Anda tidak perlu memeriksa respons untuk menemukan bahwa itu kosong.
- 06
Anda membayar untuk jawaban, bukan percobaan
Lookup dasar ditagih sekali. Properti hanya ditagih saat berhasil dikirim, dan lookup yang gagal tidak ditagih sama sekali.
- 07
Satu field untuk memutuskan alamat email
result berupa valid, neutral, risky, undeliverable, atau typo, dengan reason yang menyebutkan mengapa alamat undeliverable tidak dapat menerima pesan.
- 08
Koreksi untuk alamat yang salah ketik
did_you_mean suggests a correction when an address looks misspelled. flags marks a role, disposable, or free-provider address, and delivery_confidence grades all of it from 0 to 100.
- 09
Percobaan ulang tidak bisa ditagih dua kali
Kirim Idempotency-Key dan permintaan yang diulang akan memutar ulang jawaban yang sudah Anda bayar, bukan membeli yang kedua.
- 10
Autentikasi sama, format error sama
Satu kunci API untuk Lookup, SMS, Email, WhatsApp, dan Verify. Satu registri error untuk semuanya, dan anggaran rate-limit tersendiri sehingga lookup tidak menghabiskan kuota pengiriman Anda.
Mengapa kami membangun Lookup
Karena Anda tidak seharusnya mengetahui sebuah nomor adalah telepon rumah dari kegagalan SMS.
Jawaban dasar berasal dari platform operator yang sama yang merutekan SMS dan Voice Bird, itulah mengapa biayanya sangat rendah: kami sudah menjalankan kueri tersebut untuk memilih rute secara real time. Lookup adalah kueri tersebut sebagai endpoint kelas satu, sehingga Anda bisa memvalidasi pendaftaran, menyaring prospek, atau merutekan pesan secara berbeda tanpa harus mengirim apa pun terlebih dahulu. Autentikasi yang sama, format error yang sama, kontrak idempotensi yang sama seperti platform lainnya.
import { BirdClient } from "@messagebird/sdk";
const bird = new BirdClient({
apiKey: process.env.BIRD_API_KEY!,
});
const answer = await bird.lookup.phoneNumber({
phone_number: "+31612345678",
type: ["porting", "score"],
});
console.log(answer.country_code, answer.line_type);
// → "NL" "mobile"
console.log(answer.network_info?.carrier_name, answer.flags);
// → "KPN" ["ported"]
// Only a block whose status is ok carries a value,
// and only that one is billed.
if (answer.score?.status === "ok") console.log(answer.score.value);
// → 84
Dua operasi, satu untuk setiap jenis penerima.
Keduanya berupa satu permintaan dan satu jawaban. Tidak ada yang perlu dibuat, tidak ada yang perlu di-poll, dan tidak ada yang perlu dibersihkan setelahnya.
Nomor telepon.
Negara, kedua jaringan, flag portasi, dan jenis saluran, ditambah properti apa pun yang Anda sebutkan di type.
Alamat email.
Satu putusan, skor kepercayaan, flag yang menjelaskan alamat berisiko, dan koreksi jika terbaca seperti salah ketik.
Jelajahi Lookup
Setiap operasi secara mendalam. Satu API key, satu format error.
Bayar sesuai jawaban yang Anda dapatkan.
Harga per kueri: satu biaya per pencarian, ditambah satu untuk setiap properti yang terjawab. Properti yang tidak dapat kami jawab dan pencarian yang gagal tidak dikenakan biaya. Tanpa biaya per pengguna.
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.