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[] ในการตอบกลับหรือไม่ ตั้งค่าพารามิเตอร์นี้เป็น false เมื่อใช้ person_titles[] เพื่อคืนเฉพาะตำแหน่งงานที่ตรงกันแบบเข้มงวด
- ประเภท: array string[]organization
_ids[] Apollo ID ของบริษัท (นายจ้าง) ที่คุณต้องการรวมในผลการค้นหา บริษัทแต่ละแห่งในฐานข้อมูล Apollo จะได้รับ ID เฉพาะ หากต้องการค้นหา ID ให้เรียก endpoint 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 บุคคลที่ทำงานให้บริษัทซึ่งตั้งอยู่ใน 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 เพื่อให้ผลการค้นหาเลื่อนดูได้และเพิ่มประสิทธิภาพของ endpoint ตัวอย่าง: 4
- ประเภท: integerper
_page จำนวนผลการค้นหาที่ควรคืนในแต่ละหน้า การจำกัดจำนวนผลลัพธ์ต่อหน้าช่วยเพิ่มประสิทธิภาพของ endpoint ใช้พารามิเตอร์ page เพื่อค้นหาในแต่ละหน้าของข้อมูล ตัวอย่าง: 10
- ประเภท: array string[]person
_locations[] สถานที่ที่บุคคลอาศัยอยู่ ค้นหาได้ทั้งเมือง รัฐของสหรัฐฯ และประเทศ หากต้องการค้นหาบุคคลตามที่ตั้งสำนักงานใหญ่ของนายจ้างปัจจุบัน ให้ใช้พารามิเตอร์ organization_locations ตัวอย่าง: california; ireland; chicago
- ประเภท: array string[]person
_seniorities[] ระดับอาวุโสของตำแหน่งงานที่บุคคลดำรงอยู่ในนายจ้างปัจจุบัน ช่วยให้คุณค้นหาบุคคลที่ปัจจุบันดำรงตำแหน่งในระดับการรายงานที่กำหนด เช่น ระดับ Director หรือระดับ IC อาวุโส บุคคลจะปรากฏในผลการค้นหาหากตรงกับระดับอาวุโสอย่างน้อย 1 ระดับที่คุณเพิ่ม การเพิ่มระดับอาวุโสมากขึ้นจะขยายผลการค้นหา การค้นหาจะคืนผลลัพธ์ตามตำแหน่งงานปัจจุบันเท่านั้น ดังนั้นการค้นหาพนักงานระดับ Director จะคืนเฉพาะผู้ที่ปัจจุบันดำรงตำแหน่งระดับ Director เท่านั้น หากบุคคลเคยเป็น Director แต่ปัจจุบันเป็น 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,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
จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
- 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"
]
}