Eén aanroep vertelt wat een telefoonnummer is: het netwerk dat het bedient, het netwerk dat het heeft uitgegeven, of het tussen beide is verplaatst en wat voor type lijn het is. Eén aanroep vertelt of een e-mailadres mail accepteert. Dezelfde key, dezelfde error-envelop, hetzelfde idempotency-contract als elk ander Bird-kanaal, omdat hetzelfde engineeringteam ze allemaal heeft gebouwd.
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
5 minuten van npm install tot eerste lookup
Zoek een nummer of adres op in de programmeertaal die u al gebruikt.
Getypte methoden in de Go-, TypeScript-, Python- en PHP-SDK's, en bird lookup op de CLI. Het dashboard voert dezelfde twee bewerkingen één voor één uit, wat de snelste manier is om een antwoord te zien voordat u code schrijft.
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);Wat een lookup beantwoordt, en wat elk antwoord kost.
Benoemde velden uit echte databronnen, geen model dat gokt. Elk veld vertelt u of het beantwoord is, en u wordt alleen gefactureerd voor de velden die dat zijn.
- 01
Land en beide netwerken
Het land van het nummer, het netwerk dat het nu bedient en het netwerk dat het nummerbereik heeft uitgegeven. Ze verschillen wanneer het nummer is geporteerd.
- 02
Lijntype-detectie
Mobiel, vast, VoIP, gratis nummer, premium rate, satelliet, pager, telefooncel, M2M, service. Bepaal of SMS überhaupt mogelijk is voordat u verzendt.
- 03
De porteringsvlag, gratis bij het basisantwoord
Of het nummer ooit van netwerk is gewisseld, wordt bij elke lookup meegeleverd. Vraag de porting-eigenschap op wanneer u ook de datums en het volledige record nodig hebt.
- 04
Zes eigenschappen op verzoek
Name classification, porting, presence, roaming, sim_swap of score in type. De toegewezen dienst van het bereik, het porteringsrecord, of de lijn actief is, of deze roamt, wanneer de SIM voor het laatst is gewisseld en een geloofwaardigheidsscore van 0-100.
- 05
Een status bij elke eigenschap
Elk blok meldt ok, unavailable of inconclusive. Alleen ok bevat een waarde, dus u hoeft nooit een response te inspecteren om te ontdekken dat deze leeg is.
- 06
U betaalt voor antwoorden, niet voor pogingen
De basislookup wordt één keer gefactureerd. Een eigenschap wordt alleen gefactureerd wanneer deze wordt geleverd, en een mislukte lookup kost helemaal niets.
- 07
Eén veld om een e-mailadres op te beoordelen
result is valid, neutral, risky, undeliverable of typo, met reason die aangeeft waarom een onbestelbaar adres geen mail kan ontvangen.
- 08
Een correctie voor een verkeerd gespeld adres
did_you_mean bevat het adres waarvan een typefout een spelfout lijkt te zijn. flags markeert een rol-, wegwerp- of gratis-provideradres, en delivery_confidence beoordeelt alles van 0 tot 100.
- 09
Een retry kan niet dubbel factureren
Stuur een Idempotency-Key mee en een herhaald verzoek speelt het antwoord af waarvoor u al hebt betaald, in plaats van een tweede aan te schaffen.
- 10
Dezelfde auth, dezelfde error-envelope
Eén API-key voor Lookup, SMS, e-mail, WhatsApp en Verify. Eén foutregistratie voor allemaal, en een eigen rate-limit-budget zodat een lookup nooit ten koste gaat van uw verzending.
Waarom we Lookup bouwen
Want u zou niet moeten ontdekken dat een nummer een vaste lijn is door te zien dat de SMS mislukt.
Het basisantwoord komt van hetzelfde carrierplatform dat Bird SMS en Voice routeert, en daarom kost het opvragen zo weinig: we draaiden de query al om in realtime een route te kiezen. Lookup is diezelfde query als volwaardig endpoint, zodat u een registratie kunt blokkeren, een lead kunt screenen of een bericht anders kunt routeren zonder eerst iets te versturen. Dezelfde auth, dezelfde error-envelop, hetzelfde idempotency-contract als de rest van het platform.
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
Twee bewerkingen, één voor elk type ontvanger.
Beide zijn één verzoek en één antwoord. Er is niets om aan te maken, niets om te pollen en niets om achteraf op te ruimen.
Telefoonnummer.
Land, beide netwerken, de porteringsvlag en het lijntype, plus elke eigenschap die u opgeeft in type.
E-mailadres.
Eén oordeel, een betrouwbaarheidsscore, de vlaggen die een risicovol adres verklaren en een correctie wanneer het eruitziet als een typefout.
Ontdek Lookup
Elke bewerking in detail. Eén API-sleutel, één foutformaat.
Betaal voor de antwoorden die u krijgt.
Prijs per query: één tarief per lookup, plus één voor elke eigenschap die beantwoord terugkomt. Een eigenschap die we niet kunnen beantwoorden en een lookup die mislukt, kosten niets. Geen licentiekosten.
Put it into practice.
Continue with the documentation, guides and examples for this topic. Resources are in English.