Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Tìm kiếm People API
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.
- Kiểu: array string[]contact
_email _status[] 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
- Kiểu: array string[]currently
_not _using _any _of _technology _uids[] 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
- Kiểu: array string[]currently
_using _all _of _technology _uids[] 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
- Kiểu: array string[]currently
_using _any _of _technology _uids[] 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
- Kiểu: booleaninclude
_similar _titles 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.
- Kiểu: array string[]organization
_ids[] 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
- Kiểu: array string[]organization
_job _locations[] Đị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
- Kiểu: stringorganization
_job _posted _at _range[max] 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
- Kiểu: stringorganization
_job _posted _at _range[min] 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
- Kiểu: array string[]organization
_locations[] 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
- Kiểu: array string[]organization
_num _employees _ranges[] 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
- Kiểu: integerorganization
_num _jobs _range[max] 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
- Kiểu: integerorganization
_num _jobs _range[min] 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
- Kiểu: integerpage
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
- Kiểu: integerper
_page 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
- Kiểu: array string[]person
_locations[] 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
- Kiểu: array string[]person
_seniorities[] 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
- Kiểu: array string[]person
_titles[] 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
- Kiểu: stringq
_keywords Một chuỗi từ dùng để lọc kết quả.
- Kiểu: array string[]q
_organization _domains _list[] 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
- Kiểu: array string[]q
_organization _job _titles[] 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
- Kiểu: integerrevenue
_range[max] 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
- Kiểu: integerrevenue
_range[min] 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
- Kiểu: object200
Phản hồi thành công
- Kiểu: array string[]people
Mảng phản hồi
- Kiểu: integertotal
_entries Trường phản hồi
application/json - 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
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"
]
}