L’API di Apollo.io consente al tuo codice di cercare persone, arricchire record e gestire il tuo flusso di lavoro commerciale. La richiami tramite HTTPS usando una chiave API di Apollo.io. Puoi anche saltare la chiave e consentire a un client AI di accedere agli stessi dati tramite il server MCP di Apollo.io. Entrambi i metodi consumano i crediti del tuo piano e rispettano i limiti previsti dal piano.
Questa guida illustra l’API di Apollo.io dal primo clic alla prima chiamata. Mostra come creare una chiave e dove trovarla. Copre la documentazione dell’API di Apollo.io, il controllo dello stato, la ricerca di persone, l’arricchimento, i limiti di frequenza e i costi in crediti. Si conclude con il server MCP ufficiale di Apollo.io e una procedura per controllare gli indirizzi restituiti dall’API. Tutto proviene dalla documentazione ufficiale per sviluppatori disponibile su docs.apollo.io, consultata a ottobre 2026. Apollo.io segnala diverse pagine come aggiornate di recente, quindi verifica i dettagli il giorno in cui sviluppi.
Non siamo affiliati ad Apollo.io. BillionVerify è un servizio di verifica delle email. Per una panoramica più ampia della piattaforma, leggi la nostra guida ad Apollo.io.
Fatti principali (verificati a ottobre 2026):
- Ogni piano, incluso quello gratuito, offre un certo accesso all’API. Gli account gratuiti richiedono un’email aziendale per alcuni endpoint.
- L’API di Apollo.io invia la chiave nell’header
x-api-keye l’URL di base èhttps://api.apollo.io/api/v1. - Una chiave API di Apollo.io con ambito limitato consente di raggiungere solo gli endpoint selezionati. Una chiave master consente di raggiungerli tutti.
- La maggior parte degli endpoint accetta 200 chiamate al minuto su un piano a pagamento, rispetto alle 50 del piano gratuito.
- Il server MCP di Apollo.io è disponibile all’indirizzo
https://mcp.apollo.io/mcpe utilizza OAuth per l’accesso.
Cosa fa l’API di Apollo.io
Apollo.io descrive la sua API come uno strumento per cercare, arricchire, creare e gestire dati a livello programmatico. Alla base c’è un database di oltre 240 milioni di contatti e 30 milioni di aziende. La documentazione suddivide il lavoro in tre attività:
- Creare integrazioni. Collegare il proprio prodotto ai dati di Apollo.io, creare account e gestire sequenze.
- Arricchire i dati. Completare i record di persone e aziende singolarmente o in blocco.
- Trovare persone. Cercare per qualifica professionale, posizione, livello di seniority e molti altri filtri.
Il piano determina quali endpoint puoi utilizzare, la velocità con cui puoi chiamarli e il costo di ogni chiamata. Apollo.io afferma inoltre che i suoi strumenti non possono fare nulla che non sia possibile fare nell’app. Se il tuo account non dispone di una funzione, l’API non la sbloccherà.
Quali piani includono l’API?
Le FAQ per sviluppatori dichiarano che ogni piano offre l’accesso di base. Le funzioni più avanzate sono disponibili solo con determinati piani. La nostra guida ai prezzi di Apollo.io elenca i piani e i relativi crediti.
Esiste una limitazione per gli account gratuiti. Alcuni endpoint per cercare persone, arricchire dati e gestire record richiedono un account registrato con un indirizzo email di lavoro. Ogni pagina dell’endpoint interessato lo specifica. Gli account a pagamento non sono interessati.
A chi è destinata l’API di Apollo.io?
Sono soprattutto tre i gruppi che la utilizzano:
- Team Sales e RevOps che vogliono trasferire dati arricchiti in un CRM o in un data warehouse.
- Sviluppatori di aziende software che integrano i dati di Apollo.io nel proprio prodotto.
- Partner che creano integrazioni per marketplace. Accedono con OAuth 2.0 invece di una chiave.
Apollo.io aggiunge una nota sulla licenza. Condividere, esporre o rivendere i suoi dati a persone che non sono utenti di Apollo.io richiede un contratto personalizzato.
Documentazione API di Apollo.io: dove si trova tutto
La documentazione API di Apollo.io si trova su docs.apollo.io. La barra superiore è suddivisa in Inizia, API, MCP, CLI, OpenAPI e Changelog. La sezione API contiene una pagina per ogni endpoint.

Screenshot: la pagina di ricerca People API nella documentazione per sviluppatori di Apollo.io, tratta dalla guida di Apollo.io per testare una chiave.
Ogni pagina degli endpoint segue lo stesso schema. Un riquadro “Elementi essenziali dell’endpoint” in alto elenca il percorso di accesso principale, l’ambito OAuth, chi può utilizzarlo e quanti crediti costa. Seguono i parametri. A destra trovi un selettore di linguaggio, un campo per le credenziali, una richiesta cURL e una risposta di esempio.
Puoi eseguire un test direttamente dalla pagina. Incolla la tua chiave nel campo dell’header, compila i parametri obbligatori e premi Prova. Un 200 significa che la chiamata è riuscita. Anche senza una chiave, puoi aprire ogni risposta di esempio per visualizzarne lo schema.
Il file OpenAPI
Apollo.io pubblica l’intera API come un unico file OpenAPI 3 all’indirizzo https://docs.apollo.io/openapi/apollo-rest-api.json. Viene ricreato ogni volta che la documentazione cambia. Caricalo in Postman o in un altro client API e ogni endpoint arriverà con i relativi parametri. Puoi anche passarlo a un generatore di codice per creare un client tipizzato nel tuo linguaggio.
In Postman, conserva la chiave nell’autorizzazione API Key preconfigurata e imposta una variabile apiKey. La documentazione avverte che incollare la chiave come token Bearer restituisce un 401. I token Bearer sono destinati ai partner OAuth.
Un indice leggibile dalle macchine
La documentazione pubblica anche un indice in testo semplice all’indirizzo docs.apollo.io/llms.txt. Elenca ogni pagina come link Markdown. Gli strumenti di coding basati sull’AI possono leggerlo per trovare la pagina dell’endpoint corretta senza eseguire il crawling del sito.
Come ottenere una chiave API di Apollo.io
Una chiave API di Apollo.io viene creata all'interno dell'app, non sul sito della documentazione. Il percorso è Impostazioni, poi Integrazioni, quindi Chiavi API. Solo gli amministratori possono farlo, così come gli utenti il cui profilo di autorizzazioni include le chiavi.
Ecco come ottenere l'accesso alla chiave API di Apollo.io passo dopo passo:
- Apri Apollo.io e fai clic su Impostazioni > Integrazioni > Chiavi API. Il pannello per sviluppatori all'indirizzo developer.apollo.io mostra la stessa pagina.
- Fai clic su Crea nuova chiave.
- Inserisci un nome e una descrizione.
- Seleziona ogni endpoint che la chiave può chiamare oppure attiva Imposta come chiave master.
- Fai clic su Crea chiave API.
- Fai clic su Copia e incolla la chiave in un luogo sicuro.

Screenshot: la finestra di dialogo per la creazione di una nuova chiave nel portale per sviluppatori di Apollo.io, dalla documentazione di Apollo.io.
Apollo.io mostra la chiave completa alla fine. Copiala in quel momento. Se la perdi, rigenerala dal pannello.
Dove trovare una chiave API di Apollo.io esistente
Se devi trovare una chiave API di Apollo.io che hai creato in precedenza, torna al pannello per sviluppatori e apri le chiavi API. Ogni chiave che hai creato si trova in quell'elenco. La barra laterale del portale contiene anche le pagine Avvio rapido, Utilizzo e Abbonamento. La stessa barra laterale include una pagina Registrazione OAuth per i partner.
Apollo.io ti permette di fare due cose con una chiave esistente. Rigenera crea un nuovo segreto e lo copia. Elimina rimuove definitivamente la chiave. Considerale entrambe operazioni irreversibili, perché ogni script che utilizzava la vecchia chiave smette di funzionare.
Chiave master o con ambito limitato?
Questa scelta è più importante di qualsiasi altra quando crei una chiave API di Apollo.io.
| Tipo | A cosa dà accesso | Per cosa usarla |
|---|---|---|
| Chiave con ambito limitato (predefinita) | Solo agli endpoint selezionati | La maggior parte delle integrazioni |
| Chiave master | A ogni endpoint | Endpoint che la richiedono e il server MCP tramite una chiave |
Una chiave con ambito limitato che chiama un endpoint non selezionato restituisce un 403. Alcuni endpoint, come l'elenco degli utenti del workspace, funzionano solo con una chiave master. Apollo.io ti consiglia di trattare una chiave master come una password. Può eseguire qualsiasi azione API consentita dal tuo account.
Quale utente rappresenta una chiave?
Una chiave API di Apollo.io identifica il tuo workspace, non una persona. Apollo.io non può sapere quale membro del team l'ha utilizzata. Ogni richiesta agisce come l'amministratore attivo con la maggiore anzianità nel workspace, e tale utente è il proprietario di qualsiasi elemento creato dalla chiamata. Per vedere chi è, chiama l'endpoint per ottenere il profilo dell'utente corrente, che non consuma crediti.
Questo sorprende i team che creano una chiave da un accesso con autorizzazioni limitate. La chiave non restringe ciò a cui il codice può accedere.
Controllo dello stato dell'API di Apollo.io
Il modo più rapido per testare una nuova chiave è effettuare una singola chiamata di controllo. È una richiesta GET a auth/health e non consuma crediti.
curl --request GET \ --url 'https://api.apollo.io/api/v1/auth/health' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Se tutto è configurato correttamente, il controllo dello stato dell'API di Apollo.io restituisce due valori:
{ "healthy": true, "is_logged_in": true }
Quando entrambi sono true, la chiave funziona. Se uno dei due è false, cerca eventuali spazi o interruzioni di riga dopo la chiave, quindi invia nuovamente la richiesta. In Postman, imposta il tipo di autorizzazione su No Auth e aggiungi invece la chiave come intestazione.
L'API di Apollo.io è inattiva?
Chi cerca questo termine a volte desidera una risposta diversa. Vuole sapere se il servizio stesso è inattivo. La chiamata auth/health verifica la tua chiave e un accesso, non l'intera piattaforma. Per le interruzioni del servizio, Apollo.io gestisce una pagina di stato all'indirizzo status.apollo.io.
Una risposta 429 con il codice USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT significa che la piattaforma sta rifiutando il traffico a causa di un carico elevato generalizzato. Non ha nulla a che vedere con il tuo piano. La documentazione indica di attendere 60 secondi e riprovare.
Principali gruppi di endpoint nell’API di Apollo.io
Il riferimento elenca decine di endpoint. Sono suddivisi in sei gruppi.
| Gruppo | Cosa comprende | Esempi |
|---|---|---|
| Ricerca e arricchimento | Trovare persone e aziende, completare i record | Ricerca nella People API, arricchimento delle persone, ricerca di organizzazioni |
| Gestione dei record | Account, contatti, trattative, elenchi, note | Creare un contatto, aggiornare account in blocco, aggiungere record a un elenco |
| Coinvolgimento dei prospect | Sequenze, email, chiamate, attività, conversazioni | Aggiungere contatti a una sequenza, inviare subito un’email |
| Assistente AI | Affidare un’attività all’assistente integrato | Eseguire un’attività dell’assistente, verificare un’attività dell’assistente |
| Workspace | Utenti, caselle email, campi personalizzati | Ottenere un elenco di utenti, creare un campo personalizzato |
| Analisi e utilizzo | Report, statistiche di utilizzo, risultati dei webhook | Interrogare un report di analisi, visualizzare le statistiche di utilizzo |
La gestione dei record, le sequenze e la maggior parte delle chiamate al Workspace utilizzano 0 crediti. Il costo riguarda la ricerca e l’arricchimento, che trattiamo di seguito.
La ricerca non è arricchimento
Questa distinzione può confondere i nuovi utenti. La ricerca nel database di Apollo.io relativo a persone restituisce profili. I risultati non contengono email o numeri di telefono. Per ottenerli serve una seconda chiamata a un endpoint di arricchimento. La ricerca nei propri contatti salvati utilizza un insieme diverso di endpoint, con limiti differenti.
Documentazione della ricerca di persone tramite API di Apollo.io
La documentazione della ricerca di persone tramite API di Apollo.io illustra un endpoint POST: /mixed_people/api_search. Apollo.io descrive le persone come prospect nuovi che non hai ancora salvato come contatti.
curl --request POST \ --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
I parametri vengono inseriti nella stringa di query. Puoi restringere la ricerca per:
- Titoli professionali:
person_titles[], oltre aperson_not_titles[]per escluderne alcuni. - Livello di seniority:
person_seniorities[]. - Posizione:
person_locations[]per il luogo in cui vivono le persone,organization_locations[]per la sede centrale dell'azienda. - Dimensioni e fatturato dell'azienda:
organization_num_employees_ranges[]erevenue_range[min]. - Tecnologia: filtri per più di 1.500 tecnologie utilizzate da un'azienda.
- Segnali di assunzione:
q_organization_job_titles[]e numero di offerte di lavoro. - Stato dell'email:
contact_email_status[], con valori come verificata, non verificata, probabilmente coinvolta e non disponibile. - Paginazione:
pageeper_page.
L'endpoint di ricerca delle persone utilizza 0 crediti. Restituisce fino a 100 record per pagina. Ha inoltre un limite di visualizzazione di 50.000 record, ovvero 500 pagine. Aggiungi filtri per rimanere al di sotto di questo limite.
Cosa restituisce la ricerca di persone tramite API di Apollo.io
Una risposta della ricerca di persone contiene un conteggio total_entries e un elenco people. Non include email e numeri di telefono. Per ottenere i dati di contatto, passa ogni risultato all'endpoint di arricchimento.
La ricerca ha limiti propri, elencati nella sezione sui limiti di velocità qui sotto.
Se cerchi utilizzando contact_email_status[], ricorda da dove proviene il valore. Descrive il record dell'indirizzo conservato da Apollo.io. Non è un test in tempo reale della casella di posta.
Come leggere più velocemente la documentazione della ricerca di persone tramite API di Apollo.io
Inizia dal riquadro con le informazioni essenziali sull'endpoint. Controlla le righe relative all'utilizzo dei crediti e all'accesso con un account gratuito. Quindi esamina rapidamente l'elenco dei parametri per individuare i filtri necessari. Infine, esegui una richiesta ridotta con per_page=10 prima di scorrere migliaia di risultati.
Arricchisci le persone con l’API di Apollo.io
L’arricchimento aggiorna i record già in tuo possesso. Apollo.io offre due endpoint per le persone:
- Arricchimento delle persone:
POST /people/match, una persona per chiamata. - Arricchimento in blocco delle persone: fino a 10 persone in una singola richiesta.
Apollo.io ha bisogno di dettagli sufficienti per trovare la persona corretta. Un indirizzo email è sufficiente. Lo è anche un nome insieme al dominio di un’azienda. L’endpoint accetta inoltre un URL LinkedIn, il nome di un’organizzazione o un ID persona di Apollo.io. Se invii solo un nome, potresti ricevere una risposta 200 senza alcun dato arricchito.
Controlla match_confidence in ogni risposta. Può essere high, medium, low o none.
curl --request POST \ --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
La risposta contiene il ruolo della persona, la cronologia lavorativa, i dati aziendali e un email_status, come verified. Questo stato è un’etichetta propria di Apollo.io. La verifica descritta più avanti in questa guida controlla l’indirizzo stesso.
Numeri di telefono, indirizzi personali e waterfall
Tre opzioni facoltative modificano i dati restituiti:
reveal_personal_emails=trueaggiunge gli indirizzi personali. Apollo.io non li rivela per le persone nelle regioni soggette al GDPR.reveal_phone_number=trueaggiunge tutti i numeri di telefono, inclusi i cellulari. Richiede unwebhook_url. Apollo.io controlla i numeri in modo asincrono e li invia al tuo webhook; l’operazione può richiedere diversi minuti.run_waterfall_emailerun_waterfall_phoneeffettuano prima la ricerca in Apollo.io, poi nei provider di dati esterni configurati. Anche i risultati finali arrivano tramite webhook.
Evita di pagare due volte
Se arricchisci di nuovo la stessa persona in un secondo momento, potresti spendere nuovamente crediti per gli stessi dati. Apollo.io suggerisce di convertire le persone arricchite in contatti. Un contatto appartiene alla tua organizzazione, quindi i suoi dati rimangono accessibili.
Limiti di frequenza dell’API di Apollo.io
I limiti di frequenza si applicano al team, non alla chiave o al singolo utente. Si applicano anche a ogni endpoint e vengono calcolati simultaneamente su tre finestre: un minuto, un’ora e un giorno. Devi rimanere entro ogni finestra applicabile.
| Limite | Gratuito | Basic | Professional | Organization |
|---|---|---|---|---|
| Richieste al minuto | 50 | 200 | 200 | 200 |
| Richieste all’ora | 200 | 400 | 400 | 600 |
| Richieste al giorno | 600 | 2.000 | 2.000 | 6.000 |
Quella tabella rappresenta il valore predefinito. Gli endpoint di ricerca e arricchimento hanno limiti più elevati nei piani a pagamento:
- Endpoint di arricchimento: 1.000 richieste al minuto nei piani a pagamento, senza limite orario o giornaliero. Gli account gratuiti ricevono 50 richieste al minuto e 20 sugli endpoint bulk.
- Endpoint di ricerca: 200 al minuto, 6.000 all’ora e 50.000 al giorno nei piani a pagamento.
- Limiti inferiori: il report di analisi delle query consente 5 richieste all’ora.
La documentazione di Apollo.io sottolinea che l’elevato limite per l’arricchimento non autorizza a inviare chiamate illimitate. Il saldo dei crediti continua a determinare quanto puoi arricchire.

Screenshot: la pagina Usage del portale per sviluppatori di Apollo.io, con i limiti giornalieri e orari per gli endpoint di arricchimento, tratta dalla documentazione di Apollo.io.
Header di risposta ed errore 429
Apollo.io aggiunge header alle chiamate autenticate. Mostrano il limite, l’utilizzo corrente e le richieste rimanenti per ogni finestra:
x-rate-limit-minute,x-rate-limit-hourlyex-rate-limit-24-hourx-minute-usage,x-hourly-usageex-24-hour-usagex-minute-requests-left,x-hourly-requests-leftex-24-hour-requests-leftretry-after, inviato con un429, indica i secondi mancanti al ripristino della finestra
Quando superi un limite ricevi un 429. Leggi retry-after e attendi. La finestra inizia con la prima richiesta e non è legata all’orologio. Il corpo dell’errore contiene un oggetto error_details. Il suo code è USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED per il tuo limite personale.
Per leggere nel codice i limiti attuali del tuo team, chiama l’endpoint view API usage stats. Una singola chiamata può includere fino a 74 percorsi di endpoint e non consuma crediti.
Crediti API di Apollo.io: cosa costa
Molte chiamate non costano nulla. Apollo.io afferma che gli endpoint che creano, aggiornano, elencano o gestiscono record consumano 0 crediti. I crediti vengono utilizzati dagli endpoint di arricchimento, ricerca di organizzazioni, ricerca di notizie e analisi basate sull’IA, e solo quando restituiscono dati qualificanti.
| Endpoint | Costo in crediti |
|---|---|
| Arricchimento delle persone | Da 1 a 9 per persona: 1 per dati demografici o email, più 8 se viene restituito un numero di cellulare |
| Arricchimento di massa delle persone | Stessa logica, fino a 10 persone per richiesta |
| Arricchimento delle organizzazioni | 1 per organizzazione |
| Ricerca di organizzazioni | 1 per pagina, fino a 100 risultati per pagina |
| Ricerca di articoli di notizie | 1 per pagina, fino a 25 risultati per pagina |
| Offerte di lavoro delle organizzazioni | 1 per pagina |
| Recupero delle informazioni complete di una persona | 1 per persona |
| Attività dell’assistente | Variabile, determinato dalle azioni eseguite dall’assistente |
La ricerca di persone è gratuita, quindi una strategia sensata consiste nel cercare prima e arricchire solo le corrispondenze migliori. Sfogliare le pagine di un endpoint che consuma crediti utilizza crediti per ogni pagina. Apollo.io consiglia di eseguire un piccolo test e controllare l’utilizzo prima di aumentare la scala.
L’arricchimento a cascata può costare di più. In genere, la cascata email utilizza da 1 a 4 crediti, ma alcune configurazioni ne usano 20 o più. La cascata telefonica utilizza in genere da 8 a 25 crediti, ma in alcuni casi può arrivare a 45 o più.
Per monitorare la spesa, nell’app apri Impostazioni > Fatturazione e crediti > Utilizzo dei crediti. La scheda Utilizzo del pannello di controllo per sviluppatori mostra i crediti telefonici e email utilizzati nel ciclo di fatturazione corrente. I piani precedenti possono differire, quindi consulta la pagina Informazioni sui crediti relativa al tuo spazio di lavoro.
Errori e codici di stato
La maggior parte degli endpoint API di Apollo.io condivide un breve elenco di codici di stato:
| Codice | Significato | Causa comune |
|---|---|---|
401 | Non autorizzato | Chiave mancante, non valida o proveniente da un account inattivo |
403 | Vietato | Il piano non consente l'accesso API oppure una chiave con ambito limitato non include l'endpoint |
404 | Non trovato | Il record non esiste o non è visibile |
422 | Non elaborabile | Parametro non valido o mancante |
429 | Troppe richieste | Hai superato un limite di richieste |
500 | Errore del server | Un problema dal lato di Apollo.io: riprova |
Apollo.io sta unificando gli errori in un unico formato. Quando un endpoint è stato aggiornato, la risposta include un oggetto error_details con un code stabile, un message, suggestions e context. Basa la logica del codice su error_details.code, mai sul testo del messaggio. Apollo.io prevede di rimuovere i vecchi campi di errore a livello principale il 16 febbraio 2027, quindi inizia ora a utilizzare il nuovo oggetto.
Il server MCP di Apollo.io
MCP è uno standard che consente agli strumenti AI di chiamare servizi esterni. Il server MCP di Apollo.io collega Claude, ChatGPT e client simili al tuo account Apollo.io. Puoi quindi chiedere in linguaggio naturale: trova responsabili marketing di livello VP presso aziende SaaS, oppure arricchisci questi dieci prospect.

Screenshot: la pagina MCP di Apollo.io nella documentazione per sviluppatori, ottobre 2026.
Tre modi per connettersi
| Percorso | Come funziona |
|---|---|
| Connettori AI | Integrazioni integrate in ChatGPT, Claude, Perplexity, Replit e Cursor. Nessuna configurazione del server. |
| Plug-in di programmazione | Plug-in proprietari per strumenti come Codex. |
| Server MCP autonomo | Indica a qualsiasi client MCP che supporti server remoti un singolo URL. |
Le impostazioni autonome sono brevi:
| Impostazione | Valore |
|---|---|
| Endpoint | https://mcp.apollo.io/mcp |
| Trasporto | HTTP trasmissibile |
| Accesso | OAuth 2.0 |
| Installazione locale | Non necessaria |
| API key | Non necessaria, a meno che il client non disponga di un browser |
In Claude Code, un comando aggiunge il server. Eseguilo, poi digita /mcp e completa l'accesso OAuth:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Se gestisci diversi workspace, aggiungi lo stesso URL con un nome diverso per ciascuno. Accedi separatamente a ogni connessione.
Server senza browser
OAuth richiede una finestra del browser. Un cron job o una pipeline CI non ne hanno una. Per questi casi, il server accetta una API key inviata come X-Api-Key. La chiave deve essere una chiave principale. Una chiave con ambito limitato restituisce un 403 con il codice API_INACCESSIBLE, perché il server MCP non è uno degli endpoint selezionabili.
Conserva questa chiave come qualsiasi secret di produzione. Agisce come amministratore del workspace e utilizza i crediti del workspace. I nuovi strumenti MCP raggiungono immediatamente una chiave principale, ma il client potrebbe mantenere un elenco degli strumenti nella cache. Riconnettiti e chiama tools/list per aggiornarlo.
Cosa può fare il server MCP di Apollo.io
L'elenco degli strumenti comprende ricerca e prospecting, arricchimento di persone e aziende, contatti, elenchi, sequenze, email singole, attività, controlli dei domini email e analisi. Le azioni di arricchimento utilizzano crediti. La maggior parte delle altre azioni non ne utilizza. Apollo.io avverte che la ricerca di persone non restituisce email o numeri di telefono, quindi il tuo assistente deve eseguire un passaggio di arricchimento per ottenerli.
Limiti pratici indicati nella documentazione:
- Non sono previsti costi aggiuntivi per la connessione. Si applicano il tuo piano, le tue autorizzazioni e i tuoi crediti.
- Le azioni distruttive, come l'eliminazione in blocco, non sono supportate.
- Il server rispetta le tue autorizzazioni. Con OAuth agisce come l'utente che ha effettuato l'accesso.
- Apollo.io MCP utilizza limiti di velocità separati e non restituisce gli header dei limiti di velocità.
- Apollo.io vieta l'addestramento dei modelli AI sui propri dati MCP, quindi disattiva prima l'addestramento nel tuo client AI.
Apollo.io consiglia di impostare le azioni che consumano crediti su “Approvazione richiesta”, così un assistente troppo loquace non può esaurire autonomamente i crediti.
Altri modi per utilizzare l’API di Apollo.io
- CLI di Apollo.io. Uno strumento da riga di comando con accesso all’API completa. Installalo con Homebrew, tramite un binario precompilato o dal codice sorgente. Utilizza OAuth, quindi non richiede alcuna chiave.
- OAuth 2.0. I partner lo utilizzano per chiamare l’API per i clienti comuni e la documentazione elenca un’applicazione marketplace per le integrazioni completate.
- Estensione Chrome. Se preferisci fare clic invece di scrivere codice, consulta la nostra guida all’estensione Chrome di Apollo.
Controlla gli indirizzi dall'API di Apollo.io prima di inviare
Qualunque percorso tu scelga, i dati hanno un punto debole. Provengono da un database. Le persone cambiano lavoro e le aziende si spostano su nuovi domini. Il campo email_status è un'etichetta propria di Apollo.io, non un test recente. Un'email a freddo inviata a un indirizzo inesistente torna indietro, e i bounce danneggiano la reputazione del mittente.
Inserisci quindi un controllo tra l'arricchimento e la tua sequenza. BillionVerify testa ogni indirizzo senza inviare messaggi. Controlla la sintassi, il dominio, i record MX e, quando lo richiedi, la casella tramite SMTP. Segnala gli indirizzi usa e getta e quelli di ruolo. Indica il catch-all come risultato distinto invece di considerarlo valido. I risultati sconosciuti non costano nulla e un nuovo controllo entro 24 ore è gratuito. Prima di collegare l'API, puoi verificare manualmente se un indirizzo email esiste usando il verificatore web gratuito.

BillionVerify restituisce uno stato, un indicatore di recapitabilità e un motivo per ogni indirizzo.
Una piccola pipeline
Una pipeline semplice prevede quattro passaggi:
- Esegui una ricerca gratuita di persone tramite l'API.
- Arricchisci solo le corrispondenze migliori.
- Invia ogni indirizzo all'API REST di BillionVerify.
- Aggiungi alla tua sequenza solo gli indirizzi recapitabili.
La chiamata a BillionVerify è un singolo POST. Invia la chiave nell'header BV-API-KEY e imposta check_smtp su true per un test live della casella:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"mark@sumware.com","check_smtp":true}'
La risposta contiene status, is_deliverable, is_catchall, is_role, is_disposable e un reason. Per un massimo di 50 indirizzi in un'unica chiamata, usa il percorso bulk. Per un'intera esportazione, carica un file CSV, TXT o XLSX e scarica i risultati in seguito. Il riferimento completo si trova nella documentazione di BillionVerify.
Verifica dal client AI
Se hai già collegato la configurazione MCP di Apollo.io a un client AI, aggiungi il server MCP ospitato da BillionVerify accanto a essa. Si trova all'indirizzo https://mcp.billionverify.com/mcp e usa OAuth per l'accesso. Il tuo assistente potrà quindi arricchire un prospect tramite Apollo.io e controllare l'indirizzo nella stessa conversazione. Indicagli la tua policy, ad esempio quali stati accettare e come gestire il catch-all.
Altri controlli
- La nostra pagina sulla verifica delle email di Apollo illustra il flusso di esportazione.
- Un contatto sospetto può essere sottoposto alla nostra ricerca inversa gratuita delle email, che mostra ciò che è pubblicamente associato a un indirizzo.
- Anche i numeri di telefono restituiti tramite webhook meritano un controllo. Il nostro validatore gratuito dei numeri di telefono mostra se un numero è valido per il suo Paese e a quale tipo di linea appartiene.
BillionVerify offre 20 crediti gratuiti ogni giorno in cui utilizzi il tuo account, fino a 600 al mese. Non scadono mai e non è necessaria alcuna carta di credito.
Consigli per creare integrazioni con l’API di Apollo.io
- Inizia con una chiave con ambito limitato per ogni integrazione. Se una viene divulgata, revochi solo quella.
- Esegui prima il controllo dello stato. Esclude i problemi della chiave prima di eseguire il debug del codice.
- Leggi il riquadro degli aspetti essenziali dell’endpoint. La documentazione sulla ricerca di persone dell’API di Apollo.io mostra subito il costo in crediti.
- Cerca prima di arricchire. La ricerca è gratuita, mentre l’arricchimento non lo è.
- Esegui i test con
per_page=10. Le esecuzioni ridotte mostrano i costi in crediti prima che diventino onerosi. - Rispetta
retry-after. Insistere su un endpoint limitato prolunga soltanto l’attesa. - Leggi
error_details.code. Il testo del messaggio può cambiare senza preavviso. - Verifica prima di inviare. Un credito speso per un indirizzo che rimbalza è sprecato due volte.
Domande frequenti
Apollo.io ha un’API?
Sì, Apollo.io dispone di un’API REST. Ti consente di cercare persone e aziende, arricchire i contatti e aggiornare account, trattative e sequenze. L’accesso di base è incluso in ogni piano. Il tuo piano stabilisce quali endpoint puoi chiamare, con quale velocità e quanto costa ogni chiamata.
Come posso ottenere una chiave API di Apollo.io?
Una chiave Apollo.io si ottiene dalla sezione Integrazioni delle Impostazioni: apri API Keys e seleziona Create new key. Assegnale un nome, seleziona gli endpoint che può chiamare e conferma, quindi copia subito il segreto. Può farlo un amministratore o un utente con il profilo di autorizzazioni appropriato.
Dove posso trovare la mia chiave API di Apollo.io?
L’elenco delle chiavi API di Apollo.io si trova nella pagina API Keys, raggiungibile dall’app o dalla dashboard per sviluppatori. Il segreto completo viene mostrato quando crei la chiave. Se perdi il segreto, devi rigenerare la chiave, ottenendone una nuova.
L’API di Apollo.io è gratuita?
Le chiamate all’API di Apollo.io che creano, elencano o aggiornano record non hanno costi, così come la ricerca di persone. L’arricchimento e alcuni endpoint di ricerca consumano crediti quando restituiscono dati. Gli account gratuiti possono chiamare l’API entro i limiti del piano gratuito, ma alcuni endpoint richiedono un’email di lavoro.
Qual è il limite di frequenza dell’API di Apollo.io?
Con un piano a pagamento, la maggior parte degli endpoint API di Apollo.io accetta 200 chiamate al minuto, con limiti orari e giornalieri variabili in base al piano. Il piano gratuito accetta 50 chiamate al minuto, 200 all’ora e 600 al giorno. I limiti si applicano per team e per endpoint; una risposta 429 significa che ne hai superato uno.
Come posso testare l’health check dell’API di Apollo.io?
L’health check di Apollo.io consiste in una richiesta GET al percorso auth/health, con l’header della chiave impostato. Una risposta con healthy: true e is_logged_in: true significa che la chiave funziona. Non vengono consumati crediti.
La ricerca di persone dell’API di Apollo.io restituisce email?
No, l’endpoint di ricerca di persone di Apollo.io restituisce solo i profili, senza email o numeri di telefono. Esegui l’endpoint di arricchimento delle persone o di arricchimento in blocco delle persone sui risultati per ottenere i dati di contatto, con consumo di crediti.
Dove si trova la documentazione dell’API di Apollo.io?
La documentazione dell’API di Apollo.io si trova su docs.apollo.io. Ogni endpoint ha una pagina dedicata con parametri, un pannello di test e una risposta di esempio. Puoi anche scaricare il file OpenAPI e importarlo in Postman.
Cos’è il server MCP di Apollo.io?
Il server MCP di Apollo.io collega i client AI al tuo workspace tramite il Model Context Protocol. Il suo URL è https://mcp.apollo.io/mcp, utilizza Streamable HTTP e OAuth e non richiede installazioni locali. Continuano ad applicarsi il tuo piano, le autorizzazioni e i crediti.
Qual è il miglior server MCP per Apollo.io?
Apollo.io pubblica un unico server MCP ufficiale, descritto nella relativa documentazione. Non abbiamo testato opzioni di terze parti. Scegli il server ufficiale se vuoi le stesse autorizzazioni e regole sui crediti dell’app.
Devo verificare le email provenienti dall’API di Apollo.io?
Sì, controlla ogni indirizzo email proveniente dall’API di Apollo.io prima di una campagna. Il campo email_status riflette i record interni di Apollo.io, mentre le persone cambiano lavoro. Un rapido controllo tramite l’API di BillionVerify rimuove gli indirizzi non validi e protegge la reputazione del mittente.
Guarda il video: Come validare un numero di telefono: validatore gratuito
Guarda il video: Come verificare le email di Apollo prima di inviare
