# People API 検索

**API:** Data API

**Endpoint:** `POST /v1/beta/apollo/mixed_people/api_search`

**Tags:** Apollo

すでに特定した人物を情報拡充するのではなく、条件に一致する人物を検索します。役職、シニアリティ、所在地、会社ドメイン、従業員数、業界で絞り込み、`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 の請求記録に従います。

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `contact_email_status[]` | query | no | array | 検索する人物のメールステータスです。複数のステータスを追加して検索を広げられます。検索できるステータスは次のとおりです：verified unverified likely to engage unavailable |
| `currently_not_using_any_of_technology_uids[]` | query | no | array | 人物の現在の雇用主が使用しているいずれかの技術に基づいて、検索から人物を除外します。Apollo は 1,500 以上の技術による絞り込みをサポートしています。Apollo は複数のソースから技術データを算出し、定期的に更新します。この CSV ファイルをダウンロードすると、サポートされている技術の完全な一覧を確認できます。CSV ファイルに記載されている技術については、スペースとピリオドをアンダースコア (_) に置き換えてください。例：salesforce; google_analytics; wordpress_org |
| `currently_using_all_of_technology_uids[]` | query | no | array | 人物の現在の雇用主が使用しているすべての技術に基づいて人物を検索します。Apollo は 1,500 以上の技術による絞り込みをサポートしています。Apollo は複数のソースから技術データを算出し、定期的に更新します。この CSV ファイルをダウンロードすると、サポートされている技術の完全な一覧を確認できます。CSV ファイルに記載されている技術については、スペースとピリオドをアンダースコア (_) に置き換えてください。例：salesforce; google_analytics; wordpress_org |
| `currently_using_any_of_technology_uids[]` | query | no | array | 人物の現在の雇用主が使用しているいずれかの技術に基づいて人物を検索します。Apollo は 1,500 以上の技術による絞り込みをサポートしています。Apollo は複数のソースから技術データを算出し、定期的に更新します。この CSV ファイルをダウンロードすると、サポートされている技術の完全な一覧を確認できます。CSV ファイルに記載されている技術については、スペースとピリオドをアンダースコア (_) に置き換えてください。例：salesforce; google_analytics; wordpress_org |
| `include_similar_titles` | query | no | boolean | このパラメータは、person_titles[] パラメータで定義した役職名に似た役職名の人物をレスポンスに含めるかどうかを決定します。person_titles[] を使用して役職名の厳密一致のみを返す場合は、このパラメータを false に設定してください。 |
| `organization_ids[]` | query | no | array | 検索結果に含める企業（雇用主）の Apollo ID です。Apollo データベースの各企業には一意の ID が割り当てられています。ID を調べるには、Organization Search エンドポイントを呼び出し、organization_id の値を確認してください。例：5e66b6381e05b4008c8331b8 |
| `organization_job_locations[]` | query | no | array | 人物の雇用主が積極的に採用している求人の勤務地です。例：atlanta; japan |
| `organization_job_posted_at_range[max]` | query | no | string | 人物の現在の雇用主が求人を掲載した最新日です。organization_job_posted_at_range[min] と組み合わせて使用すると、求人の掲載日の範囲を設定できます。例：2025-09-25 |
| `organization_job_posted_at_range[min]` | query | no | string | 人物の現在の雇用主が求人を掲載した最も早い日です。organization_job_posted_at_range[max] と組み合わせて使用すると、求人の掲載日の範囲を設定できます。例：2025-07-25 |
| `organization_locations[]` | query | no | array | 人物の現在の雇用主の本社所在地です。都市、米国の州、国をまたいで検索できます。企業に複数の拠点がある場合も、結果は本社所在地に基づきます。たとえば chicago を検索しても、企業の本社が boston にある場合、そのボストン拠点の企業で働く人物は、他のパラメータに一致していても結果に表示されません。人物の個人的な所在地に基づいて検索するには、person_locations パラメータを使用します。例：texas; tokyo; spain |
| `organization_num_employees_ranges[]` | query | no | array | 人物の現在の会社で働く従業員数の範囲です。雇用主の従業員数に基づいて人物を検索できます。範囲は複数追加して検索結果を広げられます。追加する各範囲は文字列で、範囲の上限と下限はカンマのみで区切ります。例：1,10; 250,500; 10000,20000 |
| `organization_num_jobs_range[max]` | query | no | integer | 人物の現在の雇用主で有効な求人件数の上限です。organization_num_jobs_range[min] と組み合わせて使用すると、求人件数の範囲を設定できます。例：50; 500 |
| `organization_num_jobs_range[min]` | query | no | integer | 人物の現在の雇用主で有効な求人件数の下限です。organization_num_jobs_range[max] と組み合わせて使用すると、求人件数の範囲を設定できます。例：50; 500 |
| `page` | query | no | integer | 取得する Apollo データのページ番号です。per_page パラメータと組み合わせて使用すると、検索結果をページ送りでき、エンドポイントのパフォーマンスが向上します。例：4 |
| `per_page` | query | no | integer | 各ページで返す検索結果数です。1 ページあたりの結果数を制限すると、エンドポイントのパフォーマンスが向上します。page パラメータを使用して、データの各ページを検索します。例：10 |
| `person_locations[]` | query | no | array | 人物が居住している場所です。都市、米国の州、国をまたいで検索できます。現在の雇用主の本社所在地に基づいて人物を検索するには、organization_locations パラメータを使用します。例：california; ireland; chicago |
| `person_seniorities[]` | query | no | array | 人物が現在の雇用主内で持つ職位のシニアリティです。これにより、ディレクターレベルやシニア IC レベルなど、特定の報告階層の職に現在就いている人物を検索できます。検索結果に含まれるには、追加したシニアリティの 1 つに一致すれば十分です。シニアリティを増やすと検索結果が広がります。検索は現在の役職名のみに基づいて結果を返すため、ディレクターレベルの従業員を検索すると、現在ディレクターレベルの役職を持つ人物だけが返ります。以前はディレクターだったが現在は VP という人物は、検索結果に含まれません。person_titles[] パラメータと組み合わせて使用すると、特定の職能とシニアリティレベルに基づいて人物を検索できます。このパラメータでは次のオプションを使用できます：owner founder c_suite partner vp head director manager senior entry intern |
| `person_titles[]` | query | no | array | 検索する人物が持つ役職名です。検索結果に含まれるには、追加した役職名の 1 つに一致すれば十分です。役職名を増やすと検索結果が広がります。結果には、完全一致でなくても同じ語を含む役職名が含まれます。たとえば marketing manager を検索すると、役職名が content marketing manager の人物が返ることがあります。person_seniorities[] パラメータと組み合わせて使用すると、特定の職能とシニアリティレベルに基づいて人物を検索できます。例：sales development representative; marketing manager; research analyst |
| `q_keywords` | query | no | string | 結果を絞り込むための単語文字列です。 |
| `q_organization_domains_list[]` | query | no | array | 人物の雇用主のドメイン名です。現在の雇用主でも以前の雇用主でもかまいません。www.、@ 記号などを含めないでください。このパラメータは 1 回のリクエストで最大 1,000 件のドメインを受け付けます。例：apollo.io; microsoft.com |
| `q_organization_job_titles[]` | query | no | array | 人物の現在の雇用主の有効な求人に記載されている役職名です。例：sales manager; research analyst |
| `revenue_range[max]` | query | no | integer | 人物の現在の雇用主が生み出す売上高の上限です。revenue_range[min] と組み合わせて使用すると、売上高の範囲を設定できます。金額には通貨記号、カンマ、小数点を入力しないでください。例：500000; 1500000 |
| `revenue_range[min]` | query | no | integer | 人物の現在の雇用主が生み出す売上高の下限です。revenue_range[max] と組み合わせて使用すると、売上高の範囲を設定できます。金額には通貨記号、カンマ、小数点を入力しないでください。例：500000; 1500000 |

## Responses

### 200 — 成功レスポンス

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "total_entries": {
      "type": "integer",
      "description": "レスポンスフィールド"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "レスポンス配列"
    }
  }
}
```

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**application/json**

Schema:

```json
{}
```