Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Pesquisa na People API
Encontre pessoas que correspondem a critérios, em vez de enriquecer alguém que você já identificou. Filtre por cargo, senioridade, localização, domínio da empresa, número de funcionários e setor, e pagine com page e per_page. Retorna total_entries e um array people. Observe o que a busca deliberadamente omite: as entradas trazem last_name_obfuscated e flags booleanas — has_email, has_direct_phone, has_city, has_state, has_country — em vez dos valores em si. A busca informa que existe uma correspondência; o enriquecimento revela os dados de contato. Passe os ids para post_apollo_people_match ou post_apollo_people_bulk_match para obter e-mails e telefones, que é também onde os créditos são gastos. Requer permissão administrativa da Felo.
Pricing reference
- Medição: base de custo fixa por requisição bem-sucedida.
- Estimativa de referência por requisição: USD 0.012.
Apenas metadados de referência, não uma cotação da conta, um preço garantido nem um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: array string[]contact
_email _status[] Os status de e-mail das pessoas que você quer encontrar. Você pode adicionar vários status para ampliar sua pesquisa. Os status disponíveis para pesquisa incluem: verified unverified likely to engage unavailable
- Tipo: array string[]currently
_not _using _any _of _technology _uids[] Exclua pessoas da sua pesquisa com base em qualquer uma das tecnologias usadas pelo empregador atual delas. O Apollo oferece suporte a filtros por mais de 1.500 tecnologias. O Apollo calcula os dados de tecnologias a partir de várias fontes. Esses dados são atualizados regularmente. Consulte a lista completa de tecnologias compatíveis baixando este arquivo CSV . Use sublinhados (_) para substituir espaços e pontos nas tecnologias listadas no arquivo CSV. Exemplos: salesforce; google_analytics; wordpress_org
- Tipo: array string[]currently
_using _all _of _technology _uids[] Encontre pessoas com base em todas as tecnologias usadas pelo empregador atual delas. O Apollo oferece suporte a filtros por mais de 1.500 tecnologias. O Apollo calcula os dados de tecnologias a partir de várias fontes. Esses dados são atualizados regularmente. Consulte a lista completa de tecnologias compatíveis baixando este arquivo CSV . Use sublinhados (_) para substituir espaços e pontos nas tecnologias listadas no arquivo CSV. Exemplos: salesforce; google_analytics; wordpress_org
- Tipo: array string[]currently
_using _any _of _technology _uids[] Encontre pessoas com base em qualquer uma das tecnologias usadas pelo empregador atual delas. O Apollo oferece suporte a filtros por mais de 1.500 tecnologias. O Apollo calcula os dados de tecnologias a partir de várias fontes. Esses dados são atualizados regularmente. Consulte a lista completa de tecnologias compatíveis baixando este arquivo CSV . Use sublinhados (_) para substituir espaços e pontos nas tecnologias listadas no arquivo CSV. Exemplos: salesforce; google_analytics; wordpress_org
- Tipo: booleaninclude
_similar _titles Este parâmetro determina se pessoas com cargos semelhantes aos definidos no parâmetro person_titles[] são retornadas na resposta. Defina este parâmetro como false ao usar person_titles[] para retornar apenas correspondências exatas de cargos.
- Tipo: array string[]organization
_ids[] Os IDs do Apollo das empresas (empregadores) que você deseja incluir nos resultados da pesquisa. Cada empresa no banco de dados do Apollo recebe um ID exclusivo. Para encontrar IDs, chame o endpoint Organization Search e identifique os valores de organization_id. Exemplo: 5e66b6381e05b4008c8331b8
- Tipo: array string[]organization
_job _locations[] Os locais das vagas recrutadas ativamente pelo empregador da pessoa. Exemplos: atlanta; japan
- Tipo: stringorganization
_job _posted _at _range[max] A data mais recente em que vagas foram publicadas pelo empregador atual da pessoa. Use este parâmetro em conjunto com organization_job_posted_at_range[min] para definir um intervalo de datas de publicação das vagas. Exemplo: 2025-09-25
- Tipo: stringorganization
_job _posted _at _range[min] A data mais antiga em que vagas foram publicadas pelo empregador atual da pessoa. Use este parâmetro em conjunto com organization_job_posted_at_range[max] para definir um intervalo de datas de publicação das vagas. Exemplo: 2025-07-25
- Tipo: array string[]organization
_locations[] O local da sede da empresa do empregador atual da pessoa. Você pode pesquisar por cidades, estados dos EUA e países. Se uma empresa tiver vários escritórios, os resultados ainda se baseiam no local da sede. Por exemplo, se você pesquisar chicago mas a sede da empresa estiver em boston, as pessoas que trabalham nessa empresa não aparecerão nos resultados, mesmo que correspondam a outros parâmetros. Para encontrar pessoas com base no local pessoal delas, use o parâmetro person_locations. Exemplos: texas; tokyo; spain
- Tipo: array string[]organization
_num _employees _ranges[] O intervalo de número de funcionários que trabalham na empresa atual da pessoa. Isso permite encontrar pessoas com base no quadro de funcionários do empregador delas. Você pode adicionar vários intervalos para ampliar os resultados da pesquisa. Cada intervalo adicionado precisa ser uma string, com os números superior e inferior do intervalo separados apenas por uma vírgula. Exemplos: 1,10; 250,500; 10000,20000
- Tipo: integerorganization
_num _jobs _range[max] O número máximo de vagas ativas no empregador atual da pessoa. Use este parâmetro em conjunto com organization_num_jobs_range[min] para definir um intervalo de vagas. Exemplos: 50; 500
- Tipo: integerorganization
_num _jobs _range[min] O número mínimo de vagas ativas no empregador atual da pessoa. Use este parâmetro em conjunto com organization_num_jobs_range[max] para definir um intervalo de vagas. Exemplos: 50; 500
- Tipo: integerpage
O número da página dos dados do Apollo que você deseja recuperar. Use este parâmetro em conjunto com o parâmetro per_page para tornar os resultados da pesquisa navegáveis e melhorar o desempenho do endpoint. Exemplo: 4
- Tipo: integerper
_page O número de resultados de pesquisa que deve ser retornado por página. Limitar o número de resultados por página melhora o desempenho do endpoint. Use o parâmetro page para pesquisar as diferentes páginas de dados. Exemplo: 10
- Tipo: array string[]person
_locations[] O local onde as pessoas moram. Você pode pesquisar por cidades, estados dos EUA e países. Para encontrar pessoas com base no local da sede do empregador atual delas, use o parâmetro organization_locations. Exemplos: california; ireland; chicago
- Tipo: array string[]person
_seniorities[] O nível hierárquico do cargo que a pessoa ocupa no empregador atual. Isso permite encontrar pessoas que atualmente ocupam posições em determinados níveis de subordinação, como nível de diretor ou nível de IC sênior. Para uma pessoa ser incluída nos resultados da pesquisa, ela precisa corresponder a apenas 1 dos níveis hierárquicos adicionados. Adicionar mais níveis hierárquicos amplia os resultados da pesquisa. As pesquisas retornam resultados apenas com base no cargo atual, então pesquisar por funcionários de nível de diretor retorna apenas pessoas que atualmente têm um título de nível de diretor. Se alguém foi diretor no passado, mas atualmente é VP, essa pessoa não será incluída nos resultados. Use este parâmetro em conjunto com o parâmetro person_titles[] para encontrar pessoas com base em funções e níveis hierárquicos específicos. As seguintes opções podem ser usadas para este parâmetro: owner founder c_suite partner vp head director manager senior entry intern
- Tipo: array string[]person
_titles[] Cargos ocupados pelas pessoas que você quer encontrar. Para uma pessoa ser incluída nos resultados da pesquisa, ela precisa corresponder a apenas 1 dos cargos adicionados. Adicionar mais cargos amplia os resultados da pesquisa. Os resultados também incluem cargos com os mesmos termos, mesmo que não sejam correspondências exatas. Por exemplo, pesquisar por marketing manager pode retornar pessoas com o cargo content marketing manager. Use este parâmetro em conjunto com o parâmetro person_seniorities[] para encontrar pessoas com base em funções e níveis hierárquicos específicos. Exemplos: sales development representative; marketing manager; research analyst
- Tipo: stringq
_keywords Uma string de palavras pela qual queremos filtrar os resultados.
- Tipo: array string[]q
_organization _domains _list[] O nome de domínio do empregador da pessoa. Pode ser o empregador atual ou um anterior. Não inclua www., o símbolo @ ou similares. Este parâmetro aceita até 1.000 domínios em uma única requisição. Exemplos: apollo.io; microsoft.com
- Tipo: array string[]q
_organization _job _titles[] Os cargos listados em vagas ativas no empregador atual da pessoa. Exemplos: sales manager; research analyst
- Tipo: integerrevenue
_range[max] A receita máxima gerada pelo empregador atual da pessoa. Use este parâmetro em conjunto com revenue_range[min] para definir um intervalo de receita. Não insira símbolos de moeda, vírgulas ou pontos decimais no valor. Exemplos: 500000; 1500000
- Tipo: integerrevenue
_range[min] A receita mínima gerada pelo empregador atual da pessoa. Use este parâmetro em conjunto com revenue_range[max] para definir um intervalo de receita. Não insira símbolos de moeda, vírgulas ou pontos decimais no valor. Exemplos: 500000; 1500000
- Tipo: object200
Resposta bem-sucedida
- Tipo: array string[]people
Array de resposta
- Tipo: integertotal
_entries Campo de resposta
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
application/json
curl https://openapi.felo.ai/v1/beta/apollo/mixed_people/api_search \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"total_entries": 1,
"people": [
"string"
]
}