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