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