# Tìm kiếm People API

**API:** Data API

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

**Tags:** Apollo

Tìm những người khớp với tiêu chí thay vì làm giàu thông tin của một người bạn đã xác định. Lọc theo chức danh, cấp bậc, vị trí, tên miền công ty, số lượng nhân viên và ngành, rồi phân trang bằng `page` và `per_page`. Trả về `total_entries` và mảng `people`. Lưu ý điều mà tìm kiếm cố ý không cung cấp: các mục mang `last_name_obfuscated` và cờ boolean — `has_email`, `has_direct_phone`, `has_city`, `has_state`, `has_country` — thay vì chính các giá trị. Tìm kiếm cho bạn biết có kết quả khớp; làm giàu dữ liệu mới tiết lộ thông tin liên hệ. Đưa các id vào `post_apollo_people_match` hoặc `post_apollo_people_bulk_match` để lấy email và số điện thoại, đây cũng là nơi tiêu tín dụng. Yêu cầu quyền quản trị Felo.

### Tham chiếu giá

- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của 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 | Trạng thái email của những người bạn muốn tìm. Bạn có thể thêm nhiều trạng thái để mở rộng tìm kiếm. Các trạng thái có thể tìm gồm: verified unverified likely to engage unavailable |
| `currently_not_using_any_of_technology_uids[]` | query | no | array | Loại trừ mọi người khỏi kết quả tìm kiếm dựa trên bất kỳ công nghệ nào mà nhà tuyển dụng hiện tại của họ sử dụng. Apollo hỗ trợ lọc theo hơn 1.500 công nghệ. Apollo tính toán dữ liệu công nghệ từ nhiều nguồn. Dữ liệu này được cập nhật thường xuyên. Xem danh sách đầy đủ các công nghệ được hỗ trợ bằng cách tải xuống tệp CSV này. Dùng dấu gạch dưới (_) thay cho dấu cách và dấu chấm đối với các công nghệ trong tệp CSV. Ví dụ: salesforce; google_analytics; wordpress_org |
| `currently_using_all_of_technology_uids[]` | query | no | array | Tìm người dựa trên tất cả công nghệ mà nhà tuyển dụng hiện tại của họ sử dụng. Apollo hỗ trợ lọc theo hơn 1.500 công nghệ. Apollo tính toán dữ liệu công nghệ từ nhiều nguồn. Dữ liệu này được cập nhật thường xuyên. Xem danh sách đầy đủ các công nghệ được hỗ trợ bằng cách tải xuống tệp CSV này. Dùng dấu gạch dưới (_) thay cho dấu cách và dấu chấm đối với các công nghệ trong tệp CSV. Ví dụ: salesforce; google_analytics; wordpress_org |
| `currently_using_any_of_technology_uids[]` | query | no | array | Tìm người dựa trên bất kỳ công nghệ nào mà nhà tuyển dụng hiện tại của họ sử dụng. Apollo hỗ trợ lọc theo hơn 1.500 công nghệ. Apollo tính toán dữ liệu công nghệ từ nhiều nguồn. Dữ liệu này được cập nhật thường xuyên. Xem danh sách đầy đủ các công nghệ được hỗ trợ bằng cách tải xuống tệp CSV này. Dùng dấu gạch dưới (_) thay cho dấu cách và dấu chấm đối với các công nghệ trong tệp CSV. Ví dụ: salesforce; google_analytics; wordpress_org |
| `include_similar_titles` | query | no | boolean | Tham số này quyết định có trả về trong phản hồi những người có chức danh tương tự các chức danh bạn định nghĩa trong tham số person_titles[] hay không. Đặt tham số này thành false khi dùng person_titles[] để chỉ trả về các kết quả khớp chính xác cho chức danh. |
| `organization_ids[]` | query | no | array | ID Apollo của các công ty (nhà tuyển dụng) bạn muốn đưa vào kết quả tìm kiếm. Mỗi công ty trong cơ sở dữ liệu Apollo được gán một ID duy nhất. Để tìm ID, hãy gọi endpoint Organization Search và xác định giá trị organization_id. Ví dụ: 5e66b6381e05b4008c8331b8 |
| `organization_job_locations[]` | query | no | array | Địa điểm của các công việc mà nhà tuyển dụng của người đó đang tích cực tuyển dụng. Ví dụ: atlanta; japan |
| `organization_job_posted_at_range[max]` | query | no | string | Ngày muộn nhất mà nhà tuyển dụng hiện tại của người đó đăng tin tuyển dụng. Dùng tham số này cùng với organization_job_posted_at_range[min] để đặt khoảng ngày đăng tin. Ví dụ: 2025-09-25 |
| `organization_job_posted_at_range[min]` | query | no | string | Ngày sớm nhất mà nhà tuyển dụng hiện tại của người đó đăng tin tuyển dụng. Dùng tham số này cùng với organization_job_posted_at_range[max] để đặt khoảng ngày đăng tin. Ví dụ: 2025-07-25 |
| `organization_locations[]` | query | no | array | Vị trí trụ sở của nhà tuyển dụng hiện tại của một người. Bạn có thể tìm kiếm theo thành phố, bang của Hoa Kỳ và quốc gia. Nếu một công ty có nhiều văn phòng, kết quả vẫn dựa trên vị trí trụ sở. Ví dụ: nếu bạn tìm chicago nhưng trụ sở công ty ở boston, những người làm việc cho công ty có trụ sở tại Boston sẽ không xuất hiện trong kết quả, kể cả khi họ khớp các tham số khác. Để tìm người dựa trên vị trí cá nhân của họ, hãy dùng tham số person_locations. Ví dụ: texas; tokyo; spain |
| `organization_num_employees_ranges[]` | query | no | array | Khoảng số lượng nhân viên đang làm việc tại công ty hiện tại của người đó. Giúp bạn tìm người dựa trên số lượng nhân viên của nhà tuyển dụng. Bạn có thể thêm nhiều khoảng để mở rộng kết quả tìm kiếm. Mỗi khoảng phải là một chuỗi, với số trên và số dưới chỉ được phân tách bằng dấu phẩy. Ví dụ: 1,10; 250,500; 10000,20000 |
| `organization_num_jobs_range[max]` | query | no | integer | Số lượng tin tuyển dụng tối đa đang hoạt động tại nhà tuyển dụng hiện tại của người đó. Dùng tham số này cùng với organization_num_jobs_range[min] để đặt khoảng tin tuyển dụng. Ví dụ: 50; 500 |
| `organization_num_jobs_range[min]` | query | no | integer | Số lượng tin tuyển dụng tối thiểu đang hoạt động tại nhà tuyển dụng hiện tại của người đó. Dùng tham số này cùng với organization_num_jobs_range[max] để đặt khoảng tin tuyển dụng. Ví dụ: 50; 500 |
| `page` | query | no | integer | Số trang dữ liệu Apollo bạn muốn truy xuất. Dùng tham số này cùng với tham số per_page để giúp kết quả tìm kiếm dễ điều hướng và cải thiện hiệu suất của endpoint. Ví dụ: 4 |
| `per_page` | query | no | integer | Số kết quả tìm kiếm trả về cho mỗi trang. Giới hạn số kết quả mỗi trang cải thiện hiệu suất của endpoint. Dùng tham số page để tìm kiếm trên các trang dữ liệu khác nhau. Ví dụ: 10 |
| `person_locations[]` | query | no | array | Nơi mọi người sinh sống. Bạn có thể tìm kiếm theo thành phố, bang của Hoa Kỳ và quốc gia. Để tìm người dựa trên vị trí trụ sở của nhà tuyển dụng hiện tại, hãy dùng tham số organization_locations. Ví dụ: california; ireland; chicago |
| `person_seniorities[]` | query | no | array | Cấp bậc công việc mà mọi người nắm giữ tại nhà tuyển dụng hiện tại. Giúp bạn tìm những người hiện đang giữ vị trí ở các cấp báo cáo nhất định, như cấp Director hoặc IC cấp cao. Để được đưa vào kết quả tìm kiếm, một người chỉ cần khớp 1 trong các cấp bậc bạn thêm. Thêm nhiều cấp bậc sẽ mở rộng kết quả tìm kiếm. Tìm kiếm chỉ trả kết quả dựa trên chức danh hiện tại, nên tìm nhân viên cấp Director chỉ trả về những người hiện giữ chức danh cấp Director. Nếu ai đó từng là Director nhưng hiện là VP, họ sẽ không có trong kết quả tìm kiếm. Dùng tham số này cùng với tham số person_titles[] để tìm người dựa trên chức năng công việc và cấp bậc cụ thể. Có thể dùng các tùy chọn sau cho tham số này: owner founder c_suite partner vp head director manager senior entry intern |
| `person_titles[]` | query | no | array | Chức danh của những người bạn muốn tìm. Để được đưa vào kết quả tìm kiếm, một người chỉ cần khớp 1 trong các chức danh bạn thêm. Thêm nhiều chức danh sẽ mở rộng kết quả tìm kiếm. Kết quả cũng bao gồm các chức danh có cùng thuật ngữ, kể cả khi không khớp chính xác. Ví dụ: tìm marketing manager có thể trả về người có chức danh content marketing manager. Dùng tham số này cùng với tham số person_seniorities[] để tìm người dựa trên chức năng công việc và cấp bậc cụ thể. Ví dụ: sales development representative; marketing manager; research analyst |
| `q_keywords` | query | no | string | Một chuỗi từ dùng để lọc kết quả. |
| `q_organization_domains_list[]` | query | no | array | Tên miền của nhà tuyển dụng của người đó. Có thể là nhà tuyển dụng hiện tại hoặc trước đây. Không bao gồm www., ký hiệu @ hoặc tương tự. Tham số này chấp nhận tối đa 1.000 tên miền trong một yêu cầu. Ví dụ: apollo.io; microsoft.com |
| `q_organization_job_titles[]` | query | no | array | Các chức danh được liệt kê trong tin tuyển dụng đang hoạt động tại nhà tuyển dụng hiện tại của người đó. Ví dụ: sales manager; research analyst |
| `revenue_range[max]` | query | no | integer | Doanh thu tối đa mà nhà tuyển dụng hiện tại của người đó tạo ra. Dùng tham số này cùng với revenue_range[min] để đặt khoảng doanh thu. Không nhập ký hiệu tiền tệ, dấu phẩy hoặc dấu thập phân vào con số. Ví dụ: 500000; 1500000 |
| `revenue_range[min]` | query | no | integer | Doanh thu tối thiểu mà nhà tuyển dụng hiện tại của người đó tạo ra. Dùng tham số này cùng với revenue_range[max] để đặt khoảng doanh thu. Không nhập ký hiệu tiền tệ, dấu phẩy hoặc dấu thập phân vào con số. Ví dụ: 500000; 1500000 |

## Responses

### 200 — Phản hồi thành công

Headers:
- `X-Request-Id` (string) — Mã định danh yêu cầu cần bao gồm khi liên hệ bộ phận hỗ trợ Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "total_entries": {
      "type": "integer",
      "description": "Trường phản hồi"
    },
    "people": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Mảng phản hồi"
    }
  }
}
```

### 400 — Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

### 401 — Cần có khóa API Felo hợp lệ.

### 402 — Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

### 403 — Tài khoản không được phép thực hiện thao tác này.

### 429 — Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

### 502 — Dịch vụ không thể hoàn tất yêu cầu.

### 503 — API hoặc dịch vụ thanh toán tạm thời không khả dụng.

### 504 — Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

### default — Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

**application/json**

Schema:

```json
{}
```
