A API do Apollo.io permite que o seu próprio código pesquise pessoas, enriqueça registros e gerencie o seu fluxo de vendas. Você a acessa por HTTPS usando uma chave de API do Apollo.io. Também pode ignorar a chave e permitir que um cliente de IA acesse os mesmos dados por meio do servidor MCP do Apollo.io. Ambas as opções consomem os créditos do seu plano e seguem os limites do seu plano.
Este guia apresenta a API do Apollo.io desde o primeiro clique até a primeira chamada. Ele mostra como criar uma chave e onde encontrá-la. Abrange a documentação da API do Apollo.io, a verificação de integridade, a pesquisa de pessoas, o enriquecimento, os limites de solicitações e os custos em créditos. Ele termina com o servidor MCP oficial do Apollo.io e uma rotina para verificar os endereços retornados pela API. Tudo vem da documentação oficial para desenvolvedores em docs.apollo.io, consultada em outubro de 2026. O Apollo.io marca várias páginas como atualizadas recentemente, portanto confirme os detalhes no dia em que for criar sua integração.
Não somos afiliados ao Apollo.io. BillionVerify é um serviço de verificação de e-mails. Para uma visão mais ampla da plataforma, leia nosso guia do Apollo.io.
Principais fatos (verificados em outubro de 2026):
- Todos os níveis, inclusive o gratuito, oferecem algum acesso à API. Contas gratuitas precisam de um e-mail profissional para determinados endpoints.
- A API do Apollo.io envia a chave no cabeçalho
x-api-key, e a URL base éhttps://api.apollo.io/api/v1. - Uma chave de API do Apollo.io com escopo acessa apenas os endpoints selecionados. Uma chave mestra acessa todos eles.
- A maioria dos endpoints aceita 200 chamadas por minuto em um nível pago, contra 50 no nível gratuito.
- O servidor MCP do Apollo.io está em
https://mcp.apollo.io/mcpe faz login usando OAuth.
O que a API da Apollo.io faz
A Apollo.io descreve sua API como uma forma de pesquisar, enriquecer, criar e gerenciar dados programaticamente. Por trás dela, há um banco de dados com mais de 240 milhões de contatos e 30 milhões de empresas. A documentação divide o trabalho em três funções:
- Criar integrações. Conecte seu produto aos dados da Apollo.io, crie contas e gerencie sequências.
- Enriquecer dados. Preencha registros de pessoas e empresas individualmente ou em massa.
- Encontrar pessoas. Pesquise por cargo, localização, senioridade e muitos outros filtros.
Seu plano determina quais endpoints você pode usar, com que rapidez pode fazer chamadas e quanto cada chamada custa. A Apollo.io também afirma que suas ferramentas não podem fazer nada que você não pudesse fazer no aplicativo. Se sua conta não tiver um recurso, a API não o desbloqueará.
Quais planos incluem a API?
A FAQ para desenvolvedores informa que todos os níveis têm acesso básico. Funções mais avançadas estão disponíveis apenas em determinados níveis. Nosso guia de preços da Apollo.io lista os níveis e seus conjuntos de créditos.
Há uma ressalva para contas gratuitas. Alguns endpoints de pesquisa de pessoas, enriquecimento e registros exigem uma conta registrada com um endereço de e-mail profissional. Cada página do endpoint afetado informa isso. As contas pagas não são afetadas.
Para quem é a API da Apollo.io?
Três grupos a utilizam principalmente:
- Equipes de vendas e RevOps que querem enviar dados enriquecidos para um CRM ou data warehouse.
- Desenvolvedores de empresas de software que incorporam dados da Apollo.io em seu próprio produto.
- Parceiros que criam integrações de marketplace. Eles fazem login com OAuth 2.0 em vez de uma chave.
A Apollo.io acrescenta uma observação sobre licenciamento. Compartilhar, expor ou revender seus dados para pessoas que não são usuários da Apollo.io exige um contrato personalizado.
Documentação da API do Apollo.io: onde tudo está
A documentação da API do Apollo.io está disponível em docs.apollo.io. A barra superior a divide em Começar, API, MCP, CLI, OpenAPI e Changelog. A seção API contém uma página para cada endpoint.

Captura de tela: a página de pesquisa da API People na documentação para desenvolvedores do Apollo.io, extraída do guia do Apollo.io para testar uma chave.
Cada página de endpoint segue o mesmo padrão. Uma caixa de “Elementos essenciais do endpoint” no topo lista o caminho de acesso principal, o escopo OAuth, quem pode usá-lo e quantos créditos ele custa. Abaixo vêm os parâmetros. À direita, há um seletor de linguagem, um campo de credenciais, uma solicitação cURL e uma resposta de exemplo.
Você pode testar ao vivo na página. Cole sua chave no campo do cabeçalho, preencha os parâmetros obrigatórios e pressione Experimentar. Um 200 significa que a chamada funcionou. Mesmo sem uma chave, você pode abrir cada resposta de exemplo para ver o esquema.
O arquivo OpenAPI
O Apollo.io publica toda a API como um único arquivo OpenAPI 3 em https://docs.apollo.io/openapi/apollo-rest-api.json. Ele é reconstruído sempre que a documentação muda. Carregue-o no Postman ou em outro cliente de API, e cada endpoint aparecerá com seus parâmetros. Você também pode fornecê-lo a um gerador de código para criar um cliente tipado em sua própria linguagem.
No Postman, mantenha a chave na autorização API Key pré-configurada e defina uma variável apiKey. A documentação alerta que colar a chave como um token Bearer retorna um 401. Os tokens Bearer são destinados a parceiros OAuth.
Um índice legível por máquinas
A documentação também publica um índice em texto simples em docs.apollo.io/llms.txt. Ele lista cada página como um link Markdown. Ferramentas de codificação com IA podem lê-lo para encontrar a página do endpoint correto sem rastrear o site.
Como obter uma chave de API do Apollo.io
Uma chave de API do Apollo.io é criada dentro do aplicativo, não no site da documentação. O caminho é Configurações, depois Integrações e, em seguida, Chaves de API. Somente administradores podem fazer isso, assim como usuários cujo perfil de permissões inclua chaves.
Veja como obter acesso à chave de API do Apollo.io passo a passo:
- Abra o Apollo.io e clique em Configurações > Integrações > Chaves de API. O painel do desenvolvedor em developer.apollo.io mostra a mesma página.
- Clique em Criar nova chave.
- Insira um nome e uma descrição.
- Marque cada endpoint que a chave pode chamar ou ative Definir como chave mestre.
- Clique em Criar chave de API.
- Clique em Copiar e cole a chave em um local seguro.

Captura de tela: a caixa de diálogo de criação de nova chave de API no portal do desenvolvedor do Apollo.io, extraída da documentação do Apollo.io.
O Apollo.io mostra a chave completa no final. Copie-a nesse momento. Se você a perder, gere outra pelo painel.
Onde encontrar uma chave de API existente do Apollo.io
Se precisar encontrar uma chave de API do Apollo.io criada anteriormente, volte ao painel do desenvolvedor e abra as chaves de API. Cada chave criada aparece nessa lista. A barra lateral do portal também contém as páginas Início rápido, Uso e Assinatura. A mesma barra lateral tem uma página de Registro OAuth para parceiros.
O Apollo.io permite fazer duas coisas com uma chave existente. Regenerar cria um novo segredo e o copia. Excluir remove a chave permanentemente. Trate ambas como ações irreversíveis, pois todos os scripts que usavam a chave antiga deixam de funcionar.
Chave mestre ou chave com escopo?
Essa escolha é mais importante do que qualquer outra ao criar uma chave de API do Apollo.io.
| Tipo | O que ela acessa | Use para |
|---|---|---|
| Chave com escopo (padrão) | Somente os endpoints marcados | A maioria das integrações |
| Chave mestre | Todos os endpoints | Endpoints que exigem isso e o servidor MCP por meio de uma chave |
Uma chave com escopo que chama um endpoint não marcado recebe um 403. Alguns endpoints, como a lista de usuários do workspace, funcionam apenas com uma chave mestre. O Apollo.io orienta tratar uma chave mestre como uma senha. Ela pode executar qualquer ação de API permitida pela sua conta.
Em nome de qual usuário uma chave atua?
Uma chave de API do Apollo.io identifica seu workspace, não uma pessoa. O Apollo.io não consegue informar qual colega a utilizou. Cada solicitação atua como o administrador ativo mais antigo do workspace, e esse usuário é o proprietário de tudo o que a chamada cria. Para saber quem é, chame o endpoint de obtenção do perfil do usuário atual, que não consome créditos.
Isso surpreende equipes que criam uma chave a partir de um login com permissões limitadas. A chave não restringe o que o código pode acessar.
Verificação de integridade da API do Apollo.io
A maneira mais rápida de testar uma nova chave é fazer uma única chamada de integridade. É uma solicitação GET para auth/health, e nenhum crédito é consumido.
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 tudo estiver configurado corretamente, a verificação de integridade da API do Apollo.io retornará dois valores:
{ "healthy": true, "is_logged_in": true }
Quando ambos forem true, a chave funcionará. Se algum deles for false, procure espaços extras ou quebras de linha após a chave e envie a solicitação novamente. No Postman, defina o tipo de autorização como No Auth e adicione a chave como um cabeçalho.
A API do Apollo.io está fora do ar?
As pessoas que pesquisam esse termo às vezes querem uma resposta diferente. Elas querem saber se o próprio serviço está fora do ar. A chamada auth/health testa sua chave e um login, não toda a plataforma. Para interrupções, o Apollo.io mantém uma página de status em status.apollo.io.
Uma resposta 429 com o código USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT significa que a plataforma está rejeitando o tráfego devido à alta carga em toda a rede. Isso não tem relação com o seu plano. A documentação recomenda aguardar 60 segundos e tentar novamente.
Principais grupos de endpoints na API do Apollo.io
A referência lista dezenas de endpoints. Eles se dividem em seis grupos.
| Grupo | O que abrange | Exemplos |
|---|---|---|
| Pesquisar e enriquecer | Encontrar pessoas e empresas, preencher registros | Pesquisa na People API, enriquecimento de pessoas, pesquisa de organizações |
| Gerenciar registros | Contas, contatos, negócios, listas, notas | Criar um contato, atualizar contas em massa, adicionar registros a uma lista |
| Interagir com prospects | Sequências, emails, chamadas, tarefas, conversas | Adicionar contatos a uma sequência, enviar email agora |
| Assistente de AI | Delegar uma tarefa ao assistente integrado | Executar uma tarefa do assistente, consultar uma tarefa do assistente |
| Workspace | Usuários, caixas de correio, campos personalizados | Obter uma lista de usuários, criar um campo personalizado |
| Análises e uso | Relatórios, estatísticas de uso, resultados de webhook | Consultar relatório de análises, visualizar estatísticas de uso |
O gerenciamento de registros, as sequências e a maioria das chamadas do workspace usam 0 créditos. O custo está na pesquisa e no enriquecimento, que abordamos abaixo.
Pesquisa não é enriquecimento
Essa distinção confunde os novos usuários. Pesquisar o banco de dados de pessoas do Apollo.io retorna perfis. Os resultados não contêm emails nem telefones. Você precisa fazer uma segunda chamada, para um endpoint de enriquecimento, para obtê-los. Pesquisar seus próprios contatos salvos é um conjunto diferente de endpoints, com limitações diferentes.
Documentação da pesquisa de pessoas da API do Apollo.io
A documentação da pesquisa de pessoas da API do Apollo.io abrange um endpoint POST: /mixed_people/api_search. O Apollo.io descreve pessoas como prospects novos que você ainda não salvou como contatos.
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'
Os parâmetros são inseridos na string de consulta. Você pode restringir a pesquisa por:
- Cargos:
person_titles[], além deperson_not_titles[]para excluir alguns. - Nível de senioridade:
person_seniorities[]. - Localização:
person_locations[]para onde as pessoas moram,organization_locations[]para a sede da empresa. - Tamanho e receita da empresa:
organization_num_employees_ranges[]erevenue_range[min]. - Tecnologia: filtros para mais de 1.500 tecnologias usadas por uma empresa.
- Sinais de contratação:
q_organization_job_titles[]e contagens de ofertas de emprego. - Status do e-mail:
contact_email_status[], com valores como verificado, não verificado, provavelmente engajado e indisponível. - Paginação:
pageeper_page.
O endpoint de pesquisa de pessoas usa 0 créditos. Ele retorna até 100 registros por página. Também tem um limite de exibição de 50.000 registros, ou 500 páginas. Adicione filtros para permanecer abaixo desse limite.
O que a pesquisa de pessoas da API do Apollo.io retorna
Uma resposta da pesquisa de pessoas contém uma contagem total_entries e uma lista people. Ela não inclui e-mails nem telefones. Para obter os dados de contato, envie cada resultado ao endpoint de enriquecimento.
A pesquisa tem seus próprios limites, listados na seção de limites de taxa abaixo.
Se você pesquisar por contact_email_status[], lembre-se de onde o valor vem. Ele descreve o registro do Apollo.io sobre o endereço. Não é um teste ativo da caixa de correio.
Como ler mais rapidamente a documentação da pesquisa de pessoas da API do Apollo.io
Comece pela caixa de informações essenciais do endpoint. Verifique as linhas sobre uso de créditos e acesso à conta gratuita. Em seguida, examine a lista de parâmetros para encontrar os filtros necessários. Por fim, execute uma solicitação pequena com per_page=10 antes de paginar por milhares de resultados.
Enriqueça Pessoas com a API do Apollo.io
O enriquecimento atualiza registros que você já possui. O Apollo.io oferece dois endpoints para pessoas:
- Enriquecimento de pessoas:
POST /people/match, uma pessoa por chamada. - Enriquecimento em massa de pessoas: até 10 pessoas em uma única solicitação.
O Apollo.io precisa de detalhes suficientes para identificar a pessoa correta. Um endereço de e-mail sozinho funciona. Um nome mais o domínio da empresa também. O endpoint também aceita uma URL do LinkedIn, o nome de uma organização ou um ID de pessoa do Apollo.io. Se você enviar apenas um nome, poderá receber uma resposta 200 sem nenhum enriquecimento.
Verifique match_confidence em todas as respostas. Ele pode ser high, medium, low ou 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'
A resposta contém o cargo da pessoa, o histórico profissional, os dados da empresa e um email_status, como verified. Esse status é um rótulo próprio do Apollo.io. A verificação posterior neste guia testa o próprio endereço.
Telefones, endereços pessoais e waterfall
Três opções facultativas alteram o que você recebe:
reveal_personal_emails=trueadiciona endereços pessoais. O Apollo.io não os revela para pessoas em regiões sob o GDPR.reveal_phone_number=trueadiciona todos os números de telefone, incluindo celulares. É necessário fornecer umawebhook_url. O Apollo.io verifica os números de forma assíncrona e os envia ao seu webhook, o que pode levar vários minutos.run_waterfall_emailerun_waterfall_phonepesquisam primeiro no Apollo.io e depois nos seus provedores externos de dados configurados. Os resultados finais também chegam por webhook.
Evite pagar duas vezes
Se você enriquecer a mesma pessoa novamente mais tarde, poderá gastar créditos outra vez pelos mesmos dados. O Apollo.io sugere converter pessoas enriquecidas em contatos. Um contato pertence à sua organização, portanto seus dados continuam acessíveis.
Limites de taxa da API do Apollo.io
Os limites de taxa são por equipe, não por chave ou usuário. Eles também são por endpoint e funcionam em três janelas ao mesmo tempo: minuto, hora e dia. Você deve permanecer dentro de todas as janelas aplicáveis.
| Limite | Grátis | Básico | Profissional | Organização |
|---|---|---|---|---|
| Solicitações por minuto | 50 | 200 | 200 | 200 |
| Solicitações por hora | 200 | 400 | 400 | 600 |
| Solicitações por dia | 600 | 2.000 | 2.000 | 6.000 |
Essa tabela é o padrão. Os endpoints de pesquisa e enriquecimento têm limites maiores nos planos pagos:
- Endpoints de enriquecimento: 1.000 solicitações por minuto nos planos pagos, sem limite por hora ou por dia. As contas gratuitas recebem 50 por minuto e 20 nos endpoints em massa.
- Endpoints de pesquisa: 200 por minuto, 6.000 por hora e 50.000 por dia nos planos pagos.
- Limites menores: o relatório de análise de consultas permite 5 solicitações por hora.
A documentação do Apollo.io destaca que o limite alto de enriquecimento não é uma licença para enviar chamadas ilimitadas. Seu saldo de créditos ainda controla quanto você pode enriquecer.

Captura de tela: a página Usage do portal de desenvolvedores do Apollo.io, com limites diários e horários para os endpoints de enriquecimento, conforme a documentação do Apollo.io.
Cabeçalhos de resposta e o erro 429
O Apollo.io adiciona cabeçalhos às chamadas autenticadas. Eles mostram o limite, o uso até o momento e as solicitações restantes para cada janela:
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, enviado com um429, informa os segundos até a redefinição da janela
Quando você ultrapassa um limite, recebe um 429. Leia retry-after e aguarde. A janela começa na sua primeira solicitação e não está vinculada ao relógio. O corpo do erro contém um objeto error_details. Seu code é USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED para o seu próprio limite.
Para ler os limites atuais da sua equipe no código, chame o endpoint de estatísticas de uso da API de visualização. Uma única chamada pode abranger até 74 caminhos de endpoint, e nada disso custa créditos.
Créditos da API do Apollo.io: o que custa dinheiro
Muitas chamadas não custam nada. O Apollo.io informa que os endpoints que criam, atualizam, listam ou gerenciam registros consomem 0 créditos. Os créditos são usados em endpoints de enriquecimento, pesquisa de organizações, pesquisa de notícias e insights de IA, e somente quando retornam dados qualificados.
| Endpoint | Custo em créditos |
|---|---|
| Enriquecimento de pessoas | 1 a 9 por pessoa: 1 para dados demográficos ou e-mail, mais 8 se um telefone celular for retornado |
| Enriquecimento em massa de pessoas | Mesma lógica, até 10 pessoas por solicitação |
| Enriquecimento de organizações | 1 por organização |
| Pesquisa de organizações | 1 por página, até 100 resultados por página |
| Pesquisa de artigos de notícias | 1 por página, até 25 resultados por página |
| Vagas de emprego da organização | 1 por página |
| Obter informações completas da pessoa | 1 por pessoa |
| Tarefa do assistente | Variável, definida pelas ações realizadas pelo assistente |
A pesquisa de pessoas é gratuita, portanto, uma estratégia sensata é pesquisar primeiro e enriquecer apenas as melhores correspondências. A paginação de um endpoint que consome créditos gasta créditos em todas as páginas. O Apollo.io recomenda fazer um pequeno teste e verificar seu uso antes de aumentar a escala.
O enriquecimento em cascata pode custar mais. O enriquecimento de e-mail em cascata normalmente usa de 1 a 4 créditos, e algumas configurações usam 20 ou mais. O enriquecimento de telefone em cascata normalmente usa de 8 a 25, e algumas usam 45 ou mais.
Para acompanhar os gastos, abra Configurações > Faturamento e créditos > Uso de créditos no aplicativo. A aba Uso do painel do desenvolvedor mostra os créditos de telefone e e-mail usados no ciclo de faturamento atual. Os planos antigos podem ser diferentes, portanto, consulte a página Sobre os créditos do seu workspace.
Erros e códigos de status
A maioria dos endpoints da API do Apollo.io compartilha uma lista curta de códigos de status:
| Código | Significado | Causa comum |
|---|---|---|
401 | Não autorizado | Chave ausente, inválida ou de uma conta inativa |
403 | Proibido | O plano não tem acesso à API ou uma chave com escopo não tem acesso ao endpoint |
404 | Não encontrado | O registro não existe ou não está visível para você |
422 | Não processável | Parâmetro inválido ou ausente |
429 | Muitas solicitações | Você ultrapassou um limite de taxa |
500 | Erro do servidor | Uma falha no lado do Apollo.io; tente novamente |
O Apollo.io está migrando os erros para um único formato. Quando um endpoint é migrado, a resposta inclui um objeto error_details com um code estável, uma message, suggestions e context. Baseie seu código em error_details.code, nunca no texto da mensagem. O Apollo.io planeja remover os campos de erro antigos no nível raiz em 16 de fevereiro de 2027, portanto, comece a usar o novo objeto agora.
O servidor MCP do Apollo.io
MCP é um padrão que permite que ferramentas de IA chamem serviços externos. O servidor MCP do Apollo.io conecta Claude, ChatGPT e clientes semelhantes à sua conta do Apollo.io. Você pode então pedir em linguagem simples: encontre líderes de marketing em nível de VP em empresas SaaS ou enriqueça estes dez prospects.

Captura de tela: a página do MCP do Apollo.io na documentação para desenvolvedores, outubro de 2026.
Três formas de conectar
| Rota | Como funciona |
|---|---|
| Conectores de IA | Integrações integradas no ChatGPT, Claude, Perplexity, Replit e Cursor. Nenhuma configuração de servidor. |
| Plug-ins de programação | Plug-ins próprios para ferramentas como o Codex. |
| Servidor MCP independente | Aponte qualquer cliente MCP compatível com servidores remotos para uma URL. |
As configurações independentes são curtas:
| Configuração | Valor |
|---|---|
| Endpoint | https://mcp.apollo.io/mcp |
| Transporte | HTTP transmitível |
| Login | OAuth 2.0 |
| Instalação local | Não necessária |
| API key | Não necessária, a menos que o cliente não tenha navegador |
No Claude Code, um comando adiciona o servidor. Execute-o, depois digite /mcp e conclua o login OAuth:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Se você gerencia vários espaços de trabalho, adicione a mesma URL com um nome diferente para cada um. Faça login em cada conexão separadamente.
Servidores sem navegador
O OAuth precisa de uma janela do navegador. Um cron job ou pipeline de CI não tem uma. Nesses casos, o servidor aceita uma API key enviada como X-Api-Key. A chave deve ser uma chave mestra. Uma chave com escopo retorna 403 com o código API_INACCESSIBLE, porque o servidor MCP não é um dos endpoints que você pode selecionar.
Armazene essa chave como qualquer segredo de produção. Ela funciona como a administradora do espaço de trabalho e consome créditos do espaço. Novas ferramentas MCP acessam uma chave mestra imediatamente, mas seu cliente pode manter uma lista de ferramentas em cache. Reconecte-se e chame tools/list para atualizá-la.
O que o servidor MCP do Apollo.io pode fazer
A lista de ferramentas abrange pesquisa e prospecção, enriquecimento de pessoas e empresas, contatos, listas, sequências, e-mails avulsos, tarefas, verificações de domínio de e-mail e análises. As ações de enriquecimento usam créditos. A maioria das outras ações não usa nenhum. O Apollo.io alerta que a pesquisa de pessoas não retorna e-mails nem telefones, portanto seu assistente precisa executar uma etapa de enriquecimento para obtê-los.
Limites práticos da documentação:
- Não há cobrança extra pela conexão. Seu plano, suas permissões e seus créditos se aplicam.
- Ações destrutivas, como exclusão em massa, não são compatíveis.
- O servidor segue suas permissões. Com OAuth, ele age como o usuário que fez login.
- O MCP do Apollo.io usa limites de taxa separados e não retorna os cabeçalhos de limite de taxa.
- O Apollo.io proíbe o treinamento de modelos de IA com dados do MCP, portanto desative o treinamento primeiro no seu cliente de IA.
O Apollo.io recomenda definir as ações que consomem créditos como Requer aprovação, para que um assistente muito conversador não gaste créditos por conta própria.
Outras formas de usar a API do Apollo.io
- CLI do Apollo.io. Uma ferramenta de linha de comando com acesso à API completa. Instale-a com Homebrew, um binário pré-compilado ou a partir do código-fonte. Ela usa OAuth, portanto não precisa de uma chave.
- OAuth 2.0. Os parceiros usam-no para chamar a API para clientes em comum, e a documentação lista uma aplicação de marketplace para integrações concluídas.
- Extensão do Chrome. Para clicar em vez de programar, leia nosso guia da extensão do Chrome do Apollo.
Verifique endereços da API do Apollo.io antes de enviar
Independentemente da rota escolhida, os dados têm um ponto fraco. Eles vêm de um banco de dados. As pessoas mudam de emprego, e as empresas mudam para novos domínios. O campo email_status é o próprio rótulo do Apollo.io, não um teste recente. Um email frio enviado para um endereço inativo retorna, e os retornos prejudicam a reputação do remetente.
Por isso, faça uma verificação entre o enriquecimento e a sua sequência. O BillionVerify testa cada endereço sem enviar uma mensagem. Ele verifica a sintaxe, o domínio, os registros MX e, quando solicitado, a caixa de correio por SMTP. Ele sinaliza endereços descartáveis e de função. Ele informa catch-all como um resultado próprio, em vez de contá-lo como válido. Resultados desconhecidos não custam nada, e uma nova verificação em até 24 horas é gratuita. Antes de integrar a API, você pode verificar manualmente se um endereço de email existe no verificador web gratuito.

O BillionVerify retorna um status, um indicador de entregabilidade e um motivo para cada endereço.
Um pequeno pipeline
Um pipeline simples tem quatro etapas:
- Faça uma busca gratuita de pessoas pela API.
- Enriqueça apenas as melhores correspondências.
- Envie cada endereço para a REST API do BillionVerify.
- Adicione apenas endereços entregáveis à sua sequência.
A chamada do BillionVerify é um POST. Envie a chave no cabeçalho BV-API-KEY e defina check_smtp como true para um teste da caixa de correio em tempo real:
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}'
A resposta contém status, is_deliverable, is_catchall, is_role, is_disposable e um reason. Para até 50 endereços em uma chamada, use a rota em massa. Para uma exportação completa, carregue um arquivo CSV, TXT ou XLSX e baixe os resultados posteriormente. A referência completa está na documentação do BillionVerify.
Verifique pelo cliente de IA
Se você já conecta a configuração MCP do Apollo.io a um cliente de IA, adicione o servidor MCP hospedado do BillionVerify ao lado dela. Ele fica em https://mcp.billionverify.com/mcp e usa OAuth para o login. Assim, seu assistente pode enriquecer um prospect pelo Apollo.io e verificar o endereço em uma única conversa. Informe sua política, como quais status aceitar e o que fazer com catch-all.
Outras verificações
- Nossa página de verificação de emails do Apollo explica o fluxo de exportação.
- Um contato suspeito pode passar pela nossa busca reversa de email gratuita, que mostra o que está publicamente associado a um endereço.
- Os números de telefone retornados pelo webhook também merecem um teste. Nosso validador de números de telefone gratuito mostra se um número é válido para o país e qual é o tipo de linha.
O BillionVerify oferece 20 créditos gratuitos por dia em que você usa sua conta, até 600 por mês. Eles nunca expiram, e você não precisa de cartão de crédito.
Dicas para construir com a API do Apollo.io
- Comece com uma chave com escopo definido por integração. Se uma vazar, você revoga apenas essa.
- Execute primeiro a verificação de integridade. Ela elimina problemas com a chave antes de você depurar o código.
- Leia a caixa de informações essenciais do endpoint. A documentação de pesquisa de pessoas da API do Apollo.io mostra o custo em créditos logo de início.
- Pesquise antes de enriquecer. A pesquisa é gratuita, mas o enriquecimento não.
- Teste com
per_page=10. Execuções pequenas mostram os custos em créditos antes que eles prejudiquem você. - Respeite
retry-after. Insistir em um endpoint limitado apenas prolonga a espera. - Leia
error_details.code. O texto da mensagem pode mudar sem aviso. - Verifique antes de enviar. Um crédito gasto em um endereço que retorna mensagens desperdiçadas é desperdiçado duas vezes.
Perguntas frequentes
O Apollo.io tem uma API?
Sim, o Apollo.io tem uma API REST. Ela permite pesquisar pessoas e empresas, enriquecer contatos e atualizar contas, negócios e sequências. O acesso básico vem com todos os planos. Seu plano define quais endpoints você pode chamar, com que velocidade e quanto cada chamada custa.
Como obtenho uma chave de API do Apollo.io?
Uma chave do Apollo.io vem da área de Integrações das Configurações: abra Chaves de API e escolha Criar nova chave. Dê um nome, marque os endpoints que ela poderá chamar e confirme; em seguida, copie o segredo imediatamente. Um administrador ou usuário com o perfil de permissões adequado pode fazer isso.
Onde encontro minha chave de API do Apollo.io?
A lista de chaves de API do Apollo.io fica na página Chaves de API, acessível pelo aplicativo ou pelo painel do desenvolvedor. O segredo completo aparece quando você cria a chave. Perder o segredo significa gerar novamente a chave, o que emite uma nova.
A API do Apollo.io é gratuita?
As chamadas da API do Apollo.io que criam, listam ou atualizam registros não custam nada, e a pesquisa de pessoas também não. O enriquecimento e alguns endpoints de pesquisa cobram créditos quando retornam dados. Contas gratuitas podem chamar a API dentro dos limites do plano gratuito, mas alguns endpoints exigem um e-mail profissional.
Qual é o limite de taxa da API do Apollo.io?
Em um plano pago, a maioria dos endpoints da API do Apollo.io aceita 200 chamadas por minuto, com limites horários e diários que variam conforme o plano. O plano gratuito aceita 50 por minuto, 200 por hora e 600 por dia. Os limites se aplicam por equipe e por endpoint, e uma resposta 429 significa que você ultrapassou um deles.
Como testo a verificação de integridade da API do Apollo.io?
A verificação de integridade do Apollo.io é uma solicitação GET para o caminho auth/health, com o cabeçalho da chave definido. Uma resposta com healthy: true e is_logged_in: true significa que a chave funciona. Nenhum crédito é gasto.
A pesquisa de pessoas da API do Apollo.io retorna e-mails?
Não, o endpoint de pesquisa de pessoas do Apollo.io retorna apenas perfis, sem e-mails ou telefones. Execute o endpoint de enriquecimento de pessoas ou de enriquecimento em massa de pessoas nos resultados para obter os dados de contato, o que custa créditos.
Onde está a documentação da API do Apollo.io?
A documentação da API do Apollo.io está em docs.apollo.io. Cada endpoint tem sua própria página, com parâmetros, um painel de testes e um exemplo de resposta. Você também pode baixar o arquivo OpenAPI e importá-lo no Postman.
O que é o servidor MCP do Apollo.io?
O servidor MCP do Apollo.io conecta clientes de IA ao seu workspace por meio do Model Context Protocol. Sua URL é https://mcp.apollo.io/mcp, ele usa Streamable HTTP e OAuth e não requer instalação local. Seu plano, suas permissões e seus créditos continuam se aplicando.
Qual é o melhor servidor MCP para o Apollo.io?
O Apollo.io publica um servidor MCP oficial, que é o descrito em sua documentação. Não testamos opções de terceiros. Escolha o servidor oficial se quiser as mesmas permissões e regras de créditos do aplicativo.
Devo verificar os e-mails que vêm da API do Apollo.io?
Sim, verifique todos os endereços de e-mail da API do Apollo.io antes de uma campanha. O campo email_status reflete os próprios registros do Apollo.io, e as pessoas mudam de emprego. Uma rápida verificação pela API do BillionVerify remove endereços inativos e protege a reputação do remetente.
Assista ao vídeo: Como validar um número de telefone: validador grátis
Assista ao vídeo: Como verificar e-mails do Apollo antes de enviar
