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 — بدلًا من القيم نفسها. يخبرك البحث بوجود تطابق؛ ويكشف الإثراء بيانات الاتصال. مرّر المعرّفات إلى post_apollo_people_match أو post_apollo_people_bulk_match للحصول على عناوين البريد الإلكتروني وأرقام الهاتف، وهناك أيضًا تُستهلك الأرصدة. يتطلب إذنًا إداريًا من Felo.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 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 للشركات (أصحاب العمل) التي تريد تضمينها في نتائج بحثك. تحصل كل شركة في قاعدة بيانات Apollo على معرّف فريد. للعثور على المعرّفات، استدعِ نقطة النهاية 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 لجعل نتائج البحث قابلة للتنقل وتحسين أداء نقطة النهاية. مثال: 4
- النوع: integerper
_page عدد نتائج البحث التي يجب إرجاعها في كل صفحة. يؤدّي تحديد عدد النتائج لكل صفحة إلى تحسين أداء نقطة النهاية. استخدم المعامل page للتنقل بين صفحات البيانات المختلفة. مثال: 10
- النوع: array string[]person
_locations[] الموقع الذي يعيش فيه الأشخاص. يمكنك البحث عبر المدن والولايات الأمريكية والدول. للعثور على أشخاص بناءً على مواقع المقرات الرئيسية لصاحب عملهم الحالي، استخدم المعامل organization_locations. أمثلة: california; ireland; chicago
- النوع: array string[]person
_seniorities[] المستوى الوظيفي الذي يشغله الأشخاص لدى صاحب عملهم الحالي. يتيح لك ذلك العثور على أشخاص يشغلون حاليًا مناصب عند مستويات إبلاغ معيّنة، مثل مستوى Director أو مستوى senior IC. لكي يُدرج شخص في نتائج البحث، يكفي أن يطابق واحدًا من المستويات التي تضيفها. وتؤدّي إضافة مستويات أكثر إلى توسيع نتائج البحث. تُرجع عمليات البحث نتائج بناءً على المسمى الوظيفي الحالي فقط، لذا لا يعيد البحث عن موظفي مستوى Director سوى أشخاص يحملون حاليًا مسمى بمستوى Director. وإذا كان شخص Director سابقًا لكنه VP حاليًا، فلن يُدرج في نتائج بحثك. استخدم هذا المعامل مع المعامل person_titles[] للعثور على أشخاص بناءً على وظائف ومستويات محددة. الخيارات المتاحة لهذا المعامل: owner founder c_suite partner vp head director manager senior entry intern
- النوع: array string[]person
_titles[] المسميات الوظيفية التي يحملها الأشخاص الذين تريد العثور عليهم. لكي يُدرج شخص في نتائج البحث، يكفي أن يطابق واحدًا من المسميات الوظيفية التي تضيفها. وتؤدّي إضافة مسميات أكثر إلى توسيع نتائج البحث. تتضمن النتائج أيضًا مسميات وظيفية بالمصطلحات نفسها حتى لو لم تكن مطابقات تامة. مثلًا، قد يعيد البحث عن 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"
]
}