Skip to main content
Enrow utilizza un sistema basato su crediti e i crediti vengono consumati quando viene trovato un risultato o viene eseguito un controllo. Questa pagina spiega come vengono addebitati i crediti per ogni endpoint, come controllare il tuo saldo, come gestire le impostazioni di fatturazione e cosa succede quando i crediti si esauriscono.

​
Come funzionano i crediti?

I crediti vengono consumati solo quando l’API restituisce un risultato o completa un controllo: le ricerche fallite che non trovano nulla non costano crediti, con due eccezioni per l’Email Finder (vedi sotto). Ogni funzionalità consuma crediti a una tariffa diversa:
I crediti vengono addebitati allo stesso modo per le operazioni singole e in blocco: per singolo risultato. Eseguire una ricerca email in blocco di 1.000 nomi costa, per email trovata, quanto 1.000 ricerche singole.
Due eccezioni per l’Email Finder: un account il cui tasso di successo resta anormalmente basso paga, dopo un avviso, 0,25 crediti per ricerca senza risultato, e una ricerca a partire dall’URL di un profilo LinkedIn costa 0,25 crediti se non viene trovata alcuna email. Vedi le FAQ qui sotto.
Ogni richiesta che consuma crediti restituisce un campo credits_used nella sua risposta, così puoi monitorare il consumo per ogni ricerca. Vedi Trova email per un esempio di risposta.

​
Come controllo il mio saldo di crediti?

Interroga l’endpoint dell’account con la tua chiave API nell’header x-api-key per recuperare il tuo saldo di crediti attuale. Non è necessario alcun payload nel corpo: l’account viene identificato dalla chiave API.
Response
La risposta contiene il tuo saldo e i webhook registrati: Per il riferimento completo dell’endpoint, vedi Informazioni account. Puoi anche visitare la tua Dashboard per visualizzare i dettagli di utilizzo e fatturazione, oppure consultare la guida Autenticazione per scoprire come funziona l’header x-api-key su ogni endpoint.

​
Come gestisco le impostazioni di fatturazione?

Sui piani a pagamento, Billing → Settings nell’app offre due impostazioni che mantengono il tuo account rifornito di crediti e ti avvisano prima che si esauriscano:
Ricarica automaticamente il tuo saldo non appena scende sotto la soglia che imposti in Credit threshold (almeno 100 crediti). Scegli una delle due modalità:
  • Early renewal: il tuo piano si rinnova subito e inizia un nuovo ciclo con i suoi crediti. Disponibile solo con un abbonamento attivo.
  • Pay-as-you-go top-up: viene acquistato un pacchetto di crediti pay-as-you-go, nella quantità che scegli in Top-up volume.
Se il tuo saldo è già sotto la soglia quando salvi, la ricarica avviene subito.
Invia un’email all’indirizzo che scegli quando il tuo saldo scende sotto un determinato valore. Puoi anche pubblicare questo avviso in un canale Slack o Discord.

​
Cosa succede quando i crediti si esauriscono?

Quando il saldo dei tuoi crediti raggiunge lo zero, le richieste API restituiscono uno stato HTTP 402. Gli endpoint singoli (trova email/telefono singolo, verifica singola) restituiscono:
Gli endpoint in blocco restituiscono invece { "message": "..." }. Per l’elenco completo dei codici di stato e delle forme delle risposte, vedi Codici di stato e Gestione degli errori.
Per evitare interruzioni, attiva Balance protection o un Credit Alert in Billing → Settings.

​
Quale piano dovrei scegliere?

Visita enrow.io/pricing per confrontare i piani e trovare quello più adatto alle tue esigenze. I crediti pay-as-you-go possono essere aggiunti a qualsiasi piano, manualmente o in automatico con Balance protection.

​
FAQ

No. I crediti vengono consumati solo quando viene trovata un’email o un numero di telefono, oppure quando viene eseguito un controllo di verifica. Una ricerca che non restituisce alcun risultato non costa crediti. Un’eccezione, prevista dalla clausola 8.6 dei nostri termini di servizio: se meno del 12% delle ricerche Email Finder di un account trova un’email, su almeno 10.000 ricerche in 7 giorni, avvisiamo l’account via email. Se il tasso è ancora così basso 7 giorni dopo, ogni ricerca Email Finder senza risultato costa 0,25 crediti finché non risale. Un’altra eccezione: una ricerca Email Finder a partire dall’URL di un profilo LinkedIn costa 0,25 crediti se non viene trovata alcuna email. I fallimenti dovuti a un incidente da parte nostra non vengono mai addebitati.
No. I crediti vengono addebitati per singolo risultato, quindi un’operazione in blocco costa, per email, telefono o verifica trovata, quanto le richieste singole equivalenti. Gli endpoint in blocco fanno risparmiare sulle richieste, non sui crediti.
L’Email Verifier consuma 0,25 crediti per controllo. L’Email Finder consuma 1 credito per email trovata e il Phone Finder consuma 40 crediti per telefono trovato (50 con i piani legacy).
Le richieste restituiscono uno stato HTTP 402. Gli endpoint singoli restituiscono { "reason": "Insufficient credits", "success": false }, mentre gli endpoint in blocco restituiscono { "message": "..." }. Vedi Gestione degli errori per i dettagli.

​
Passaggi successivi

Autenticazione

Come passare la tua chiave API nell’header x-api-key.

Informazioni account

Recupera il tuo saldo di crediti e i webhook registrati.

Limiti di frequenza

Comprendi i limiti delle richieste API prima di scalare.

Gestione degli errori

Gestisci con eleganza il 402 e le altre risposte di errore.