उपयोगकर्ता की प्रोफ़ाइल अपडेट करना /linkedin/v2/{account_id}/users/{user_id} पर एक PATCH है, जो AdGrant.AI API के users परिवार का हिस्सा है। हर रिक्वेस्ट आपकी अपनी key को X-API-KEY हेडर में लेकर चलती है; key तय करती है कि आप कौन-सा संगठन हैं, और इसलिए आप किन LinkedIn अकाउंट का नाम ले सकते हैं।
प्रोफ़ाइल पढ़ना किसी अकाउंट की साख ख़र्च करने का सबसे सस्ता तरीक़ा है। उन्हें फैलाइए, और अलग-अलग लुकअप के लूप की जगह एक enrichment कॉल चुनिए।
रिक्वेस्ट
curl -X PATCH "https://adgrant.ai/linkedin/v2/$ACCOUNT_ID/users/$USER_ID" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
पाथ में क्या जाता है
- account_id — वह जुड़ा हुआ LinkedIn अकाउंट जिसके नाम पर काम करना है। वह आपकी अपनी key से जोड़ा गया होना चाहिए; किसी भी और id का जवाब 404 है।
- user_id — इसी परिवार की किसी पिछली कॉल से लौटी हुई id।
न चलने पर क्या लौटता है
- 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 अकाउंट पर। रूम में हर कोई देखता है कि उसने क्या माँगा और क्या लौटा। आम भाषा में कहिए; यहाँ एजेंट का नाम @scout है:
- @scout इस प्रोफ़ाइल के पीछे के व्यक्ति को खोजिए और उसकी भूमिका और कंपनी बताइए: <profile URL>
अक्सर पूछे जाने वाले सवाल
क्या कोई AI एजेंट मेरे लिए “उपयोगकर्ता की प्रोफ़ाइल अपडेट करना” कॉल कर सकता है?
हाँ। MCP बोलने वाला कोई भी असिस्टेंट ऊपर के पते के ज़रिए कर सकता है, और प्रोजेक्ट रूम में AdGrant.AI पर टिक वाला आपका अपना AI एजेंट भी। रूम के बिल्ट-इन एजेंट नहीं कर सकते: वे सलाह देते हैं, और उनके पास आपकी LinkedIn key नहीं होती।
क्या यह रूम के बाहर, मेरे अपने कोड से चलता है?
हाँ। ऊपर की रिक्वेस्ट वही ऑपरेशन है जिसे AI एजेंट के टूल कॉल करते हैं, उसी जवाब और उन्हीं एरर के साथ। आप जिस रास्ते से भी आएँ, आपकी key तय करती है कि वह किन LinkedIn अकाउंट का नाम ले सकती है।
क्या यह मेरे अपने ब्रांड वाले रूम में चलता है?
हाँ। व्हाइट-लेबल पते पर टूल आपके प्रोडक्ट के नाम से सूचीबद्ध होता है, और वह उन्हीं नियमों के तहत उन्हीं अकाउंट तक पहुँचता है।
क्या AI एजेंट के यह करने से पहले कोई व्यक्ति मंज़ूरी दे सकता है?
इसे AI एजेंट के निर्देशों में लिख दीजिए: बताइए कि आप क्या करने वाले हैं और रूम में किसी व्यक्ति के “जाइए” कहने तक रुकिए। रूम हर जवाब अपने सभी लोगों को दिखाता है, इसलिए LinkedIn पर कुछ बदलने से पहले रिक्वेस्ट दिख जाती है।
किस प्लान में है
AdGrant.AI API प्लान, /linkedin पर। हर जुड़े LinkedIn अकाउंट के $9 प्रति माह, सौ अकाउंट से $7, एक अकाउंट के लिए 30 दिन के ट्रायल के साथ।