आपको इस सप्ताह एक सोशल मीडिया इंटीग्रेशन भेजने की आवश्यकता है जो विश्वसनीय Twitter/X प्रोफ़ाइल विवरण, एक उपयोगकर्ता किसे फॉलो करता है, और उपयोगकर्ता की हाल की प्रतिक्रियाएँ खींचता है। इस गाइड के अंत तक, आप curl के साथ Zyla API Hub पर Twitter Data All-in-One API के लिए एक कार्यशील पहला अनुरोध करेंगे, एक वास्तविक JSON पेलोड का निरीक्षण करेंगे, और आपके सेवा में डालने के लिए एक छोटा Python स्निपेट होगा।
यह API क्या प्रदान करती है और डेवलपर्स इसका उपयोग क्यों करते हैं
Twitter Data All-in-One API सोशल मीडिया डेटा को उजागर करती है जिसे आप डैशबोर्ड, CRM समृद्धि, मॉडरेशन कतारों, अनुसंधान स्क्रिप्ट, और एनालिटिक्स नौकरियों में जोड़ सकते हैं। यह प्रदान करती है:
- प्रोफ़ाइल “के बारे में” जानकारी: सत्यापित स्थिति, अवतार, संबद्धताएँ, और खाता मेटाडेटा।
- फॉलोइंग सूची: एक उपयोगकर्ता किसे फॉलो करता है, प्रति खाता बुनियादी प्रोफ़ाइल आँकड़े।
- उपयोगकर्ता प्रतिक्रियाएँ: उपयोगकर्ता की हाल की प्रतिक्रियाएँ, ट्वीट-स्तरीय काउंटर और लेखक संदर्भ के साथ।
सब कुछ एकल Zyla API Hub सदस्यता और Authorization: Bearer YOUR_API_KEY हेडर के पीछे उपलब्ध है, ताकि आप कई प्रदाताओं या कुंजियों को संभालने से बच सकें। मार्केटप्लेस लिस्टिंग यहाँ ब्राउज़ करें: Twitter Data All-in-One API. आप जब तैयार हों तो Zyla API Hub पर अन्य सोशल मीडिया APIs का भी अन्वेषण कर सकते हैं।
Zyla API Hub पर शुरू करना
किसी भी एंडपॉइंट को कॉल करने के लिए, आपको Zyla API Hub से एक API कुंजी की आवश्यकता है:
- API पृष्ठ खोलें: Twitter Data All-in-One API.
- सब्सक्राइब पर क्लिक करें (या उपलब्ध होने पर फ्री ट्रायल शुरू करें), फिर अपनी API कुंजी उत्पन्न करें।
- हर अनुरोध पर Authorization: Bearer YOUR_API_KEY हेडर के साथ प्रमाणीकरण करें।
बिलिंग सदस्यता + कोटा है (पे-पर-कॉल नहीं)। इस API के लिए, पहले एक्सेस के लिए 7-दिन का ट्रायल या 50 अनुरोध की अपेक्षा करें। कोई फ्री प्लान नहीं है। हमेशा वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
प्रमाणीकरण और अनुरोध परंपराएँ
- बेस: अनुरोध नीचे सूचीबद्ध हब एंडपॉइंट URLs पर जाते हैं (सभी https://zylalabs.com/api/... से शुरू होते हैं)।
- प्रमाणन: Authorization: Bearer YOUR_API_KEY शामिल करें।
- पैरामीटर: केवल प्रत्येक एंडपॉइंट के लिए प्रलेखित पैरामीटर का उपयोग करें; अतिरिक्त न जोड़ें।
- प्रतिक्रियाएँ: JSON। टाइमस्टैम्प Twitter/X के मानक प्रारूप का उपयोग करते हैं जिसमें समय क्षेत्र ऑफ़सेट शामिल होते हैं जब मौजूद होते हैं।
एंडपॉइंट 1: प्रोफ़ाइल के बारे में
एक प्रोफ़ाइल के बारे में अतिरिक्त जानकारी लौटाता है। उपयोगकर्ता लुकअप, खाता समृद्धि, या सत्यापित स्थिति और व्यावसायिक संबद्धताओं को प्रदर्शित करने के लिए उपयोगी।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- आवश्यक पैरामीटर: screenname=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: लुकअप के लिए API स्थिति।
- profile और id/rest_id: आपके DB में स्टोर करने के लिए स्थिर पहचानकर्ता।
- blue_verified: बैज प्रदर्शन और विश्वास ह्यूरिस्टिक्स के लिए बूलियन।
- avatar और name: उपयोगकर्ता कार्ड और लीडरबोर्ड प्रदर्शित करें।
- affiliates.label: एक व्यावसायिक संबंध दिखाता है, जिसमें एक बैज और एक आउटबाउंड URL शामिल है।
- about.account_based_in और source: क्षेत्रीय या स्टोर-स्रोत एनालिटिक्स के लिए मेटाडेटा।
Python उदाहरण: About प्रोफ़ाइल प्राप्त करें और प्रमुख फ़ील्ड पढ़ें
यह स्निपेट उसी एंडपॉइंट को कॉल करता है और कुछ फ़ील्ड्स को पार्स करता है जिन्हें आप प्रदर्शित करने की संभावना रखते हैं। अपने उत्पादन मानकों के अनुसार त्रुटि हैंडलिंग को समायोजित करें।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
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(url, headers=headers, params=params, timeout=20)
resp.raise_for_status()
data = resp.json()
user = {
"screenname": data.get("profile"),
"id": data.get("id"),
"name": data.get("name"),
"blue_verified": data.get("blue_verified"),
"avatar": data.get("avatar"),
"country": (data.get("about") or {}).get("account_based_in"),
}
print(user)
एंडपॉइंट 2: फॉलोइंग
एक उपयोगकर्ता द्वारा फॉलो किए जा रहे खातों की सूची प्राप्त करें, जिसमें स्कोरिंग, विभाजन, और खोज उपकरणों में मदद करने वाले काउंट शामिल हैं।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- आवश्यक पैरामीटर: screenname=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: उपयोगकर्ता_id, screen_name, name, और हल्के आँकड़ों (followers_count, friends_count, statuses_count, media_count) के साथ खातों की सूची।
- more_users: बूलियन फ्लैग जो इंगित करता है कि क्या इस सेट के अलावा अतिरिक्त परिणाम हो सकते हैं। यहाँ सूचीबद्ध नहीं करता है पृष्ठांकन पैरामीटर; यदि आपको गहरे ट्रैवर्सल की आवश्यकता है तो API पृष्ठ की जांच करें।
एंडपॉइंट 3: उपयोगकर्ता प्रतिक्रियाएँ
एक उपयोगकर्ता की प्रतिक्रियाओं (जिसमें रिट्वीट शामिल हैं जो टाइमलाइन का प्रतिनिधित्व कर सकते हैं) की सूची प्राप्त करें। यह सहभागिता की निगरानी, गतिविधि फ़ीड बनाने, या हल्के वर्गीकर्ताओं को प्रशिक्षित करने के लिए सहायक है।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- आवश्यक पैरामीटर: screenname=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"
JSON (नमूना प्रतिक्रिया अंश)
{"timeline":[{"tweet_id":"1867196702865674450","bookmarks":0,"created_at":"Thu Dec 12 13:15:59 +0000 2024","favorites":0,"text":"RT @cb_doge: Every citizen journalist who fought the legacy media narrative and spread the truth this election is the Person of the Year.…","lang":"en","in_reply_to_status_id_str":null,"views":null,"quotes":0,"replies":0,"retweets":10,"conversation_id":"1867196702865674450","media":[],"entities":{"user_mentions":[{"id_str":"1389913567671975937","name":"DogeDesigner","screen_name":"cb_doge"}],"urls":[],"hashtags":[],"symbols":[]},"author":{"rest_id":"44196397","name":"Elon Musk","screen_name":"elonmusk","followers_count":207267106,"favourites_count":99802,"avatar":"https:\/\/pbs.twimg.com\/profile_images\/1858316737780781056\/kPL61o0F_normal.jpg","blue_verified":true},"retweeted":{"id":"1867196122143563838"},"retweeted_tweet":{"tweet_id":"1867196122143563838","bookmarks":0,"created_at":"Thu Dec 12 13:13:41 +0000 2024","favorites":119,"text":"Every citizen journalist who fought the legacy media narrative and spread the truth this election is the Person of the Year. \n\n https:\/\/t.co\/B8boPofzKx","lang":"en","quotes":2,"replies":60,"retweets":10,"conv…
जोड़ने के लिए प्रमुख फ़ील्ड:
- tweet_id और conversation_id: थ्रेड्स को सहसंबंधित करें और डुप्लिकेट करें।
- created_at: टाइमस्टैम्प (UTC +0000 इस उदाहरण में); अपने UI में अपने पसंदीदा समय क्षेत्र में परिवर्तित करें।
- text और lang: मॉडरेशन या अनुक्रमण के लिए सामग्री और भाषा।
- favorites, replies, retweets, quotes: सहभागिता काउंटर।
- author: rest_id, screen_name, avatar, और blue_verified के साथ संक्षिप्त उपयोगकर्ता वस्तु।
- retweeted और retweeted_tweet: यदि मौजूद हैं, तो रिट्वीट संबंधों का प्रतिनिधित्व करें।
व्यावहारिक कार्यान्वयन नोट्स (एक घंटा बचाएँ)
- कैशिंग: प्रोफ़ाइल “के बारे में” डेटा टाइमलाइनों की तुलना में कम बार बदलता है। About प्रोफ़ाइल प्रतिक्रियाओं को मिनटों से घंटों तक कैश करें; यदि आपका UI वास्तविक समय संवेदनशील है तो फॉलोइंग सूचियों और प्रतिक्रियाओं को अधिक बार ताज़ा करें।
- पहचानकर्ता: दोनों id/rest_id और screen_name को स्टोर करें। उपयोगकर्ता नाम बदल सकते हैं; संख्यात्मक IDs अधिक स्थिर एंकर होते हैं।
- टाइमस्टैम्प: created_at मानों में स्ट्रिंग में समय क्षेत्र की जानकारी शामिल होती है। अपने बैकएंड में UTC में सामान्यीकृत करें ताकि क्वेरी और क्रमबद्ध करना सरल हो सके।
- रेट खपत: चूंकि एक्सेस सदस्यता + कोटा है (पे-पर-कॉल नहीं), कॉल को केंद्रीकृत करें ताकि सेवाओं के बीच डुप्लिकेट फ़ेच से बचा जा सके।
- पृष्ठांकन: यदि फॉलोइंग प्रतिक्रियाओं में more_users सत्य है, तो पुनरावृत्त फ़ेच पैटर्न की योजना बनाएं। यहाँ दिखाए गए लिस्टिंग में गहरे पृष्ठांकन के लिए पैरामीटर परिभाषित नहीं हैं—पृष्ठ-चलने की लॉजिक लागू करने से पहले API पृष्ठ पर अपडेट की निगरानी करें।
- त्रुटि हैंडलिंग: उपयुक्त स्थानों पर गैर-2xx प्रतिक्रियाओं को अस्थायी के रूप में मानें और एक्सपोनेंशियल बैकऑफ के साथ पुनः प्रयास करें। हमेशा अनुरोधित URL और screenname को लॉग करें ताकि समस्याओं को जल्दी से दोहराया जा सके।
इस API को MCP के माध्यम से AI एजेंट से कॉल करें
यदि आप MCP-संगत क्लाइंट (जैसे Claude Code, Cursor, या Windsurf) का उपयोग कर रहे हैं, तो आप Zyla की MCP सेवा के माध्यम से कॉल रूट कर सकते हैं। अपने उपकरण को इस पर इंगित करें:
अपनी Zyla API कुंजी प्रदान करें (MCP एंडपॉइंट पर apikey क्वेरी पैरामीटर)। आपका एजेंट तब बिना कच्चे HTTP लॉजिक को एम्बेड किए उपकरण कॉल के माध्यम से Twitter Data All-in-One API को सक्रिय कर सकता है। अपने उपकरण के कॉल कॉन्फ़िगर करते समय वही Authorization: Bearer YOUR_API_KEY पैटर्न बनाए रखें।
सामान्य वास्तविक-विश्व उपयोग के मामले
- CRM और समृद्धि: लीड स्तर सौंपने से पहले व्यावसायिक संबद्धता और बैज स्थिति को सत्यापित करने के लिए About प्रोफ़ाइल का उपयोग करें।
- दर्शक खोज: फॉलोइंग को खींचें ताकि रुचियों का मानचित्रण किया जा सके और आपके लक्षित खाते द्वारा फॉलो किए गए संभावित भागीदारों या प्रभावशाली व्यक्तियों की पहचान की जा सके।
- सहभागिता डैशबोर्ड: उपयोगकर्ता प्रतिक्रियाओं को प्रोफ़ाइल अवतार और नामों के साथ मिलाकर लाइव-फीड विजेट्स को भरें।
- मॉडरेशन कतारें: समीक्षा के लिए उच्च-दृश्यता इंटरैक्शन को प्राथमिकता देने के लिए lang और सहभागिता काउंटर द्वारा फ़िल्टर करें।
- अनुसंधान स्क्रिप्ट: डेटा लेक में रात भर फॉलोइंग या हाल की प्रतिक्रियाओं का स्नैपशॉट लें और समय के साथ परिवर्तन का विश्लेषण करें।
एंड-टू-एंड: आपका पहला अनुरोध और अगले कदम
अपने कुंजी को मान्य करने और हेडर को जोड़ने के लिए About प्रोफ़ाइल लुकअप से शुरू करें। फिर अपने उत्पाद की आवश्यकताओं के आधार पर फॉलोइंग और उपयोगकर्ता प्रतिक्रियाओं में विस्तार करें। यदि आप एक छोटा आंतरिक CLI या स्क्रिप्ट बनाते हैं जो:
- एक screenname और एंडपॉइंट (about-profile, following, user-replies) स्वीकार करता है।
- Authorization: Bearer YOUR_API_KEY के साथ URL को कॉल करता है और JSON को डिस्क पर लॉग करता है।
- कुछ फ़ील्ड्स को प्रिंट करता है जो आपकी सेवा उपभोग करती है (जैसे, id, blue_verified, counts)।
जब आप तैयार हों, तो API पृष्ठ पर सब्सक्राइब करें: Twitter Data All-in-One API. श्रेणियों में अधिक सोशल मीडिया इंटीग्रेशन का अन्वेषण करें Zyla API Hub पर।
FAQ
मैं प्रमाणीकरण कैसे करूँ?
Hub URLs पर हर अनुरोध पर HTTP हेडर Authorization: Bearer YOUR_API_KEY शामिल करें।
क्या कोई फ्री प्लान है?
कोई फ्री प्लान नहीं है। इस API के लिए, पहले सब्सक्राइब करने पर 7-दिन का ट्रायल या 50 अनुरोध की अपेक्षा करें। वर्तमान एक्सेस विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या मुझे screenname से अधिक पैरामीटर की आवश्यकता है?
यहाँ दिखाए गए एंडपॉइंट्स के लिए, केवल आवश्यक पैरामीटर screenname है जिसका मान elonmusk जैसा है। अतिरिक्त पैरामीटर न जोड़ें।
मैं फॉलोइंग के लिए पृष्ठांकन को कैसे संभालूँ?
प्रतिक्रिया में more_users शामिल है यह इंगित करने के लिए कि क्या अधिक परिणाम हो सकते हैं। यहाँ दिखाए गए लिस्टिंग में पृष्ठांकन पैरामीटर परिभाषित नहीं हैं; अतिरिक्त फ़ेच लागू करने से पहले API पृष्ठ के अपडेट के लिए परामर्श करें।
क्या मैं इसे AI कोडिंग एजेंट के माध्यम से कॉल कर सकता हूँ?
हाँ। Zyla के MCP एंडपॉइंट और अपनी Zyla API कुंजी का उपयोग करें ताकि MCP-संगत उपकरण Twitter Data All-in-One API को एक उपकरण के रूप में कॉल कर सकें।
क्या आप कार्यान्वित करने के लिए तैयार हैं? अपना Zyla खाता बनाएं, API पर सब्सक्राइब करें, और अभी अपनी कुंजी प्राप्त करें: पंजीकरण करें.