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 کی انتظامی اجازت درکار ہے۔
قیمت کا حوالہ
- میٹرنگ: کامیاب درخواست کی مقررہ لاگت کی بنیاد۔
- حوالہ جاتی درخواست کا تخمینہ: 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[] پیرامیٹر میں آپ کے متعین کردہ عنوانات سے ملتے جلتے نوکری کے عنوانات والے افراد جواب میں واپس آئیں گے یا نہیں۔ جب آپ person_titles[] استعمال کر کے صرف نوکری کے عنوانات کے سخت مطابق نتائج چاہتے ہوں تو اس پیرامیٹر کو false پر سیٹ کریں۔
- قسم: array string[]organization
_ids[] ان کمپنیوں (آجروں) کے Apollo IDs جنہیں آپ اپنے تلاش کے نتائج میں شامل کرنا چاہتے ہیں۔ Apollo ڈیٹابیس میں ہر کمپنی کو ایک منفرد ID دی جاتی ہے۔ IDs تلاش کرنے کے لیے 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 تلاش کریں لیکن کمپنی کا HQ مقام 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.، @ علامت یا اس جیسی چیزیں شامل نہ کریں۔ یہ پیرامیٹر ایک درخواست میں 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
درست Felo API کلید درکار ہے۔
- 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"
]
}