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, אנשים שעובדים בחברה שבבוסטון לא יופיעו בתוצאות, גם אם הם מתאימים לפרמטרים אחרים. כדי למצוא אנשים לפי המיקום האישי שלהם, השתמשו בפרמטר 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"
]
}