आपकी टीम को इस सप्ताह एक Python ऐप में Twitter-शैली के सोशल मीडिया डेटा की आवश्यकता है: प्रोफ़ाइल मेटाडेटा, एक उपयोगकर्ता किसे फॉलो करता है, और उनके हाल के उत्तर। इस गाइड के अंत तक, आप Zyla API Hub पर Twitter Data All-in-One API का उपयोग करके इन सभी को क्वेरी करेंगे, Python में प्रतिक्रियाओं को पार्स करेंगे, और यदि आप वर्कफ़्लो को स्वचालित कर रहे हैं, तो इसे MCP के माध्यम से एक AI एजेंट में भी वायर करेंगे।
Twitter Data All-in-One API के साथ आप क्या बना सकते हैं
Twitter Data All-in-One API संरचित सोशल मीडिया डेटा लौटाता है ताकि आप:
- एक सार्वजनिक प्रोफ़ाइल (सत्यापन, अवतार URL, लेबल, rest_id) के बारे में अतिरिक्त जानकारी खींचें।
- एक उपयोगकर्ता द्वारा फॉलो किए गए खातों की सूची बनाएं।
- उपयोगकर्ता के हाल के उत्तर प्राप्त करें (जिसमें ट्वीट आईडी, टाइमस्टैम्प, एंगेजमेंट काउंट और एंटिटीज शामिल हैं)।
यह API Zyla API Hub पर उपलब्ध है और इसे एकल API कुंजी के साथ कॉल किया जा सकता है। यह डैशबोर्ड, अलर्टिंग पाइपलाइनों, ETL नौकरियों, CRM समृद्धि, और उन मॉडरेशन उपकरणों के लिए उपयुक्त है जो सोशल मीडिया संदर्भ पर निर्भर करते हैं।
Zyla API Hub पर शुरू करना
एंडपॉइंट्स को कॉल करने के लिए, Zyla पर API के पृष्ठ को खोलें: Twitter Data All-in-One API। उपलब्ध होने पर सब्सक्राइब या फ्री ट्रायल शुरू करने पर क्लिक करें, और अपनी API कुंजी कॉपी करें।
- प्रमाणीकरण: हर अनुरोध में Authorization: Bearer YOUR_API_KEY जोड़ें।
- बिलिंग: सब्सक्रिप्शन + कोटा (पे-पर-कॉल नहीं)।
- एक्सेस: पहले API में आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध होते हैं। कोई फ्री प्लान नहीं है। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
यदि आपके पास अभी तक खाता नहीं है, तो यहां एक बनाएं: पंजीकरण करें। आपको एक एकल कुंजी प्राप्त होगी जो Zyla API Hub पर सब्सक्राइब किए गए APIs में काम करती है।
प्रमाणीकरण और बेस URL
नीचे दिए गए सभी उदाहरण Authorization हेडर और वास्तविक हब URLs का उपयोग करते हैं। YOUR_API_KEY को Zyla से अपनी वास्तविक कुंजी से बदलें।
- हेडर: Authorization: Bearer YOUR_API_KEY
- बेस पैटर्न: https://zylalabs.com/api/{marketplace_id}/{api-slug}/{endpoint_id}/{path}
आप जिन एंडपॉइंट्स का उपयोग करेंगे
नीचे इस लिस्टिंग पर उपलब्ध पथ हैं। प्रत्येक को स्क्रीननेम क्वेरी पैरामीटर की आवश्यकता होती है। कोई अतिरिक्त पैरामीटर या अनुरोध निकाय शामिल न करें।
प्रोफ़ाइल के बारे में
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- विवरण: प्रोफ़ाइल के बारे में अतिरिक्त जानकारी लौटाता है।
- आवश्यक क्वेरी पैरामीटर:
- screenname (string): उदाहरण के लिए, elonmusk
cURL
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"JSON
{"status":"active","profile":"elonmusk","rest_id":"44196397","blue_verified":true,"affiliates":{"label":{"badge":{"url":"https:\/\/pbs.twimg.com\/profile_images\/1955359038532653056\/OSHY3ewP_bigger.jpg"},"description":"X","url":{"url":"https:\/\/twitter.com\/X","urlType":"DeepLink"},"userLabelDisplayType":"Badge","userLabelType":"BusinessLabel"}},"business_account":null,"verified_since":"-156836000000000","avatar":"https:\/\/pbs.twimg.com\/profile_images\/2008546467615580160\/57KcqsTA_normal.jpg","name":"Elon Musk","protected":false,"about":{"account_based_in":"United States","location_accurate":false,"learn_more_url":"https:\/\/help.twitter.com\/managing-your-account\/about-twitter-verified-accounts","affiliate_username":"X","source":"United States App Store","username_changes":{"count":"0"}},"id":"44196397"}आप जिन फ़ील्ड हाइलाइट्स का उपयोग करेंगे:
- status: खाता स्थिति स्ट्रिंग।
- profile और name: हैंडल और डिस्प्ले नाम।
- rest_id और id: उपयोगकर्ता पहचानकर्ता।
- blue_verified: सत्यापन के लिए बूलियन।
- avatar: प्रोफ़ाइल छवि URL।
- about.account_based_in और about.username_changes.count: अनुपालन और समृद्धि के लिए उपयोगी प्रोफ़ाइल मेटाडेटा।
फॉलोइंग
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- विवरण: उपयोगकर्ता द्वारा फॉलो किए गए खातों की सूची प्राप्त करें।
- आवश्यक क्वेरी पैरामीटर:
- screenname (string): उदाहरण के लिए, elonmusk
cURL
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"JSON
{"following":[{"user_id":"1671483632551186433","screen_name":"TechMine_Mw","description":"Malawi’s premier SAAS firm 🌐 | Leaders in digital transformation, website development, design, and marketing 🖥️🎨 | Shaping Malawi’s tech future 🇲🇼","profile_image":"https:\/\/pbs.twimg.com\/profile_images\/1847661011731431425\/FNhbpOqP_normal.jpg","statuses_count":5,"followers_count":6,"friends_count":10,"media_count":3,"name":"TechMine INC."},{"user_id":"44196397","screen_name":"elonmusk","description":"","profile_image":"https:\/\/pbs.twimg.com\/profile_images\/1874558173962481664\/8HSTqIlD_normal.jpg","statuses_count":65409,"followers_count":210941749,"friends_count":926,"media_count":3038,"name":"Elon Musk"}],"status":"ok","more_users":false}आप जिन फ़ील्ड हाइलाइट्स का उपयोग करेंगे:
- following: खातों का एक एरे, प्रत्येक में user_id, screen_name, name, description।
- followers_count, friends_count, statuses_count, media_count: रैंकिंग और फ़िल्टर के लिए त्वरित आकार संकेत।
- more_users: बूलियन जो यह संकेत करता है कि क्या इस प्रतिक्रिया के परे और अधिक फॉलोइंग मौजूद हैं।
उपयोगकर्ता उत्तर
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- विवरण: उपयोगकर्ता के उत्तरों की सूची।
- आवश्यक क्वेरी पैरामीटर:
- screenname (string): उदाहरण के लिए, elonmusk
cURL
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"प्रतिक्रिया एक टाइमलाइन एरे लौटाती है जिसमें ट्वीट_id, created_at, text, language, engagement counts (favorites, retweets, replies, quotes), लेखक मेटाडेटा, और एंटिटीज जैसे फ़ील्ड होते हैं। टाइमस्टैम्प एक Twitter-शैली की स्ट्रिंग का उपयोग करते हैं जैसे "Thu Dec 12 13:15:59 +0000 2024" (UTC ऑफसेट शामिल), जिसे आप datetime में पार्स कर सकते हैं।
Python त्वरित प्रारंभ: प्रोफ़ाइल जानकारी प्राप्त करें और फ़ील्ड पार्स करें
यह न्यूनतम उदाहरण प्रोफ़ाइल के बारे में पथ को कॉल करता है, HTTP स्थिति की जांच करता है, और प्रमुख फ़ील्ड निकालता है जिन्हें आप संभवतः अपने ऐप के उपयोगकर्ता मॉडल में मैप करेंगे।
Python
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
params = {"screenname": "elonmusk"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(BASE_URL, params=params, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()
# न्यूनतम फ़ील्ड निष्कर्षण
profile = {
"status": data.get("status"),
"screenname": data.get("profile"),
"name": data.get("name"),
"rest_id": data.get("rest_id"),
"id": data.get("id"),
"blue_verified": data.get("blue_verified"),
"avatar": data.get("avatar"),
"account_based_in": (data.get("about") or {}).get("account_based_in"),
"username_change_count": ((data.get("about") or {}).get("username_changes") or {}).get("count"),
}
print(profile)व्यावहारिक सुझाव जो समय बचाते हैं
- Auth हेडर केवल: सभी दिखाए गए पथों को Authorization: Bearer YOUR_API_KEY की आवश्यकता होती है। अन्य प्रमाणीकरण पैरामीटर न जोड़ें।
- आवश्यक पैरामीटर: यहां प्रत्येक एंडपॉइंट को स्क्रीननेम की आवश्यकता होती है। सही कुंजी नाम का उपयोग करें: screenname।
- टाइमस्टैम्प: उपयोगकर्ता उत्तरों में created_at में एक UTC ऑफसेट शामिल होता है; संग्रह करते समय UTC में मानकीकरण करें।
- पैजिनेशन: फॉलोइंग पथ में more_users शामिल है। यदि सत्य है, तो अनुवर्ती फ़ेच के लिए योजना बनाएं। उपलब्ध होने पर किसी भी पैजिनेशन विवरण के लिए API पृष्ठ को संदर्भित करें।
- कैशिंग: प्रोफ़ाइल मेटाडेटा (जैसे, अवतार, सत्यापन) अपेक्षाकृत स्थिर है। About प्रोफ़ाइल प्रतिक्रियाओं को कैश करें और कॉल को कम करने के लिए एक शेड्यूल पर ताज़ा करें।
- त्रुटि हैंडलिंग: अपने SLA के आधार पर गैर-2xx को पुनः प्रयास करने योग्य या उपयोगकर्ता-फेसिंग त्रुटियों के रूप में मानें। अवलोकन के लिए कच्चे JSON को लॉग करें।
- कोटा: Zyla सब्सक्रिप्शन + कोटा का उपयोग करता है। अपने उपयोग की निगरानी करें और कुंजी कॉल को इडेम्पोटेंट रखें। वर्तमान सीमाओं के लिए API पृष्ठ की जांच करें।
एंड-टू-एंड उदाहरण: फॉलोइंग प्राप्त करें और एक इंडेक्स बनाएं
यह आपके CRM को सोशल फॉलो ग्राफ संकेतों के साथ समृद्ध करने के लिए एक सरल पाइपलाइन को रेखांकित करता है:
- About प्रोफ़ाइल के साथ खाते की खोज करें (rest_id, name, blue_verified, avatar संग्रहीत करें)।
- फॉलोइंग को कॉल करें ताकि वे जिन खातों का अनुसरण करते हैं, उन्हें प्राप्त करें (user_id, screen_name, description संग्रहीत करें)।
- यदि more_users सत्य है, तो बाद के फ़ेच के लिए अनुसूची बनाएं (कार्यान्वयन विवरण उपलब्ध होने पर API पृष्ठ पर निर्भर करते हैं)।
- अपने ऐप में एक फ़िल्टर प्रदर्शित करें: "@elonmusk द्वारा फॉलो किए गए संपर्क दिखाएं" या "फॉलोवर काउंट के अनुसार संपर्कों को रैंक करें।"
जब आपको किसी संपर्क की सार्वजनिक उपस्थिति और स्थिति की पुष्टि करने की आवश्यकता होती है, तो About प्रोफ़ाइल (सत्यापन और लेबल) और फॉलोइंग (सोशल ग्राफ एंकर) को मिलाएं, फिर वैकल्पिक रूप से उपयोगकर्ता उत्तरों को खींचें ताकि एंगेजमेंट की हाल कीता और विषयों का विश्लेषण किया जा सके।
MCP के माध्यम से AI एजेंट से API को कॉल करना
यदि आप Claude Code, Cursor, Windsurf, या किसी भी MCP-संगत क्लाइंट का उपयोग करके सोशल डेटा कार्यों को स्वचालित करते हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से कॉल रूट कर सकते हैं:
- एंडपॉइंट: MCP
- MCP के लिए प्रमाणीकरण: MCP URL में apikey=YOUR_API_KEY जोड़ें जैसा दिखाया गया है।
- आपका एजेंट फिर उसी लिस्टिंग पथों (जैसे, About प्रोफ़ाइल, फॉलोइंग, उपयोगकर्ता उत्तर) को कॉल कर सकता है, हब URLs और MCP टूल कॉन्फ़िगरेशन के भीतर Authorization हेडर को निर्दिष्ट करके, आपके क्लाइंट की सेटअप के आधार पर।
अपने टूल विवरण को सटीक रखें और अनुरोधों का निर्माण करते समय केवल प्रलेखित पैरामीटर स्क्रीननेम पास करें।
सामान्य कार्यप्रवाह और पैटर्न
- साइनअप पर प्रोफ़ाइल समृद्धि: हैंडल फ़ील्ड के साथ पहले लॉगिन पर, About प्रोफ़ाइल को कॉल करें, rest_id, avatar URL, blue_verified फ्लैग, और देश संग्रहीत करें।
- प्रभावशाली खोज: यह देखने के लिए कि एक बीज खाता किसे ट्रैक करता है, फॉलोइंग का उपयोग करें। लक्ष्यों को शॉर्टलिस्ट करने के लिए followers_count द्वारा रैंक करें।
- एंगेजमेंट डायग्नोस्टिक्स: आउटरीच या सामग्री प्रतिक्रियाओं को लॉन्च करने से पहले हाल की गतिविधि और विषयों की जांच करने के लिए उपयोगकर्ता उत्तरों का उपयोग करें।
- निगरानी: कुछ VIP खातों के लिए समय-समय पर खींचने की योजना बनाएं; परिवर्तनों को ट्रिगर करने के लिए rest_id और avatar की तुलना करें।
सुरक्षा, तैनाती, और अवलोकन नोट्स
- कुंजी: YOUR_API_KEY को गुप्त प्रबंधकों या पर्यावरण चर में रखें। कभी भी क्रेडेंशियल्स को कमिट न करें।
- टाइमआउट: Python अनुरोधों में, एक सीमित टाइमआउट (जैसे, 30s) सेट करें और अस्थायी त्रुटियों पर एक छोटा पुनः प्रयास नीति लागू करें।
- लॉगिंग: अनुरोध URL (क्रेडेंशियल्स के बिना), HTTP स्थिति, और त्वरित ट्रायज के लिए JSON की शीर्ष-स्तरीय कुंजी लॉग करें।
- बैकऑफ: यदि आप कोटा के करीब पहुंचते हैं, तो पोलिंग आवृत्ति को कम करें और पुनरावृत्त कॉल से बचने के लिए About प्रोफ़ाइल जैसे परिणामों को कैश करें।
परिशिष्ट: अतिरिक्त एंडपॉइंट उदाहरण
नीचे इस लिस्टिंग पर प्रत्येक उपलब्ध पथ के लिए कॉपी-पेस्ट करने योग्य cURL उदाहरण हैं, केवल आवश्यक पैरामीटर का उपयोग करते हुए।
About प्रोफ़ाइल (cURL)
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"फॉलोइंग (cURL)
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"उपयोगकर्ता उत्तर (cURL)
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"अगले कहाँ खोजें
- API पृष्ठ जिसमें लाइव कंसोल और विवरण हैं: Twitter Data All-in-One API
- अधिक सोशल मीडिया लिस्टिंग के लिए Zyla API Hub होमपेज: zylalabs.com
FAQ
1) मैं अपने अनुरोधों को कैसे प्रमाणित करूं?
ऊपर दिखाए गए हब URLs में हर कॉल में हेडर Authorization: Bearer YOUR_API_KEY शामिल करें।
2) इन एंडपॉइंट्स के लिए कौन से पैरामीटर आवश्यक हैं?
इस गाइड में प्रत्येक पथ को क्वेरी पैरामीटर स्क्रीननेम की आवश्यकता होती है। केवल स्क्रीननेम का उपयोग करें; कोई अतिरिक्त पैरामीटर या अनुरोध निकाय न जोड़ें।
3) क्या प्रतिक्रियाओं में टाइमस्टैम्प और एंगेजमेंट काउंट शामिल हैं?
हाँ। उपयोगकर्ता उत्तरों का पथ created_at और favorites, retweets, replies, और quotes जैसे काउंट शामिल करता है। टाइमस्टैम्प एक Twitter-शैली की स्ट्रिंग का अनुसरण करता है जिसमें UTC ऑफसेट होता है।
4) बिलिंग मॉडल क्या है?
Zyla सब्सक्रिप्शन + कोटा (पे-पर-कॉल नहीं) पर काम करता है। इस API के लिए, पहले API में आमतौर पर 7-दिन का ट्रायल या 50 अनुरोध होते हैं और कोई फ्री प्लान नहीं है। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
5) क्या मैं इस API का उपयोग एक AI एजेंट में कर सकता हूं?
हाँ। अपने API कुंजी के साथ MCP पर MCP एंडपॉइंट का उपयोग करें और अपने एजेंट को Authorization हेडर के साथ समान हब URLs कॉल करने दें।
शिप करने के लिए तैयार? अपना खाता बनाएं, एक API कुंजी प्राप्त करें, और आज Twitter Data All-in-One API को Zyla API Hub पर एकीकृत करना शुरू करें: पंजीकरण करें।
