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[] تعریف می‌کنید در پاسخ بازگردانده می‌شوند یا نه. هنگام استفاده از person_titles[] برای بازگرداندن فقط مطابقت‌های دقیق عنوان شغلی، این پارامتر را روی false بگذارید.
- نوع: 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"
]
}