Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
People API 검색
이미 식별한 사람을 보강하는 대신 조건에 맞는 사람을 찾습니다. 직함, 직급, 위치, 회사 도메인, 직원 수, 업종으로 필터링하고 page와 per_page로 페이지를 나눕니다. total_entries와 people 배열을 반환합니다. 검색이 의도적으로 숨기는 항목에 유의하세요. 항목에는 실제 값 대신 last_name_obfuscated와 불리언 플래그(has_email, has_direct_phone, has_city, has_state, has_country)가 포함됩니다. 검색은 일치 항목이 있음을 알려 주고, 보강은 연락처 정보를 드러냅니다. id를 post_apollo_people_match 또는 post_apollo_people_bulk_match에 전달하면 이메일과 전화번호를 얻을 수 있으며, 크레딧도 이 단계에서 소비됩니다. Felo 관리자 권한이 필요합니다.
가격 참고
- 과금 방식: 성공한 요청당 고정 원가 기준.
- 참조 요청 추정치: USD 0.012.
참조 메타데이터일 뿐이며 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: array string[]contact
_email _status[] 찾으려는 인물의 이메일 상태입니다. 상태를 여러 개 추가하면 검색 범위가 넓어집니다. 검색할 수 있는 상태는 verified unverified likely to engage unavailable입니다.
- 유형: array string[]currently
_not _using _any _of _technology _uids[] 현재 고용주가 사용하는 기술 중 하나라도 기준으로 인물을 검색에서 제외합니다. Apollo는 1,500개 이상의 기술로 필터링할 수 있습니다. Apollo는 여러 출처에서 기술 데이터를 계산하며, 이 데이터는 정기적으로 업데이트됩니다. 지원되는 기술의 전체 목록은 이 CSV 파일을 다운로드하여 확인하세요. CSV 파일에 나열된 기술의 공백과 마침표는 밑줄(_)로 바꿔 사용하세요. 예: salesforce; google_analytics; wordpress_org
- 유형: array string[]currently
_using _all _of _technology _uids[] 현재 고용주가 사용하는 모든 기술을 기준으로 인물을 찾습니다. Apollo는 1,500개 이상의 기술로 필터링할 수 있습니다. Apollo는 여러 출처에서 기술 데이터를 계산하며, 이 데이터는 정기적으로 업데이트됩니다. 지원되는 기술의 전체 목록은 이 CSV 파일을 다운로드하여 확인하세요. CSV 파일에 나열된 기술의 공백과 마침표는 밑줄(_)로 바꿔 사용하세요. 예: salesforce; google_analytics; wordpress_org
- 유형: array string[]currently
_using _any _of _technology _uids[] 현재 고용주가 사용하는 기술 중 하나라도 기준으로 인물을 찾습니다. Apollo는 1,500개 이상의 기술로 필터링할 수 있습니다. Apollo는 여러 출처에서 기술 데이터를 계산하며, 이 데이터는 정기적으로 업데이트됩니다. 지원되는 기술의 전체 목록은 이 CSV 파일을 다운로드하여 확인하세요. CSV 파일에 나열된 기술의 공백과 마침표는 밑줄(_)로 바꿔 사용하세요. 예: salesforce; google_analytics; wordpress_org
- 유형: booleaninclude
_similar _titles 이 매개변수는 person_titles[] 매개변수에 정의한 직무명과 유사한 직무명을 가진 인물을 응답에 포함할지 결정합니다. person_titles[]로 직무명의 엄격한 일치 항목만 반환하려면 이 매개변수를 false로 설정하세요.
- 유형: array string[]organization
_ids[] 검색 결과에 포함할 기업(고용주)의 Apollo ID입니다. Apollo 데이터베이스의 각 기업에는 고유 ID가 할당됩니다. ID를 찾으려면 Organization Search 엔드포인트를 호출하여 organization_id 값을 확인하세요. 예: 5e66b6381e05b4008c8331b8
- 유형: array string[]organization
_job _locations[] 인물의 고용주가 현재 채용 중인 직무의 위치입니다. 예: atlanta; japan
- 유형: stringorganization
_job _posted _at _range[max] 인물의 현재 고용주가 채용 공고를 게시한 가장 최근 날짜입니다. organization_job_posted_at_range[min]과 함께 사용하여 공고 게시 날짜 범위를 설정하세요. 예: 2025-09-25
- 유형: stringorganization
_job _posted _at _range[min] 인물의 현재 고용주가 채용 공고를 게시한 가장 이른 날짜입니다. organization_job_posted_at_range[max]와 함께 사용하여 공고 게시 날짜 범위를 설정하세요. 예: 2025-07-25
- 유형: array string[]organization
_locations[] 인물의 현재 고용주 본사 위치입니다. 도시, 미국 주, 국가를 기준으로 검색할 수 있습니다. 기업에 여러 사무소가 있더라도 결과는 본사 위치를 기준으로 합니다. 예를 들어 chicago를 검색했는데 기업 본사가 boston에 있으면, 다른 매개변수와 일치하더라도 Boston 소재 기업의 직원은 결과에 나타나지 않습니다. 개인 위치를 기준으로 인물을 찾으려면 person_locations 매개변수를 사용하세요. 예: texas; tokyo; spain
- 유형: array string[]organization
_num _employees _ranges[] 인물의 현재 기업에서 근무하는 직원 수 범위입니다. 고용주의 직원 수를 기준으로 인물을 찾을 수 있습니다. 범위를 여러 개 추가하면 검색 결과가 넓어집니다. 추가하는 각 범위는 문자열이어야 하며, 범위의 상한과 하한 숫자는 쉼표로만 구분합니다. 예: 1,10; 250,500; 10000,20000
- 유형: integerorganization
_num _jobs _range[max] 인물의 현재 고용주에서 활성 상태인 채용 공고의 최대 수입니다. organization_num_jobs_range[min]과 함께 사용하여 채용 공고 범위를 설정하세요. 예: 50; 500
- 유형: integerorganization
_num _jobs _range[min] 인물의 현재 고용주에서 활성 상태인 채용 공고의 최소 수입니다. organization_num_jobs_range[max]와 함께 사용하여 채용 공고 범위를 설정하세요. 예: 50; 500
- 유형: integerpage
가져올 Apollo 데이터의 페이지 번호입니다. per_page 매개변수와 함께 사용하면 검색 결과를 탐색할 수 있고 엔드포인트 성능도 향상됩니다. 예: 4
- 유형: integerper
_page 페이지당 반환할 검색 결과 수입니다. 페이지당 결과 수를 제한하면 엔드포인트 성능이 향상됩니다. page 매개변수로 여러 데이터 페이지를 검색하세요. 예: 10
- 유형: array string[]person
_locations[] 인물이 거주하는 위치입니다. 도시, 미국 주, 국가를 기준으로 검색할 수 있습니다. 현재 고용주의 본사 위치를 기준으로 인물을 찾으려면 organization_locations 매개변수를 사용하세요. 예: california; ireland; chicago
- 유형: array string[]person
_seniorities[] 인물이 현재 고용주 내에서 맡은 직급입니다. 이를 통해 Director급이나 시니어 IC급처럼 특정 보고 체계 수준의 직위를 현재 보유한 인물을 찾을 수 있습니다. 검색 결과에 포함되려면 추가한 직급 중 하나만 일치하면 됩니다. 직급을 더 추가하면 검색 결과가 넓어집니다. 검색은 현재 직무명만 기준으로 하므로, Director급 직원을 검색하면 현재 Director급 직무명을 보유한 인물만 반환됩니다. 이전에 Director였지만 현재 VP인 사람은 검색 결과에 포함되지 않습니다. 특정 직무 기능과 직급을 기준으로 인물을 찾으려면 person_titles[] 매개변수와 함께 사용하세요. 이 매개변수에는 다음 옵션을 사용할 수 있습니다: owner founder c_suite partner vp head director manager senior entry intern
- 유형: array string[]person
_titles[] 찾으려는 인물이 보유한 직무명입니다. 검색 결과에 포함되려면 추가한 직무명 중 하나만 일치하면 됩니다. 직무명을 더 추가하면 검색 결과가 넓어집니다. 결과에는 정확히 일치하지 않더라도 같은 용어를 포함한 직무명도 포함됩니다. 예를 들어 marketing manager를 검색하면 content marketing manager라는 직무명을 가진 인물이 반환될 수 있습니다. 특정 직무 기능과 직급을 기준으로 인물을 찾으려면 person_seniorities[] 매개변수와 함께 사용하세요. 예: sales development representative; marketing manager; research analyst
- 유형: stringq
_keywords 결과를 필터링할 단어 문자열입니다.
- 유형: array string[]q
_organization _domains _list[] 인물 고용주의 도메인 이름입니다. 현재 고용주 또는 이전 고용주일 수 있습니다. www., @ 기호 등은 포함하지 마세요. 이 매개변수는 한 요청에서 최대 1,000개의 도메인을 허용합니다. 예: apollo.io; microsoft.com
- 유형: array string[]q
_organization _job _titles[] 인물의 현재 고용주가 게시한 활성 채용 공고에 나열된 직무명입니다. 예: sales manager; research analyst
- 유형: integerrevenue
_range[max] 인물의 현재 고용주가 창출하는 최대 매출입니다. revenue_range[min]과 함께 사용하여 매출 범위를 설정하세요. 숫자에 통화 기호, 쉼표, 소수점을 입력하지 마세요. 예: 500000; 1500000
- 유형: integerrevenue
_range[min] 인물의 현재 고용주가 창출하는 최소 매출입니다. revenue_range[max]와 함께 사용하여 매출 범위를 설정하세요. 숫자에 통화 기호, 쉼표, 소수점을 입력하지 마세요. 예: 500000; 1500000
- 유형: object200
성공 응답
- 유형: array string[]people
응답 배열
- 유형: integertotal
_entries 응답 필드
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
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"
]
}