Pular para o conteúdo principal
Black Friday: 20% de desconto em todos os planos até 1º de dez.Ver a oferta

API Apollo.io: Chave, Endpoints, Limites e Servidor MCP

Leo
LeoFounder, BillionVerify

Guia da API do Apollo.io: crie uma chave, faça a verificação de saúde, use busca e enriquecimento, entenda limites/créditos e conecte o servidor MCP.

Painel da API do Apollo.io exibindo chaves, endpoints, limites de requisições, MCP Server e verificação de e-mail

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/mcp e 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:

  1. Equipes de vendas e RevOps que querem enviar dados enriquecidos para um CRM ou data warehouse.
  2. Desenvolvedores de empresas de software que incorporam dados da Apollo.io em seu próprio produto.
  3. 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.

Página de documentação da API do Apollo.io para pesquisa da API People, com o painel de credenciais e a resposta de exemplo

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:

  1. 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.
  2. Clique em Criar nova chave.
  3. Insira um nome e uma descrição.
  4. Marque cada endpoint que a chave pode chamar ou ative Definir como chave mestre.
  5. Clique em Criar chave de API.
  6. Clique em Copiar e cole a chave em um local seguro.

Caixa de diálogo de criação de nova chave de API do Apollo.io com nome, descrição, seleção de API e ativação da chave mestre

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.

TipoO que ela acessaUse para
Chave com escopo (padrão)Somente os endpoints marcadosA maioria das integrações
Chave mestreTodos os endpointsEndpoints 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.

GrupoO que abrangeExemplos
Pesquisar e enriquecerEncontrar pessoas e empresas, preencher registrosPesquisa na People API, enriquecimento de pessoas, pesquisa de organizações
Gerenciar registrosContas, contatos, negócios, listas, notasCriar um contato, atualizar contas em massa, adicionar registros a uma lista
Interagir com prospectsSequências, emails, chamadas, tarefas, conversasAdicionar contatos a uma sequência, enviar email agora
Assistente de AIDelegar uma tarefa ao assistente integradoExecutar uma tarefa do assistente, consultar uma tarefa do assistente
WorkspaceUsuários, caixas de correio, campos personalizadosObter uma lista de usuários, criar um campo personalizado
Análises e usoRelatórios, estatísticas de uso, resultados de webhookConsultar 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 de person_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[] e revenue_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: page e per_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=true adiciona endereços pessoais. O Apollo.io não os revela para pessoas em regiões sob o GDPR.
  • reveal_phone_number=true adiciona todos os números de telefone, incluindo celulares. É necessário fornecer uma webhook_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_email e run_waterfall_phone pesquisam 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.

LimiteGrátisBásicoProfissionalOrganização
Solicitações por minuto50200200200
Solicitações por hora200400400600
Solicitações por dia6002.0002.0006.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.

Página Usage do portal de desenvolvedores da API do Apollo.io mostrando os limites de taxa diários e horários de enriquecimento

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-hourly e x-rate-limit-24-hour
  • x-minute-usage, x-hourly-usage e x-24-hour-usage
  • x-minute-requests-left, x-hourly-requests-left e x-24-hour-requests-left
  • retry-after, enviado com um 429, 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.

EndpointCusto em créditos
Enriquecimento de pessoas1 a 9 por pessoa: 1 para dados demográficos ou e-mail, mais 8 se um telefone celular for retornado
Enriquecimento em massa de pessoasMesma lógica, até 10 pessoas por solicitação
Enriquecimento de organizações1 por organização
Pesquisa de organizações1 por página, até 100 resultados por página
Pesquisa de artigos de notícias1 por página, até 25 resultados por página
Vagas de emprego da organização1 por página
Obter informações completas da pessoa1 por pessoa
Tarefa do assistenteVariá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ódigoSignificadoCausa comum
401Não autorizadoChave ausente, inválida ou de uma conta inativa
403ProibidoO plano não tem acesso à API ou uma chave com escopo não tem acesso ao endpoint
404Não encontradoO registro não existe ou não está visível para você
422Não processávelParâmetro inválido ou ausente
429Muitas solicitaçõesVocê ultrapassou um limite de taxa
500Erro do servidorUma 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.

Página de documentação do MCP do Apollo.io mostrando as três formas de conexão: conectores de IA, plug-ins de programação e um servidor MCP independente

Captura de tela: a página do MCP do Apollo.io na documentação para desenvolvedores, outubro de 2026.

Três formas de conectar

RotaComo funciona
Conectores de IAIntegrações integradas no ChatGPT, Claude, Perplexity, Replit e Cursor. Nenhuma configuração de servidor.
Plug-ins de programaçãoPlug-ins próprios para ferramentas como o Codex.
Servidor MCP independenteAponte qualquer cliente MCP compatível com servidores remotos para uma URL.

As configurações independentes são curtas:

ConfiguraçãoValor
Endpointhttps://mcp.apollo.io/mcp
TransporteHTTP transmitível
LoginOAuth 2.0
Instalação localNão necessária
API keyNã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.

Resultados da API de verificação de emails do BillionVerify mostrando os campos de status, entregabilidade e motivo

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:

  1. Faça uma busca gratuita de pessoas pela API.
  2. Enriqueça apenas as melhores correspondências.
  3. Envie cada endereço para a REST API do BillionVerify.
  4. 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

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

Leo
LeoFounder, BillionVerify
Insights sobre Verificação de E-mail

Comece a Verificar Hoje

Comece a verificar e-mails com o BillionVerify hoje. Ganhe 20 créditos grátis a cada dia que fizer login, até 600 por mês - sem necessidade de cartão de crédito. Junte-se a milhares de empresas melhorando seu ROI de email marketing com verificação precisa de e-mails.

Sem necessidade de cartão de crédito · API em tempo real e verificação em massa · Resultados desconhecidos são gratuitos

0
Créditos para resultados desconhecidos
Tempo real
Velocidade da API
$0.00014
Por e-mail
600/mês
Grátis para sempre