API para Apollo

API para Apollo: Busca de pessoas

Busque pessoas por cargo, senioridade, nome, localização, domínio ou ID do empregador, status do e-mail e receita, tecnologia, contratações e crescimento de headcount do empregador, com resumos de perfil normalizados.

POST/v1/run/apollo.people_search
Disponibilidade
85,56%
30d · 270 chamadas
Requisições
270
30d · semanal, últimas 12 sem.
Resposta
1,7s
mediana · 30d

Preços

Um preço, em dólares

Teste

Faça sua primeira requisição

emailStatusesarray
Status de e-mail a corresponder.
senioritiesarray
Níveis de senioridade a corresponder.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "people": [
      {
        "firstName": "Alex",
        "hasCity": true,
        "hasCountry": true,
        "hasDirectPhone": true,
        "hasEmail": true,
        "hasState": true,
        "id": "a1b2c3d4",
        "lastNameInitial": "Rivera",
        "lastRefreshedUtc": 12.5,
        "organization": {
          "hasCity": true,
          "hasCountry": true,
          "hasEmployeeCount": true,
          "hasIndustry": true,
          "hasPhone": true,
          "hasPostalCode": true,
          "hasRevenue": true,
          "hasState": true,
          "name": "Example title"
        },
        "title": "Example title"
      }
    ],
    "total": 12500
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface ApolloPeopleSearchResponse {
  data: {
    people: {
      firstName: string;
      hasCity?: boolean;
      hasCountry?: boolean;
      hasDirectPhone?: boolean;
      hasEmail?: boolean;
      hasState?: boolean;
      id: string;
      lastNameInitial?: string;
      lastRefreshedUtc?: number;
      organization?: {
        hasCity?: boolean;
        hasCountry?: boolean;
        hasEmployeeCount?: boolean;
        hasIndustry?: boolean;
        hasPhone?: boolean;
        hasPostalCode?: boolean;
        hasRevenue?: boolean;
        hasState?: boolean;
        name?: string;
      };
      title?: string;
    }[];
    total: number;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/apollo.people_search
curl -X POST https://api.getanyapi.com/v1/run/apollo.people_search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"page":1,"titles":["CEO"]}'
CampoTipoValor de exemplo
Corpo da requisição
emailStatusesarrayStatus de e-mail a corresponder.
employeeRangesarrayFaixas de número de funcionários da organização na notação da Apollo, como 51,200.
excludeOrganizationDomainsarrayExclui pessoas cujo empregador atual corresponde a qualquer um destes domínios. Todos os domínios que a Apollo tem para esse empregador são excluídos.
headcountGrowthMonthsenumJanela retroativa em meses para o filtro de crescimento de headcount. Só tem efeito junto com minHeadcountGrowthPercent ou maxHeadcountGrowthPercent.
includeSimilarTitlesbooleanSe cargos semelhantes aos de titles também correspondem. Defina como false para apenas correspondências estritas de cargo.
jobPostedAtGtestringApenas organizações com uma vaga publicada nesta data ou depois. Formato: YYYY-MM-DD.
jobPostedAtLtestringApenas organizações com uma vaga publicada nesta data ou antes. Formato: YYYY-MM-DD.
jobPostingLocationsarrayLocalizações das vagas ativas da organização, como japan.
jobPostingTitlesarrayCargos listados nas vagas ativas da organização, como sales manager.
keywordsstringPalavras-chave a corresponder nos registros de pessoas.
limitinteger3Número máximo de pessoas retornadas nesta página.
lookalikeOrganizationIdsarrayIdentificadores de organizações da Apollo a usar como sementes de empresas semelhantes, no máximo cinco. Os resultados ficam restritos a organizações semelhantes às sementes, e as próprias sementes são excluídas. Uma semente para a qual a Apollo não tem dados de semelhança não retorna resultados.
maxHeadcountGrowthPercentintegerCrescimento máximo de headcount da organização em headcountGrowthMonths, como porcentagem inteira, por exemplo 100 para 100%.
maxJobsintegerNúmero máximo de vagas ativas na organização.
maxRevenueUsdintegerReceita anual máxima da organização, em USD inteiros e sem símbolos.
minHeadcountGrowthPercentintegerCrescimento mínimo de headcount da organização em headcountGrowthMonths, como porcentagem inteira, por exemplo 10 para 10%. Valores negativos são aceitos.
minJobsintegerNúmero mínimo de vagas ativas na organização.
minRevenueUsdintegerReceita anual mínima da organização, em USD inteiros e sem símbolos.
organizationDomainsarrayDomínios do empregador atual ou anterior da pessoa, sem www, no máximo 1000.
organizationIdsarrayIdentificadores da Apollo do empregador atual da pessoa.
organizationLocationsarrayLocalizações de sede da organização a corresponder.
pageinteger1Página de resultados, começando em 1.
personLocationsarrayLocalizações da pessoa a corresponder.
personNamestringNome da pessoa a corresponder; os resultados incluem pessoas cujo nome contém todas as palavras.
senioritiesarrayNíveis de senioridade a corresponder.
technologySlugAndarrayApenas pessoas cujo empregador atual usa TODAS estas tecnologias. Identificadores de tecnologia da Apollo, como salesforce ou google_analytics (espaços e pontos viram sublinhados). A saída technologies dos SKUs de organização da Apollo os retorna como id.
technologySlugNotarrayExclui pessoas cujo empregador atual usa qualquer uma destas tecnologias. Identificadores de tecnologia da Apollo, como salesforce ou google_analytics (espaços e pontos viram sublinhados). A saída technologies dos SKUs de organização da Apollo os retorna como id.
technologySlugOrarrayApenas pessoas cujo empregador atual usa QUALQUER uma destas tecnologias. Identificadores de tecnologia da Apollo, como salesforce ou google_analytics (espaços e pontos viram sublinhados). A saída technologies dos SKUs de organização da Apollo os retorna como id.
titlesarray["CEO"]Cargos a corresponder.
Resposta
dataobject
data.peopleobject[]People on this result page.
data.people[].firstNamestringPerson first name.
data.people[].hasCitybooleanWhether city data is available through enrichment.
data.people[].hasCountrybooleanWhether country data is available through enrichment.
data.people[].hasDirectPhonebooleanWhether direct phone data is available through asynchronous enrichment.
data.people[].hasEmailbooleanWhether an email is available through enrichment.
data.people[].hasStatebooleanWhether state or region data is available through enrichment.
data.people[].idstringStable person identifier.
data.people[].lastNameInitialstringObfuscated last-name initial.
data.people[].lastRefreshedUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.people[].organizationobjectAvailability summary for the current organization.
data.people[].organization.hasCitybooleanWhether organization city data is available.
data.people[].organization.hasCountrybooleanWhether organization country data is available.
data.people[].organization.hasEmployeeCountbooleanWhether organization employee-count data is available.
data.people[].organization.hasIndustrybooleanWhether industry data is available.
data.people[].organization.hasPhonebooleanWhether an organization phone is available.
data.people[].organization.hasPostalCodebooleanWhether organization postal-code data is available.
data.people[].organization.hasRevenuebooleanWhether organization revenue data is available.
data.people[].organization.hasStatebooleanWhether organization state data is available.
data.people[].organization.namestringCurrent organization name.
data.people[].titlestringCurrent job title.
data.totalintegerTotal matching people.
foundbooleanWhether any matching people were found.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,01
Preço /mil req.USDUS$ 10,00

Dúvidas frequentes

Sobre o endpoint Busca de pessoas da API para Apollo

O endpoint Busca de pessoas da AnyAPI para Apollo retorna dados de Apollo em JSON normalizado com uma chamada POST para /v1/run/apollo.people_search. Busque pessoas por cargo, senioridade, nome, localização, domínio ou ID do empregador, status do e-mail e receita, tecnologia, contratações e crescimento de headcount do empregador, com resumos de perfil normalizados. A AnyAPI retorna um schema normalizado, seja qual for a fonte que atende. Custa a partir de US$ 10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 85,6% das chamadas ao endpoint Busca de pessoas da API para Apollo feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,7 segundos, em 270 chamadas medidas.

Custa a partir de US$ 10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Busque pessoas por cargo, senioridade, nome, localização, domínio ou ID do empregador, status do e-mail e receita, tecnologia, contratações e crescimento de headcount do empregador, com resumos de perfil normalizados. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 85,6% das chamadas ao endpoint Busca de pessoas da API para Apollo feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,7 segundos, em 270 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de Apollo

Organizaçãoa partir de US$ 12,00 /mil req.Enriquecimento de organizaçãoa partir de US$ 12,00 /mil req.Vagas da organizaçãoa partir de US$ 12,00 /mil req.Notícias da organizaçãoa partir de US$ 12,00 /mil req.Enriquecimento de organizações em lotea partir de US$ 60,00 /mil req.Busca de organizaçõesa partir de US$ 12,00 /mil req.Enriquecimento de pessoaa partir de US$ 12,00 /mil req.