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 にある場合、そのボストン拠点の企業で働く人物は、他のパラメータに一致していても結果に表示されません。人物の個人的な所在地に基づいて検索するには、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 各ページで返す検索結果数です。1 ページあたりの結果数を制限すると、エンドポイントのパフォーマンスが向上します。page パラメータを使用して、データの各ページを検索します。例：10
- 型: array string[]person
_locations[] 人物が居住している場所です。都市、米国の州、国をまたいで検索できます。現在の雇用主の本社所在地に基づいて人物を検索するには、organization_locations パラメータを使用します。例：california; ireland; chicago
- 型: array string[]person
_seniorities[] 人物が現在の雇用主内で持つ職位のシニアリティです。これにより、ディレクターレベルやシニア IC レベルなど、特定の報告階層の職に現在就いている人物を検索できます。検索結果に含まれるには、追加したシニアリティの 1 つに一致すれば十分です。シニアリティを増やすと検索結果が広がります。検索は現在の役職名のみに基づいて結果を返すため、ディレクターレベルの従業員を検索すると、現在ディレクターレベルの役職を持つ人物だけが返ります。以前はディレクターだったが現在は VP という人物は、検索結果に含まれません。person_titles[] パラメータと組み合わせて使用すると、特定の職能とシニアリティレベルに基づいて人物を検索できます。このパラメータでは次のオプションを使用できます：owner founder c_suite partner vp head director manager senior entry intern
- 型: array string[]person
_titles[] 検索する人物が持つ役職名です。検索結果に含まれるには、追加した役職名の 1 つに一致すれば十分です。役職名を増やすと検索結果が広がります。結果には、完全一致でなくても同じ語を含む役職名が含まれます。たとえば marketing manager を検索すると、役職名が content marketing manager の人物が返ることがあります。person_seniorities[] パラメータと組み合わせて使用すると、特定の職能とシニアリティレベルに基づいて人物を検索できます。例：sales development representative; marketing manager; research analyst
- 型: stringq
_keywords 結果を絞り込むための単語文字列です。
- 型: array string[]q
_organization _domains _list[] 人物の雇用主のドメイン名です。現在の雇用主でも以前の雇用主でもかまいません。www.、@ 記号などを含めないでください。このパラメータは 1 回のリクエストで最大 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"
]
}