La partitura, programmabile

Nove strumenti. Una chiave. Un addebito verificabile.

Ogni strumento Mozart ha un endpoint sincrono e un gemello in blocco. Le risposte contengono billable e charged, così il proprio registro contabile può rispecchiare il nostro riga per riga.

Ottieni la chiave API gratuita Leggi la documentazione →

Senza carta di credito · 50 crediti gratuiti

mozartemail.com / api

curl -X POST https://mozartemail.com/api/verify \
  -H "Authorization: Bearer mz_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "email": "clara.weber@deutschebank.com" }'

200 OK

{
  "ok": true, "billable": true, "charged": 0.1,
  "result": "valid",
  "reason": "smtp_rcpt_exists",
  "provider": "m365",
  "confidence": 99
}

Su un dominio catch-all

/api/verify"result": "catch_all" · un verdetto, addebito 0.1

/api/find-email"status": "not-found" · nessuna casella dimostrabile, addebito 0

L’Email finder non vende mai un’ipotesi. Quando serve il verdetto catch-all, è l’Email verifier a fornirlo.

♪ Pensata per gli agenti di codice

L’API email più adatta agli agenti AI sul mercato.

Ogni moderno strumento di sviluppo basato sull’AI parla REST puro e semplice, e Mozart non chiede altro. Una chiave, risposte tipizzate e un campo di addebito su ogni risposta: l’agente integra l’intero catalogo con un solo prompt e sa quanto è costata ogni chiamata, senza doverlo chiedere.

Agenti di codice

Claude CodeCursorOpenAI CodexGemini CLIGitHub CopilotWindsurfClineZedReplit Agent Aider

Protocolli e pipeline

MCPLangChainn8nMakeZapier

Una chiave, nove strumentiNessuna credenziale per strumento, nessuna quota API separata. Un agente che ha la chiave ha tutto il catalogo.

Risposte tipizzate e stabiliGli stessi nomi di campo in ogni strumento, valori di stato documentati e codici di errore che non cambiano forma in corsa.

Un addebito che un agente sa leggerebillable e charged viaggiano su ogni risposta, così un’esecuzione autonoma può rendere conto di sé senza dover estrarre nulla da una fattura.

Leggibile dalle macchine, di serieUn /llms.txt alla radice, una documentazione scritta sia per essere analizzata da una macchina sia per essere letta, e nessuna barriera di accesso tra un agente e il riferimento.

Il catalogo

Nove endpoint, e i loro gemelli in blocco.

ogni riga rimanda alla sua sezione nella documentazione

StrumentoSincronoIn bloccoCostoQuando si addebita

Email finder/api/find-email/api/bulk/upload1 crun indirizzo viene verificato Email verifier/api/verify/api/bulk-verify/upload0.1 crviene prodotto un verdetto Domain finder/api/find-domain/api/bulk-domain/upload0.1 crun dominio supera la soglia di affidabilità Domain scraper/api/scrape-domain/api/bulk-domain-scraper/upload1 cril dominio viene scansionato LinkedIn profile/api/linkedin-profile/api/bulk-linkedin/upload1.5 cril profilo viene trovato LinkedIn company/api/linkedin-company/api/bulk-linkedin-company/upload0.5 crla pagina viene letta LinkedIn URL finder/api/linkedin-finder/api/bulk-linkedin-finder/upload1.5 crviene consegnato un profilo Google Maps scraper/api/google-maps/search/api/scrape-google-maps/api/bulk-google-maps/upload1 crviene consegnata una scheda Reverse lookup/api/reverse-lookup/api/bulk-reverse-lookup/upload2 crviene consegnato un profilo

più un endpoint sempre gratuito: POST /api/google-maps/quote esegue la scansione vera e propria e restituisce il conteggio reale prima di qualsiasi spesa

POST …/upload→GET /api/bulk/{id}→GET …/{id}/download→DELETE /api/bulk/{id}

Un solo ciclo di vita per ogni lotto: caricare un CSV o un .xlsx, interrogare a intervalli da 5 a 10 secondi, scaricare il CSV arricchito con le colonne intatte. Eliminare un’elaborazione in corso la annulla e rimborsa tutto ciò che è stato trattenuto ma non ancora addebitato.

5 000 righe per file · 3 MB · 3 elaborazioni simultanee · risultati conservati fino all’eliminazione

Perché regge

Un’API leggibile anche da un contabile.

"billable": true, "charged": 0.1

Campi di addebito, ovunque

Ogni risposta e ogni riga del CSV dicono se è stata addebitata e quanto. Costruire il proprio registro contabile: corrisponderà al nostro, riga per riga.

saldo della chiave = saldo della dashboard

Nessuna quota separata

Non esiste un livello API né un pacchetto di richieste. La chiave spende esattamente il saldo di crediti visibile nella dashboard, tanto in modalità singola quanto in blocco.

mz_live_8f3kQ9pX···· → sha256

Chiavi, conservate come hash

Una chiave viene mostrata una sola volta e conservata come hash SHA-256. Quando una chiamata porta con sé sia una chiave sia un cookie di sessione, vince la chiave: così le chiamate dal server non si appoggiano mai a una sessione aperta nel browser.

Onestà sull’integrazione

La stranezza, messa per iscritto.

Due strumenti mettono il verdetto in ok e status: /api/find-email e /api/find-domain. Gli altri sette restituiscono HTTP 200 ogni volta che la chiamata è stata eseguita, e mettono il verdetto nel payload. Nel dubbio, decidere in base a billable: fa fede, perché corrisponde esattamente a ciò che è stato pagato. Gli errori di trasporto sono non-2xx con { ok: false, reason }, e non vengono mai addebitati.

Lo stesso paragrafo, con esempi → nella documentazione

Tempo, imposto

Limiti di frequenza, con le cifre in chiaro.

Tre soglie proteggono ogni endpoint sincrono: una di picco al secondo, una al minuto per account e una al minuto condivisa da tutti, a tutela del motore. Ogni soglia risponde 429 con un’intestazione Retry-After. Attendere i secondi indicati e riprovare.

EndpointPiccoPer accountGlobale

/api/find-email3 / s40 / min40 / min

/api/find-domain3 / s60 / min60 / min

verificatore · scraper · Reverse lookup3 / s40 / min60 / min

/api/google-maps/quote1 / 2 s8 / min24 / min

/api/google-maps/search1 / 2 s6 / min20 / min

in blocco: 3 elaborazioni simultanee per account · le chiamate di stato, elenco e download sono illimitate

♪ ELABORAZIONI AUTONOMEI lotti girano sul nostro worker e sopravvivono a un’interruzione di rete dal lato del client. Si può chiudere il portatile: l’elaborazione arriva in fondo e i risultati restano lì ad aspettare.

♪ FINALIZZAZIONE ATOMICAAl caricamento tratteniamo costo × righe, addebitiamo solo le righe che hanno prodotto un risultato e rimborsiamo la differenza nell’istante in cui l’elaborazione finisce.

♪ RIMBORSI AUTOMATICIUn’elaborazione che va in errore si rimborsa da sola. L’annullamento rimborsa tutto ciò che non è ancora stato addebitato. Un timeout del motore non era stato addebitato in partenza.

5 000 righe · Maps < 1 min · Reverse lookup ≈ 9 min · profili LinkedIn ≈ 20 min

Oltre qualche centinaio di ricerche, conviene usare la modalità in blocco invece di iterare sulle chiamate sincrone: un lotto corre più veloce di quanto consenta la soglia al minuto per account, e va avanti da solo.

Un prompt, ed è collegata

Basta darla in mano all’agente. Il resto lo fa da solo.

Non c’è nessun SDK da installare, nessun rituale OAuth, nessuna sandbox da richiedere. Il riferimento è pubblico e analizzabile da una macchina: un agente di codice lo legge, scrive la chiamata e ottiene una risposta tipizzata al primo tentativo.

E poiché i risultati non comprovati non costano nulla, un agente che itera su cinquemila righe non può erodere in silenzio il saldo con delle ipotesi.

Leggi la documentazione →/llms.txt

da incollare nel proprio agente di codice

Leggi https://mozartemail.com/llms.txt e
https://mozartemail.com/docs, poi collega l’Email finder
in questo repo. La chiave è in MOZART_API_KEY.
Non addebitare nulla che non sia comprovato.

→ legge /llms.txt e /docs

→ scrive la chiamata, tipizzata al primo tentativo

→ billable e charged su ogni risposta

Avvio rapido

Una chiave in tre battute.

1Creare un account gratuito.50 crediti all’iscrizione · senza carta

2Generare la chiave.Impostazioni → API → mz_live_… · mostrata una sola volta, revocabile in qualsiasi momento

3Fare la prima chiamata.curl -X POST https://mozartemail.com/api/verify · un verdetto in pochi secondi

Prima chiamata verificata in meno di un minuto → inizia subito

Domande degli sviluppatori

Le domande che nascono alla prima chiamata.

Come ci si autentica?−

Ogni richiesta contiene l’intestazione Authorization: Bearer mz_live_<key>. Le chiavi si generano in Impostazioni → API, una volta creato l’account. Ogni chiave viene mostrata una sola volta e conservata come hash; si può disattivare o ruotare in qualsiasi momento, e una chiave revocata restituisce 401 unauthorized. Non esiste una quota API separata: la chiave spende il saldo visibile nella dashboard.

Che cosa succede quando una chiamata fallisce?+

Gli errori di trasporto sono non-2xx con { ok: false, reason } e non vengono mai addebitati. I limiti di frequenza rispondono 429 con un’intestazione Retry-After. Un timeout del motore risponde 503: non è stato addebitato nulla, si può riprovare senza rischi. E un risultato che non riusciamo a dimostrare non è un fallimento: torna pulito, con charged: 0.

Come si segue un’elaborazione in blocco?+

Interrogare GET /api/bulk/{id} a intervalli da 5 a 10 secondi: queued, poi processing, poi done. Le chiamate di stato, elenco e download sono illimitate, i risultati parziali si scaricano dall’endpoint di download mentre l’elaborazione è in corso, e l’elaborazione va avanti anche se il client si disconnette.

Ci sono i webhook?+

No. La modalità in blocco è fatta per essere interrogata: le chiamate di stato sono gratuite e illimitate, i risultati parziali si scaricano mentre l’esecuzione è in corso e un’elaborazione conclusa resta a disposizione a tempo indeterminato. Un’interrogazione ogni 10 secondi dal proprio worker è una riga di codice, e non può perdere un evento.

Dove vengono trattati i dati?+

In Francia, sulla nostra infrastruttura. Mozart non chiama nessuna API di arricchimento di terze parti: una richiesta che ci arriva non viene mai girata a un sub-responsabile. Solo dati professionali B2B, mai rivenduti, si applica il GDPR.

Perché il Domain scraper addebita una scansione blocked?+

È l’unico strumento addebitato per il lavoro svolto e non per il risultato raccolto: ok, blocked, unreachable e timeout significano tutti che la scansione è stata eseguita, e un sito che non pubblica nessun indirizzo è una risposta a pieno titolo. Solo error, cioè una scansione che non è mai partita, è gratuito.