पाइपलाइन के उम्मीदवारों की सूची /linkedin/v2/{account_id}/linkedin/recruiter/projects/{project_id}/pipeline पर एक POST है, जो MakeHybrid API के linkedin परिवार का हिस्सा है। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है; key तय करती है कि आप कौन-सा संगठन हैं, और इसलिए आप किन LinkedIn अकाउंट का नाम ले सकते हैं।
यह परिवार रिक्वेस्ट को सीधे LinkedIn की अपनी सतह पर भेज देता है, इसलिए जो लौटता है उसकी शक्ल LinkedIn तय करता है, हम नहीं।
रिक्वेस्ट
curl -X POST "https://makehybrid.com/linkedin/v2/$ACCOUNT_ID/linkedin/recruiter/projects/$PROJECT_ID/pipeline" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
पाथ में क्या जाता है
- account_id — वह जुड़ा हुआ LinkedIn अकाउंट जिसके नाम पर काम करना है। वह आपकी अपनी key से जोड़ा गया होना चाहिए; किसी भी और id का जवाब 404 है।
- project_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
न चलने पर क्या लौटता है
- 401 — key नहीं है, ग़लत है या रद्द कर दी गई है।
- 402 — प्लान का भुगतान नहीं हुआ। ट्रायल ख़त्म होने पर MakeHybrid API योजना यही लौटाती है।
- 404 — या तो वह चीज़ है ही नहीं, या अकाउंट id आपकी नहीं है। दोनों का जवाब जान-बूझकर एक ही है, ताकि id टटोली न जा सकें।
- 429 — बहुत ज़्यादा रिक्वेस्ट, या LinkedIn अकाउंट को रोक रहा है। इंतज़ार ही एकमात्र इलाज है; जल्दी दोबारा कोशिश करने से यह और लंबा हो जाता है।
- 503 — LinkedIn, या उसके आगे वाले पड़ाव ने जवाब नहीं दिया। बॉडी में वही नंगा स्टेटस होता है जो उसने देखा।
हर एरर एक ही शक्ल का JSON है: {"type":"errors/<code>","status":<n>,"detail":"..."} — इसलिए एक ही हैंडलर सब संभाल लेता है, और detail इसी तरह लिखा गया है कि किसी इंसान को दिखाया जा सके।
इसके बजाय असिस्टेंट से कहिए
यह ऑपरेशन एक MCP टूल भी है। https://makehybrid.com/linkedin/mcp/<आपकी API key> को Claude, ChatGPT या किसी भी MCP बोलने वाले असिस्टेंट में चिपकाइए और आम भाषा में जो चाहिए वह माँगिए — असिस्टेंट ख़ुद कॉल चुनेगा, id भरेगा और जवाब पढ़कर सुनाएगा। इंस्टॉल करने को कुछ नहीं है।
प्रोजेक्ट रूम में
प्रोजेक्ट रूम में अपने किसी AI एजेंट के लिए “इस्तेमाल कर सकता है” के नीचे MakeHybrid पर टिक कीजिए, और जब भी बातचीत को ज़रूरत हो, वह “पाइपलाइन के उम्मीदवारों की सूची” को टूल की तरह कॉल करता है, आपके संगठन के जोड़े हुए LinkedIn अकाउंट पर। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “पाइपलाइन के उम्मीदवारों की सूची” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में MakeHybrid पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी LinkedIn key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ। आप जिस रास्ते से भी आएँ, आपकी key तय करती है कि वह किन LinkedIn अकाउंट का नाम ले सकती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर टूल आपके प्रोडक्ट के नाम से सूचीबद्ध होता है, और वह उन्हीं नियमों के तहत उन्हीं अकाउंट तक पहुँचता है।
क्या AI एजेंट के यह करने से पहले कोई व्यक्ति मंज़ूरी दे सकता है?
इसे AI एजेंट के निर्देशों में लिख दीजिए: बताइए कि आप क्या करने वाले हैं और रूम में किसी व्यक्ति के “जाइए” कहने तक रुकिए। रूम हर जवाब अपने सभी लोगों को दिखाता है, इसलिए LinkedIn पर कुछ बदलने से पहले रिक्वेस्ट दिख जाती है।
किस प्लान में है
MakeHybrid API प्लान, /linkedin पर। हर जुड़े LinkedIn अकाउंट के $9 प्रति माह, दस अकाउंट से $7 और हज़ार से $5, एक अकाउंट के लिए 30 दिन के ट्रायल के साथ।