Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Ricerca nell'API People
Trova persone che corrispondono ai criteri invece di arricchire qualcuno già identificato. Filtra per qualifica, seniority, località, dominio aziendale, numero di dipendenti e settore, e pagina con page e per_page. Restituisce total_entries e un array people. Nota cosa la ricerca omette deliberatamente: le voci contengono last_name_obfuscated e flag booleani – has_email, has_direct_phone, has_city, has_state, has_country – invece dei valori stessi. La ricerca indica che esiste una corrispondenza; l'arricchimento rivela i dettagli di contatto. Passa gli ID a post_apollo_people_match o post_apollo_people_bulk_match per ottenere indirizzi e-mail e numeri di telefono; è lì che vengono spesi anche i crediti. Richiede autorizzazioni amministrative Felo.
Riferimento prezzi
- Misurazione: base di costo fissa per richiesta riuscita.
- Stima di riferimento per richiesta: USD 0.012.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array string[]contact
_email _status[] Gli stati email delle persone che vuoi trovare. Puoi aggiungere più stati per ampliare la ricerca. Gli stati disponibili per la ricerca sono: verified unverified likely to engage unavailable
- Tipo: array string[]currently
_not _using _any _of _technology _uids[] Escludi le persone dalla ricerca in base a una qualsiasi delle tecnologie usate dal loro datore di lavoro attuale. Apollo supporta il filtraggio per oltre 1.500 tecnologie. Apollo calcola i dati sulle tecnologie da più fonti. Questi dati vengono aggiornati regolarmente. Scarica questo file CSV per l'elenco completo delle tecnologie supportate. Per le tecnologie elencate nel file CSV, sostituisci spazi e punti con caratteri di sottolineatura (_). Esempi: salesforce; google_analytics; wordpress_org
- Tipo: array string[]currently
_using _all _of _technology _uids[] Trova persone in base a tutte le tecnologie usate dal loro datore di lavoro attuale. Apollo supporta il filtraggio per oltre 1.500 tecnologie. Apollo calcola i dati sulle tecnologie da più fonti. Questi dati vengono aggiornati regolarmente. Scarica questo file CSV per l'elenco completo delle tecnologie supportate. Per le tecnologie elencate nel file CSV, sostituisci spazi e punti con caratteri di sottolineatura (_). Esempi: salesforce; google_analytics; wordpress_org
- Tipo: array string[]currently
_using _any _of _technology _uids[] Trova persone in base a una qualsiasi delle tecnologie usate dal loro datore di lavoro attuale. Apollo supporta il filtraggio per oltre 1.500 tecnologie. Apollo calcola i dati sulle tecnologie da più fonti. Questi dati vengono aggiornati regolarmente. Scarica questo file CSV per l'elenco completo delle tecnologie supportate. Per le tecnologie elencate nel file CSV, sostituisci spazi e punti con caratteri di sottolineatura (_). Esempi: salesforce; google_analytics; wordpress_org
- Tipo: booleaninclude
_similar _titles Questo parametro determina se nella risposta vengono restituite persone con titoli professionali simili a quelli definiti nel parametro person_titles[]. Imposta questo parametro su false quando usi person_titles[] per restituire solo corrispondenze esatte dei titoli professionali.
- Tipo: array string[]organization
_ids[] Gli ID Apollo delle aziende (datori di lavoro) da includere nei risultati della ricerca. A ogni azienda nel database Apollo è assegnato un ID univoco. Per trovare gli ID, chiama l'endpoint Organization Search e individua i valori di organization_id. Esempio: 5e66b6381e05b4008c8331b8
- Tipo: array string[]organization
_job _locations[] Le località degli annunci di lavoro per cui il datore di lavoro della persona sta assumendo attivamente. Esempi: atlanta; japan
- Tipo: stringorganization
_job _posted _at _range[max] La data più recente in cui il datore di lavoro attuale della persona ha pubblicato annunci di lavoro. Usa questo parametro insieme a organization_job_posted_at_range[min] per impostare un intervallo di date di pubblicazione. Esempio: 2025-09-25
- Tipo: stringorganization
_job _posted _at _range[min] La data meno recente in cui il datore di lavoro attuale della persona ha pubblicato annunci di lavoro. Usa questo parametro insieme a organization_job_posted_at_range[max] per impostare un intervallo di date di pubblicazione. Esempio: 2025-07-25
- Tipo: array string[]organization
_locations[] La sede del quartier generale del datore di lavoro attuale della persona. Puoi cercare tra città, stati degli Stati Uniti e paesi. Se un'azienda ha più uffici, i risultati si basano comunque sulla sede centrale. Ad esempio, se cerchi chicago ma la sede di un'azienda è a boston, le persone che lavorano per quell'azienda con sede a Boston non compariranno nei risultati, anche se soddisfano altri parametri. Per trovare persone in base alla loro posizione personale, usa il parametro person_locations. Esempi: texas; tokyo; spain
- Tipo: array string[]organization
_num _employees _ranges[] L'intervallo del numero di dipendenti dell'azienda attuale della persona. Consente di trovare persone in base alla dimensione del loro datore di lavoro. Puoi aggiungere più intervalli per ampliare i risultati della ricerca. Ogni intervallo deve essere una stringa, con i numeri inferiore e superiore separati solo da una virgola. Esempi: 1,10; 250,500; 10000,20000
- Tipo: integerorganization
_num _jobs _range[max] Il numero massimo di annunci di lavoro attivi presso il datore di lavoro attuale della persona. Usa questo parametro insieme a organization_num_jobs_range[min] per impostare un intervallo di annunci di lavoro. Esempi: 50; 500
- Tipo: integerorganization
_num _jobs _range[min] Il numero minimo di annunci di lavoro attivi presso il datore di lavoro attuale della persona. Usa questo parametro insieme a organization_num_jobs_range[max] per impostare un intervallo di annunci di lavoro. Esempi: 50; 500
- Tipo: integerpage
Il numero di pagina dei dati Apollo che vuoi recuperare. Usa questo parametro insieme al parametro per_page per rendere i risultati della ricerca più gestibili e migliorare le prestazioni dell'endpoint. Esempio: 4
- Tipo: integerper
_page Il numero di risultati di ricerca da restituire per ogni pagina. Limitare il numero di risultati per pagina migliora le prestazioni dell'endpoint. Usa il parametro page per cercare nelle diverse pagine di dati. Esempio: 10
- Tipo: array string[]person
_locations[] Il luogo in cui vivono le persone. Puoi cercare tra città, stati degli Stati Uniti e paesi. Per trovare persone in base alla sede del loro datore di lavoro attuale, usa il parametro organization_locations. Esempi: california; ireland; chicago
- Tipo: array string[]person
_seniorities[] La seniority professionale che le persone ricoprono presso il loro datore di lavoro attuale. Consente di trovare persone che attualmente occupano posizioni a determinati livelli gerarchici, come livello Director o livello IC senior. Per essere inclusa nei risultati, una persona deve corrispondere solo a 1 delle seniority aggiunte. Aggiungere più seniority amplia i risultati della ricerca. Le ricerche restituiscono risultati solo in base al titolo professionale attuale, quindi cercare dipendenti di livello Director restituisce solo persone che attualmente hanno un titolo di livello Director. Chi è stato Director in passato ma ora è VP non viene incluso nei risultati. Usa questo parametro insieme a person_titles[] per trovare persone in base a specifiche funzioni aziendali e livelli di seniority. Per questo parametro sono disponibili le seguenti opzioni: owner founder c_suite partner vp head director manager senior entry intern
- Tipo: array string[]person
_titles[] I titoli professionali delle persone che vuoi trovare. Per essere inclusa nei risultati, una persona deve corrispondere solo a 1 dei titoli aggiunti. Aggiungere più titoli amplia i risultati della ricerca. I risultati includono anche titoli professionali con gli stessi termini, anche se non sono corrispondenze esatte. Ad esempio, cercando marketing manager si possono ottenere persone con il titolo content marketing manager. Usa questo parametro insieme a person_seniorities[] per trovare persone in base a specifiche funzioni aziendali e livelli di seniority. Esempi: sales development representative; marketing manager; research analyst
- Tipo: stringq
_keywords Una stringa di parole su cui filtrare i risultati.
- Tipo: array string[]q
_organization _domains _list[] Il nome di dominio del datore di lavoro della persona. Può essere il datore di lavoro attuale o uno precedente. Non includere www., il simbolo @ o elementi simili. Questo parametro accetta fino a 1.000 domini per singola richiesta. Esempi: apollo.io; microsoft.com
- Tipo: array string[]q
_organization _job _titles[] I titoli professionali indicati negli annunci di lavoro attivi presso il datore di lavoro attuale della persona. Esempi: sales manager; research analyst
- Tipo: integerrevenue
_range[max] Il fatturato massimo generato dal datore di lavoro attuale della persona. Usa questo parametro insieme a revenue_range[min] per impostare un intervallo di fatturato. Non inserire simboli di valuta, virgole o punti decimali nel valore. Esempi: 500000; 1500000
- Tipo: integerrevenue
_range[min] Il fatturato minimo generato dal datore di lavoro attuale della persona. Usa questo parametro insieme a revenue_range[max] per impostare un intervallo di fatturato. Non inserire simboli di valuta, virgole o punti decimali nel valore. Esempi: 500000; 1500000
- Tipo: object200
Risposta riuscita
- Tipo: array string[]people
Array di risposta
- Tipo: integertotal
_entries Campo di risposta
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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"
]
}