# Panoramica di Lookup

Lookup risponde a domande su un destinatario prima che tu gli invii qualcosa. Passagli un numero di telefono e ti dice cosa è quel numero: la rete che lo serve, il paese, se ha cambiato rete e che tipo di linea è. Passagli un indirizzo email e ti dice se vale la pena inviarci messaggi.

Entrambi sono una richiesta e una risposta. Non c'è nulla da creare, nulla da interrogare periodicamente e nulla da ripulire dopo. La pagina [**Lookup**](https://bird.com/dashboard/w/lookup) nella dashboard esegue le stesse due operazioni una alla volta, ed è il modo più rapido per vedere com'è fatta una risposta prima di scrivere codice.

## Quanto costa ogni lookup

Ogni lookup viene addebitato al wallet della tua organizzazione, e questa è la parte che vale la pena capire prima di costruirci sopra.

Un lookup su numero di telefono addebita sempre una volta per il lookup base. In più puoi richiedere delle **proprietà**, dati aggiuntivi che provengono da una fonte dati a pagamento. Ogni proprietà richiesta viene addebitata separatamente, ma **solo quando viene restituita**. Una proprietà che non ha potuto ricevere risposta torna con uno stato che lo indica e non ti costa nulla.

Un lookup su indirizzo email addebita una volta per ogni indirizzo a cui è stata data risposta. Ogni verdetto viene addebitato, `undeliverable` incluso: è la risposta che hai chiesto, ed è quella che ti evita un bounce.

Non viene addebitato nulla quando un lookup fallisce. Un numero malformato, un indirizzo che rifiutiamo o una fonte dati non raggiungibile non costano nulla.

[Prezzi di Lookup](/products/lookup/pricing) elenca la tariffa per il lookup base, per ogni proprietà e per un lookup su indirizzo email.

## Il lookup su numero ha due livelli

Questa suddivisione è l'intero design del lookup su numero di telefono, quindi vale la pena spiegarla chiaramente.

Il **lookup base** viene sempre eseguito. Risponde con la rete che serve il numero, la rete che lo ha emesso, il paese, se il numero ha mai cambiato rete e un `line_type` generico (mobile, rete fissa, VoIP, numero verde e così via). Se il lookup base non può ricevere risposta, l'intera richiesta fallisce anziché restituire una risposta semivuota che dovresti ispezionare per scoprire che era vuota.

Le **proprietà** sono ciò che aggiungi sopra, indicandole in `type`. Rispondono a domande più specifiche: il servizio allocato preciso dell'intervallo, il record completo di portabilità, se il numero è attivo sulla rete in questo momento, se è in roaming, quando la SIM è stata cambiata l'ultima volta e un punteggio di credibilità. Una proprietà che non può ricevere risposta non fa mai fallire la richiesta. Degrada a uno stato, e il lookup base viene comunque restituito.

## Solo `ok` contiene un valore, e solo `ok` viene addebitato

Ogni blocco proprietà ha un `status`, e leggerlo non è facoltativo.

`ok` significa che la proprietà ha ricevuto risposta, il suo valore è nella risposta e l'addebito è avvenuto.

`unavailable` significa che non è arrivata nessuna risposta, quindi la proprietà non aggiunge nulla. Non è stata addebitata.

`inconclusive` significa che è arrivata una risposta ma non risolve la proprietà: il numero è fuori dalla copertura dei dati che la alimentano, oppure la fonte ha restituito un valore che questa proprietà non riporta. È un risultato reale, non mancante, e non è stato addebitato nemmeno questo.

`status` è un vocabolario aperto, quindi potrebbero essere aggiunti altri valori. Controlla `ok` e tratta tutto il resto come "not answered": il tuo codice resterà corretto indipendentemente da come cresce.

## Scegliere tra Lookup e la validazione all'invio

Lookup serve a decidere **prima** di procedere, un destinatario alla volta: verificare un numero o un indirizzo alla registrazione, valutare un lead prima di agire, oppure instradare un messaggio in modo diverso a seconda del tipo di linea. Costa denaro per ogni controllo e ti dà una risposta su cui puoi agire.

Se vuoi solo smettere di inviare a indirizzi che hanno già generato un bounce o un reclamo, non hai bisogno di Lookup. Le [soppressioni](/docs/guides/email/suppressions) lo fanno automaticamente e senza costi.

Nessuna delle due operazioni ha una forma batch, e la [limitazione delle richieste](/docs/guides/rate-limits) di `lookup` parte da 10 richieste al minuto per credenziale, quindi controllare un'intera lista non è ciò per cui è dimensionato oggi. Contattaci per aumentare il limite se è quello che ti serve.

## Prossimi passi

- [Cercare un numero di telefono](/docs/guides/lookup/phone-numbers) copre il lookup base, ogni proprietà e cosa restituisce ciascuna.
- [Cercare un indirizzo email](/docs/guides/lookup/email-addresses) copre i verdetti e cosa fare con ognuno.
- [Riferimento API di Lookup](/docs/api/reference/create-phone-number-lookup) documenta ogni campo.
- [Idempotenza](/docs/guides/idempotency) spiega come riprovare un lookup senza pagarlo due volte.

## Related resources

- [Phone number lookup: check a number before you send](/learn/lookup/phone-number-lookup-check-a-number-before-you-send) (video)
- [Lookup](/lookup-api) (product)

[Get an implementation brief](/learn/workspace?topic=lookup)