# 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 | 每頁應傳回的搜尋結果數量。限制每頁結果數可提升端點效能。使用 page 參數可搜尋不同頁的資料。範例：10 |
| `person_locations[]` | query | no | array | 人員居住的地點。可跨城市、美國各州和國家搜尋。若要依人員目前雇主的總部位置尋找人員，請使用 organization_locations 參數。範例：california; ireland; chicago |
| `person_seniorities[]` | query | no | array | 人員在目前雇主中擔任的職位資歷。可據此尋找目前處於特定匯報層級的人員，例如總監級或資深 IC 級。人員只要符合你新增的任一資歷，就會納入搜尋結果。新增更多資歷會擴大搜尋結果。搜尋僅依目前職稱傳回結果，因此搜尋總監級員工只會傳回目前持有總監級職稱的人員。如果某人過去是總監，但目前是副總裁，就不會納入搜尋結果。將此參數與 person_titles[] 參數搭配使用，可依特定職能與資歷層級尋找人員。此參數可使用下列選項：owner founder c_suite partner vp head director manager senior entry intern |
| `person_titles[]` | query | no | array | 想尋找之人員持有的職稱。人員只要符合你新增的任一職稱，就會納入搜尋結果。新增更多職稱會擴大搜尋結果。結果也會包含使用相同詞語的職稱，即使並非完全相符。例如搜尋 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,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
{}
```