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 — होते हैं। सर्च बताती है कि मेल मौजूद है; एनरिचमेंट संपर्क विवरण उजागर करता है। ईमेल और फ़ोन नंबर पाने के लिए ids को post_apollo_people_match या post_apollo_people_bulk_match में दें — क्रेडिट भी वहीं खर्च होते हैं। Felo प्रशासनिक अनुमति आवश्यक है।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: 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[] पैरामीटर में आपके द्वारा परिभाषित टाइटल के समान जॉब टाइटल वाले लोग response में लौटाए जाएँ या नहीं। जब आप person_titles[] का उपयोग करके केवल सटीक जॉब टाइटल मिलान चाहते हैं, तो इस पैरामीटर को false पर सेट करें।
- टाइप: array string[]organization
_ids[] उन कंपनियों (नियोक्ताओं) के Apollo ID जिन्हें आप अपने सर्च परिणामों में शामिल करना चाहते हैं। Apollo डेटाबेस में प्रत्येक कंपनी को एक अनूठा ID दिया जाता है। ID खोजने के लिए Organization Search endpoint कॉल करें और 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 डेटा का वह पेज नंबर जिसे आप प्राप्त करना चाहते हैं। सर्च परिणामों को नेविगेट करने योग्य बनाने और endpoint का प्रदर्शन सुधारने के लिए इस पैरामीटर का per_page पैरामीटर के साथ उपयोग करें। उदाहरण: 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., @ चिह्न या इसी तरह के अन्य चिह्न न जोड़ें। यह पैरामीटर एक request में अधिकतम 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
सफल response
- टाइप: array string[]people
response ऐरे
- टाइप: integertotal
_entries response फ़ील्ड
application/json - 400
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
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"
]
}