API di verifica email che risolve anche gli indirizzi catch-all
Controlla se una casella esiste con una sola chiamata REST. Sui domini catch-all, dove la maggior parte delle API si ferma a "accept-all" o "a rischio", ricevi un risultato valido o non valido nella stessa risposta. La nostra API di verifica email dà ai team di sviluppo dati JSON puliti per proteggere la reputazione del mittente in tutti i flussi di outreach.
curl -X POST https://api.giggal.ai/v1/verify \
-H "Authorization: Bearer tp_live_xxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"email":"alex.smith@example.com"}'1.000 crediti gratuiti, senza carta. I crediti non scadono mai.
Giggal.ai è stato nominato Leader su SourceForge e Slashdot
Cosa restituisce una chiamata API
Una sola chiamata restituisce tutti i dati di consegna. Ricevi lo stato di consegna principale, la valutazione del rischio, un punteggio numerico di consegna, gli attributi della casella e i risultati catch-all nella stessa risposta.
{
"success": true,
"data": {
"email": "alex.smith@example.com",
"is_valid": true,
"status": "deliverable",
"risk_level": "low",
"deliverability_score": 92,
"catch_all_score": 89,
"catch_all_verdict": "valid",
"details": {
"general": {
"domain": "example.com",
"reason": "Mailbox confirmed deliverable"
},
"attributes": {
"free_email": false,
"role_account": false,
"disposable": false,
"catch_all": true,
"has_plus_tag": false,
"mailbox_full": false,
"no_reply": false
},
"mail_server": {
"smtp_provider": "google",
"mx_record": "aspmx.l.google.com"
}
}
},
"meta": {
"creditsUsed": 1
}
}Come gestire i valori di stato della risposta
Lo stato di consegna principale arriva nel campo status. Ecco come la tua applicazione backend deve interpretare e instradare ogni valore:
| Stato | Significato | Azione consigliata |
|---|---|---|
| deliverable | Il server di posta di destinazione ha accettato il destinatario durante la connessione. La casella è attiva. | Puoi inviare. Includi l'indirizzo nelle principali campagne di outreach. |
| undeliverable | La casella non esiste, la sintassi non è valida, il dominio non ha record MX oppure il dominio è usa e getta. | Non inviare. Rimuovi l'indirizzo dalle campagne per evitare hard bounce. |
| unknown | Risposta del server non conclusiva, di solito per greylisting o per timeout della connessione. | Ricontrolla più tardi. I crediti usati per le risposte sconosciute vengono rimborsati in automatico. |
Indirizzi catch-all risolti nella stessa chiamata
I controlli standard falliscono sui domini catch-all. Quando il server di posta di un'azienda accetta ogni indirizzo in arrivo, gli strumenti standard ricevono una risposta positiva sia per le caselle reali sia per gli errori di battitura. Non potendo verificare oltre, la maggior parte segna l'indirizzo come "a rischio" o "accept-all" e lascia a te la decisione.
Circa il 30% di una tipica lista B2B si trova su domini catch-all o su domini dietro gateway di sicurezza (SEG) come Proofpoint e Mimecast. Eliminarli significa perdere acquirenti reali. Inviare senza verifica causa picchi di bounce.
Il nostro motore di verifica esegue la risoluzione approfondita dei catch-all nella stessa chiamata. Controlla se la casella esiste e restituisce catch_all_verdict ("valid" o "invalid") e catch_all_score da 0 a 100. Approfondisci nelle nostre guide sulla verifica catch-all e sul controllo delle caselle dietro i gateway di sicurezza.
API di verifica tradizionale
Si arrende sui domini accept-all
{
"email": "sarah.connor@cyberdyne.com",
"status": "risky",
"reason": "accept_all_domain",
"is_deliverable": null,
"action": "manual_review_required"
}Il dubbio passa al tuo team. Invii e rischi molti bounce, oppure scarti potenziali acquirenti validi.
API di Giggal.ai
Risolve i catch-all nella stessa chiamata
{
"email": "sarah.connor@cyberdyne.com",
"status": "deliverable",
"is_valid": true,
"catch_all_verdict": "valid",
"catch_all_score": 94,
"details": { "catch_all": true }
}Casella attiva confermata. Tieni i tuoi contatti catch-all reali e proteggi la reputazione del mittente.
Endpoint per controlli singoli, in blocco e catch-all
Che tu debba controllare un solo contatto o verificare liste grandi, la nostra API per verificare le email ha endpoint pensati per prestazioni e affidabilità.
Verifica di una singola email
Verifica sincrona di un singolo indirizzo email. Controlla se l'indirizzo esiste, esegue la diagnostica del dominio e risolve gli indirizzi catch-all nella stessa chiamata. Restituisce un risultato JSON completo.
Vedi la documentazione dell'endpointVerifica email in blocco
Elaborazione asincrona fino a 50.000 indirizzi per job. Rimuove sul server i duplicati e la sintassi non valida. Supporta l'header Idempotency-Key per evitare doppi addebiti.
Polling del job e risultati
Controlla l'avanzamento del job con GET /v1/jobs/:jobId ogni 10-15 secondi. Recupera i risultati paginati fino a 500 record per pagina. I risultati restano salvati in modo sicuro per 48 ore.
Risoluzione catch-all in blocco
Esegui la risoluzione approfondita dei catch-all sugli indirizzi segnalati come catch-all in un job in blocco completato. Scarica i risultati in un CSV pulito con colonne di punteggio e stato.
Vedi la documentazione catch-allIndicatori in ogni risposta
Oltre a valida o non valida, ogni risposta include attributi dettagliati della casella per segmentare i contatti, prevenire gli abusi e applicare regole di filtro automatiche.
| Indicatore | Percorso del campo | Descrizione e uso |
|---|---|---|
| Usa e getta | details.attributes.disposable | Identifica le caselle temporanee usa e getta. Bloccale subito per fermare gli abusi delle prove gratuite. |
| Account di ruolo | details.attributes.role_account | Rileva le caselle generiche di reparto (info@, billing@, support@). Inviale ai team CRM. |
| Email gratuita | details.attributes.free_email | Segnala i domini webmail per privati (gmail.com, yahoo.com) per separare le caselle personali dai contatti aziendali. |
| Catch-all | details.attributes.catch_all | Indica se il server accetta tutta la posta. Usalo con catch_all_verdict per recuperare i contatti validi. |
| Alias con il più | details.attributes.has_plus_tag | Rileva gli indirizzi che usano alias con il segno più (user+tag@). Impedisce la creazione di più account da parte della stessa persona. |
| Casella piena | details.attributes.mailbox_full | Indica che la quota di spazio è stata superata. La posta inviata qui genererà un soft bounce. |
| No-reply | details.attributes.no_reply | Segnala gli indirizzi di invio massivo che nessuno legge. Non inviare qui messaggi di outreach che chiedono una risposta. |
| Controllo blacklist | details.blacklist.is_blacklisted | Valuta il dominio e gli IP del server nelle principali liste DNSBL, con punteggi di reputazione. |
Dove i team usano l'API di verifica email
I nostri endpoint si collegano direttamente a pipeline di dati, flussi CRM e database.
Sincronizzazione con CRM e data warehouse
Verifica i dati dei contatti in modo continuo prima di sincronizzarli con Salesforce, HubSpot o Snowflake. Pulisci i record vecchi a intervalli programmati e tieni corretti i dati dei contatti.
Pulizia delle liste per le campagne
Pulisci le liste email prima dei grandi invii di outreach. Puoi anche caricare le liste direttamente nella nostra interfaccia di pulizia lista email per un lavoro manuale rapido.
Pipeline di arricchimento dei lead
Avvia controlli automatici della casella ogni volta che i tuoi strumenti per SDR inbound o di arricchimento outbound trovano nuove email aziendali, così i commerciali contattano solo indirizzi verificati.
Automazione dei flussi di lavoro
Collega i nostri endpoint di verifica direttamente a flussi Zapier, n8n, Make e webhook tramite la nostra pagina delle integrazioni.
Agenti AI tramite MCP
Permetti a Claude, ChatGPT, Cursor e ai tuoi agenti AI di verificare i contatti durante le conversazioni con il nostro server MCP.
Validazione dei moduli di iscrizione
Vuoi controllare gli indirizzi mentre gli utenti li scrivono nei moduli di iscrizione e di raccolta lead? Scopri la nostra API di validazione email, pensata per i controlli in tempo reale nei moduli.
Esempi di codice
Snippet lato server per controlli singoli e in blocco. Tieni la tua chiave API nelle variabili d'ambiente.
// Node.js (Node 18+)
const res = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: 'alex.smith@example.com' }),
});
const data = await res.json();
if (data.success) {
console.log('Status:', data.data.status); // deliverable, undeliverable, unknown
console.log('Catch-all result:', data.data.catch_all_verdict); // valid | invalid
} else {
console.error('Verification error:', data.error);
}import os
import requests
url = "https://api.giggal.ai/v1/verify"
headers = {
"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}",
"Content-Type": "application/json"
}
payload = {"email": "alex.smith@example.com"}
response = requests.post(url, json=payload, headers=headers)
result = response.json()
if result.get("success"):
data = result["data"]
print("Status:", data["status"])
print("Catch-All Result:", data.get("catch_all_verdict"))
else:
print("Error:", result.get("error"))Flusso in blocco: invia, controlla e scarica i risultati
Per inviare un job batch basta una chiamata. Controlla ogni 10-15 secondi finché lo stato del job diventa completed.
// 1. Submit batch job (up to 50,000 emails)
const submitRes = await fetch('https://api.giggal.ai/v1/verify-batch', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
'Idempotency-Key': 'batch-job-2026-10-01-01',
},
body: JSON.stringify({
name: 'Q4 Sales Leads',
emails: ['alex.smith@example.com', 'maria.garcia@example.org'],
}),
});
const { data: job } = await submitRes.json();
const jobId = job.jobId;
// 2. Poll job status until completed
// GET https://api.giggal.ai/v1/jobs/${jobId}
// 3. Fetch paginated verification results
const resultsRes = await fetch(`https://api.giggal.ai/v1/jobs/${jobId}/results?page=1&limit=500`, {
headers: { 'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}` },
});
const results = await resultsRes.json();Prezzi dell'API di verifica email
Prezzi semplici a consumo, senza vincoli mensili. Un credito verifica un indirizzo. Nei controlli API singoli la risoluzione catch-all è inclusa nello stesso credito. Nei job batch in blocco la verifica standard costa 1 credito per indirizzo, e la verifica approfondita delle righe catch-all costa 1 credito per ogni indirizzo catch-all controllato. I crediti non scadono mai e i risultati sconosciuti vengono rimborsati in automatico.
Ti serve un volume più alto per la tua azienda? Vedi tutte le nostre fasce di prezzo.
Limiti di richiesta ed errori
Per ogni chiave API valgono limiti di richiesta standard. Lo stato del limite viene restituito in tutte le richieste tramite header standard:X-RateLimit-Limit eX-RateLimit-Remaining.
Limiti per finestra di 15 minuti
- Controlli singoli (/v1/verify)300 richieste / 15 min
- Creazione di job batch30 richieste / 15 min
- Creazione di job catch-all30 richieste / 15 min
- Polling dei job e risultati600 richieste / 15 min
Codici di errore HTTP
- 400 Bad Request: Sintassi non valida o corpo JSON malformato.
- 401 Unauthorized: Chiave API mancante, scaduta o non valida.
- 402 Payment Required: Saldo crediti dell'account insufficiente.
- 404 Not Found: L'ID del job richiesto non esiste.
- 409 Conflict: Conflitto sulla chiave di idempotenza.
- 410 Gone: I risultati del job batch sono scaduti dopo 48 ore.
- 429 Too Many Requests: Limite di richieste superato.
I formati dettagliati delle risposte di errore e le descrizioni dei payload sono nella documentazione degli errori API.
Cosa dicono i clienti
Opinioni reali dei team di sviluppo, vendite e growth che usano Giggal.ai.
"Before Giggal, our team spent hours manually reviewing catch-all addresses because other tools couldn't verify them with confidence. Now we upload large email lists, verify them in minutes, and move directly into campaign preparation."
Vernon L.
Recensione verificata su G2
"Fast and accurate email verification, excellent catch-all detection, easy-to-use interface, quick processing for large lists, lower bounce rates, improved sender reputation, and more confidence before launching email campaigns."
Billy W.
Recensione su SourceForge
"Giggal Email Verifier makes email validation fast, simple, and reliable. It helps us clean our lists, reduce bounce rates, and improve the overall performance of our outreach campaigns. The accuracy of the verification results makes it a valuable tool."
Hazel Peterson
Recensione su Product Hunt
Domande frequenti sull'API di verifica email
Domande tecniche comuni su autenticazione, controllo delle caselle e gestione dei catch-all.
Sì. Ogni nuovo account riceve subito 1.000 crediti gratuiti alla registrazione, senza carta di credito. Puoi generare una chiave API nella dashboard sviluppatore e iniziare subito a inviare richieste di verifica. I crediti gratuiti non scadono mai e danno accesso completo a tutti gli endpoint, compresi il controllo completo della casella e la risoluzione approfondita dei catch-all.
L'API controlla se la casella esiste. Esegue lookup DNS e MX, si collega al server di posta di destinazione e controlla se quella casella esiste e può ricevere posta. La connessione viene chiusa in modo pulito prima che venga trasmesso qualsiasi messaggio, quindi il destinatario non riceve mai un'email.
Sui domini catch-all un server di posta standard dichiara accettabile ogni indirizzo, e per questo gli strumenti comuni restituiscono "a rischio" o "sconosciuta". Giggal controlla se la casella esiste e restituisce un risultato valido o non valido con un catch_all_score da 0 a 100, così non scarti contatti reali.
Lo stato "sconosciuta" compare quando il server di posta di destinazione non dà una risposta chiara entro il nostro tempo limite, di solito per un greylisting aggressivo o per interruzioni temporanee del server. Non paghi mai le risposte non conclusive: i crediti usati per qualsiasi verifica con stato sconosciuto tornano in automatico sul saldo del tuo account.
Le richieste di verifica singola controllano un'email per chiamata, in modo sincrono e con una risposta JSON diretta. Per le liste, il nostro endpoint in blocco accetta fino a 50.000 indirizzi email per job, in modo asincrono. Puoi seguire l'avanzamento con il polling del job e recuperare i risultati paginati quando l'elaborazione è finita.
Sì. Giggal.ai gestisce un server MCP (Model Context Protocol) remoto ufficiale su https://mcp.giggal.ai/mcp. Claude e ChatGPT si collegano al server tramite OAuth, senza chiave API. Per i flussi di sviluppo locali in Cursor, VS Code e altri client, puoi configurare il server locale giggal-mcp con la tua chiave API e verificare gli indirizzi direttamente dal tuo editor.
Un'API di verifica email controlla se una casella esiste davvero: comunica direttamente con i server di posta di destinazione, controlla i record DNS e risolve gli indirizzi catch-all in liste commerciali e database di clienti. Un'API di validazione email si concentra sui controlli in tempo reale nei moduli di iscrizione: verifica il formato, riconosce i domini usa e getta e blocca gli account falsi all'invio del modulo. Se devi proteggere dei moduli, scopri la nostra API di validazione email.
Cerca tre cose: una vera risoluzione dei catch-all, per non perdere fino al 30% dei tuoi contatti B2B nel gruppo "a rischio"; regole di addebito chiare, con rimborso automatico dei risultati sconosciuti; e un prezzo chiaro per verifica, senza costi ricorrenti nascosti né minimi mensili.
Inizia a verificare le email in pochi minuti
1.000 crediti gratis, nessuna carta richiesta.
