आपकी टीम को इस सप्ताह विश्वसनीय ट्विटर-शैली की प्रोफ़ाइल और गतिविधि डेटा की आवश्यकता है—कोई OAuth नृत्य नहीं, कोई स्क्रैपिंग नहीं, बस साफ़ एंडपॉइंट्स जिन्हें आप शिप कर सकते हैं। इस गाइड के अंत तक, आप जानेंगे कि ट्विटर डेटा ऑल-इन-वन API का उपयोग करके किसी भी सार्वजनिक स्क्रीन नाम के लिए प्रोफ़ाइल मेटाडेटा, फॉलोइंग सूचियाँ और हाल की प्रतिक्रियाएँ कैसे प्राप्त करें, जिसमें तैयार-से-चलाने वाले curl और Python उदाहरण हैं जिन्हें आप अपनी सेवा में डाल सकते हैं।
आप इस API के साथ क्या बना सकते हैं
ट्विटर डेटा ऑल-इन-वन API प्रमुख सामाजिक संकेतों को उजागर करता है जिनकी आमतौर पर डेवलपर्स को आवश्यकता होती है:
- प्रोफ़ाइल स्नैपशॉट: खाता स्थिति, सत्यापन, अवतार, मूल गणनाएँ, और मेटाडेटा।
- फॉलोइंग सूचियाँ: कौन एक उपयोगकर्ता का अनुसरण करता है, जिसमें त्वरित रैंकिंग के लिए बायोस और गणनाएँ शामिल हैं।
- उत्तर समयरेखा: हाल की प्रतिक्रियाएँ/रीट्वीट्स के साथ सहभागिता काउंटर और लेखक संदर्भ।
विशिष्ट उपयोग के मामलों में सामाजिक साइनअप समृद्धि, सामग्री ऐप्स में लेखक पृष्ठ, ब्रांड निगरानी डैशबोर्ड, और हल्के विश्लेषण पाइपलाइनों शामिल हैं—सभी बिना अंतर्निहित सामाजिक नेटवर्क की बदलती वेब सतह का प्रबंधन किए।
Zyla API Hub पर शुरू करना
ट्विटर डेटा ऑल-इन-वन API Zyla API Hub पर उपलब्ध है, जो एक खाता, एक API कुंजी, और 10,000 से अधिक सार्वजनिक APIs के लिए एक सदस्यता + कोटा मॉडल प्रदान करता है। API कुंजी प्राप्त करने के लिए:
- लिस्टिंग खोलें और सदस्यता लें: Twitter डेटा ऑल-इन-वन API पर 7-दिन की परीक्षण शुरू करें.
- डैशबोर्ड से अपनी API कुंजी कॉपी करें।
- हेडर Authorization: Bearer YOUR_API_KEY के साथ अनुरोध भेजें।
पहुँच सदस्यता-आधारित है (प्रति कॉल भुगतान नहीं)। वर्तमान पहुँच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जाँच करें। पहली एकीकरण लिस्टिंग पृष्ठ से 7-दिन की परीक्षण पर शुरू हो सकती है।
एंडपॉइंट्स का अवलोकन
नीचे दस्तावेज़ीकृत एंडपॉइंट्स हैं जिनमें विधियाँ, सटीक अनुरोध URLs, और आवश्यक पैरामीटर शामिल हैं। सभी एंडपॉइंट्स को आपकी कुंजी के साथ Authorization हेडर की आवश्यकता होती है।
1) प्रोफ़ाइल
दिए गए स्क्रीन नाम के लिए एक सामान्य प्रोफ़ाइल स्नैपशॉट लौटाता है।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- आवश्यक क्वेरी पैरामीटर्स: स्क्रीन नाम
आधिकारिक उदाहरण (जैसा है कॉपी-पेस्ट करें):
curl -s -X GET "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile?screenname=elonmusk" \
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक JSON प्रतिक्रिया (नमूना):
{
"status": "active",
"profile": "MikeCiesla",
"rest_id": "23880336",
"blue_verified": true,
"affiliates": [],
"business_account": [],
"avatar": "https://pbs.twimg.com/profile_images/1699329166234247168/G1W8YKJy_normal.jpg",
"header_image": "https://pbs.twimg.com/profile_banners/23880336/1695301088",
"desc": "Web3 at Google Cloud",
"name": "MikeCiesla",
"protected": null,
"location": "🦘🇦🇺",
"friends": 969,
"sub_count": 219,
"statuses_count": 48,
"media_count": 2,
"pinned_tweet_ids_str": [],
"created_at": "Thu Mar 12 02:45:15 +0000 2009",
"id": "23880336"
}
आप likely उपयोग करेंगे:
- status खाता स्थिति को इंगित करता है।
- rest_id और id उपयोगकर्ता के लिए स्ट्रिंग पहचानकर्ता हैं।
- blue_verified एक बूलियन है जिसे आप सीधे प्रदर्शित कर सकते हैं।
- avatar और header_image प्रदर्शित करने के लिए तैयार छवि URLs हैं।
- friends आमतौर पर फॉलोइंग काउंट से मेल खाता है; media_count और statuses_count गतिविधि को रैंक करने के लिए उपयोगी हैं।
- created_at एक टाइमस्टैम्प स्ट्रिंग है; इसे UTC के रूप में मानें।
2) प्रोफ़ाइल के बारे में
एक प्रोफ़ाइल के बारे में अतिरिक्त जानकारी लौटाता है, जिसमें सत्यापन संदर्भ और खाता मेटाडेटा शामिल हैं।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- आवश्यक क्वेरी पैरामीटर्स: स्क्रीन नाम
उदाहरण अनुरोध (जैसा है कॉपी-पेस्ट करें):
उदाहरण प्रतिक्रिया:
हाइलाइट्स:
- affiliates.label में एक बैज और वर्णनात्मक लिंक होता है जिसे आप प्रोफ़ाइल के साथ दिखा सकते हैं।
- verified_since एक स्ट्रिंग है; यदि आपको इसे प्रदर्शित करने की आवश्यकता है, तो इसे जैसा है संभालें जब तक कि आप इसे डाउनस्ट्रीम परिवर्तित न करें।
- about फ़ील्ड्स खाता मूल, स्थान सटीकता, और सहयोगी उपयोगकर्ता नाम को समझाने में मदद करती हैं।
3) फॉलोइंग
एक उपयोगकर्ता द्वारा अनुसरण किए जा रहे खातों की सूची लौटाता है।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- आवश्यक क्वेरी पैरामीटर्स: स्क्रीन नाम
उदाहरण अनुरोध (जैसा है कॉपी-पेस्ट करें):
उदाहरण प्रतिक्रिया:
कार्यान्वयन सुझाव:
- प्रभाव को स्कोर करने या शोर वाले खातों को फ़िल्टर करने के लिए followers_count और friends_count का उपयोग करें।
- more_users संकेत करता है कि क्या अतिरिक्त परिणामों के लिए पृष्ठांकन उपलब्ध है; यदि सत्य है, तो अधिक पृष्ठों का अनुरोध करने के लिए इस बूलियन की जाँच करें (यदि API आपके योजना पर पृष्ठांकन को उजागर करता है, तो विवरण के लिए लिस्टिंग दस्तावेज़ देखें)।
4) उपयोगकर्ता प्रतिक्रियाएँ
एक उपयोगकर्ता की प्रतिक्रियाओं (और रीट्वीट्स) पर केंद्रित एक समयरेखा लौटाता है, जिसमें सहभागिता काउंटर और संदर्भित ट्वीट डेटा होता है।
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- आवश्यक क्वेरी पैरामीटर्स: स्क्रीन नाम
उदाहरण अनुरोध (जैसा है कॉपी-पेस्ट करें):
उदाहरण प्रतिक्रिया (यहाँ संक्षिप्त किया गया है जैसा प्रदान किया गया है):
{"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…
जिस पर ध्यान दें:
- created_at फ़ील्ड टाइमस्टैम्प स्ट्रिंग हैं; यदि आप समेकित करते हैं तो इसे स्टोरेज में UTC के रूप में सामान्यीकृत करें।
- entities डाउनस्ट्रीम NLP या लिंकिफिकेशन के लिए उल्लेख/हैशटैग प्रदान करते हैं।
- retweeted और retweeted_tweet आपको संदर्भ देते हैं ताकि आप रीट्वीट्स को प्रतिक्रियाओं से अलग तरीके से प्रदर्शित कर सकें।
प्रमाणीकरण
हर अनुरोध में हेडर शामिल होना चाहिए:
Authorization: Bearer YOUR_API_KEY
API कुंजी Zyla API Hub लिस्टिंग पर सदस्यता पर जारी की जाती है। कुंजी को क्वेरी पैरामीटर्स में न डालें।
कॉपी-पेस्ट करने योग्य कोड जिसे आप शिप कर सकते हैं
curl (आधिकारिक प्रोफ़ाइल उदाहरण)
Python: “About profile” प्राप्त करें और सत्यापन और सहयोगी बैज पढ़ें
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
def get_about_profile(screenname: str):
url = f"{BASE_URL}?screenname={screenname}"
resp = requests.get(url, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
data = get_about_profile("elonmusk")
# Core fields you likely need
status = data.get("status")
rest_id = data.get("rest_id")
name = data.get("name")
blue_verified = data.get("blue_verified")
avatar = data.get("avatar")
# Optional affiliate badge URL if present
affiliates = data.get("affiliates") or {}
label = (affiliates.get("label") or {})
badge = (label.get("badge") or {})
badge_url = badge.get("url")
print("status:", status)
print("rest_id:", rest_id)
print("name:", name)
print("blue_verified:", blue_verified)
print("avatar:", avatar)
print("affiliate_badge_url:", badge_url)
यह उदाहरण एकल स्क्रीन नाम के लिए About profile एंडपॉइंट को कॉल करता है, पहचानकर्ताओं और सत्यापन ध्वजों को निकालता है, और यदि मौजूद हो तो सुरक्षित रूप से नेस्टेड सहयोगी बैज URL तक पहुँचता है।
व्यावहारिक कार्यान्वयन नोट्स
- टाइमस्टैम्प: created_at मान टाइमस्टैम्प स्ट्रिंग हैं। स्टोरेज के लिए UTC के रूप में मानें और आवश्यकता अनुसार UI में स्थानीय समय में परिवर्तित करें।
- IDs: rest_id और id स्ट्रिंग हैं—सटीकता समस्याओं से बचने के लिए टेक्स्ट के रूप में स्टोर करें।
- कैशिंग: प्रोफाइल कम बार बदलते हैं; मिनटों से घंटों का TTL सामान्य है। समयरेखाएँ और फॉलोइंग सूचियाँ आपके UI के आधार पर छोटे TTL की आवश्यकता हो सकती हैं।
- पृष्ठांकन: Following प्रतिक्रिया में more_users शामिल है ताकि संकेत मिल सके कि अतिरिक्त पृष्ठ उपलब्ध हो सकते हैं। यदि सत्य है, तो पृष्ठांकन उपयोग के लिए अपने योजना पर लिस्टिंग दस्तावेज़ की जाँच करें।
- त्रुटि प्रबंधन: गैर-2xx प्रतिक्रियाओं को अस्थायी या अनुमति त्रुटियों के रूप में मानें और आपके एप्लिकेशन द्वारा उपयोग किए जाने वाले अनुरोध URL और सहसंबंध IDs को लॉग करें। थ्रॉटलिंग से बचने के लिए सावधानी से पुनः प्रयास करें।
- कोटा: पहुँच सदस्यता + कोटा है (प्रति कॉल भुगतान नहीं)। अनुरोध सीमाओं के लिए लिस्टिंग पर अपने योजना की जाँच करें। परीक्षण पर रहते हुए, लक्षित अनुरोध रखें (जैसे, क्लाइंट-साइड पर स्क्रीन नामों को बैच करें और डुप्लिकेट करें)।
वास्तविक दुनिया के पैटर्न जिन्हें आप जल्दी लागू कर सकते हैं
- साइनअप पर प्रोफ़ाइल समृद्धि: प्रोफ़ाइल फिर About profile को कॉल करें ताकि उपयोगकर्ता पृष्ठों पर अवतार, नाम, सत्यापन बैज, और स्थान प्रदर्शित किया जा सके।
- लेखक पृष्ठ साइडबार: Following प्राप्त करें और followers_count द्वारा शीर्ष खातों को टूलटिप्स के साथ हाइलाइट करें जो विवरण और profile_image का उपयोग करते हैं।
- उत्तर फ़ीड मॉड्यूल: User replies का उपयोग करें ताकि एक हैंडल से नवीनतम प्रतिक्रियाएँ/रीट्वीट्स दिखा सकें, काउंटर (प्रतिक्रियाएँ, रीट्वीट्स, उद्धरण) और उल्लेखों के लिए संस्थाएँ प्रदर्शित कर सकें।
- सत्यापन बैनर: blue_verified और affiliates.label.badge को पढ़ें ताकि सत्यापन या व्यवसाय लेबल को शर्तों के अनुसार प्रदर्शित किया जा सके।
AI एजेंटों के माध्यम से MCP से इस API को कॉल करने का तरीका
यदि आप डेवलपर टूल या AI कोडिंग एजेंटों का समन्वय करते हैं, तो आप Zyla के MCP एंडपॉइंट के माध्यम से कॉल रूट कर सकते हैं। MCP-संगत क्लाइंट (जैसे, Claude Code, Cursor, Windsurf) आपके उसी कुंजी का उपयोग करके मार्केटप्लेस APIs तक पहुँच सकते हैं। यहाँ दस्तावेज़ों के साथ शुरू करें: MCP.
उच्च-स्तरीय प्रवाह:
- MCP एंडपॉइंट और अपने Zyla API कुंजी को अपने MCP क्लाइंट को प्रदान करें।
- एजेंट से, आवश्यक क्वेरी पैरामीटर स्क्रीन नाम और Authorization हेडर के साथ विशिष्ट ट्विटर डेटा ऑल-इन-वन API एंडपॉइंट्स को सक्रिय करें।
- JSON को ठीक उसी तरह पार्स करें जैसा ऊपर के उदाहरणों में दिखाया गया है; वही फ़ील्ड्स लौटाए जाते हैं चाहे आप सीधे कॉल करें या MCP के माध्यम से।
एंडपॉइंट-द्वारा-एंडपॉइंट फ़ील्ड चेकलिस्ट
प्रोफ़ाइल
- पहचान: id, rest_id, name, profile
- प्रदर्शन: avatar, header_image, desc, location
- सत्यापन: blue_verified
- गतिविधि: statuses_count, media_count, friends, sub_count, pinned_tweet_ids_str
- जीवनचक्र: created_at, status
प्रोफ़ाइल के बारे में
- पहचान: id, rest_id, name, profile
- सत्यापन और संदर्भ: blue_verified, affiliates.label.badge.url, verified_since
- के बारे में: account_based_in, location_accurate, affiliate_username, source, username_changes.count
- प्रदर्शन: avatar
फॉलोइंग
- उपयोगकर्ता प्रविष्टियाँ: user_id, screen_name, name, description
- प्रदर्शन: profile_image
- गणक: followers_count, friends_count, statuses_count, media_count
- पृष्ठांकन संकेत: more_users
उपयोगकर्ता प्रतिक्रियाएँ
- ट्वीट प्रविष्टियाँ: tweet_id, text, created_at, lang, conversation_id
- सहभागिता: favorites, replies, retweets, quotes, bookmarks, views
- संस्थाएँ: user_mentions, urls, hashtags, symbols
- संलग्नकों के लिए मीडिया एरे
- संदर्भ: author, retweeted, retweeted_tweet
अपने एकीकरण का परीक्षण चरण-दर-चरण
1) सैनीटी-चेक प्रमाणीकरण
आधिकारिक प्रोफ़ाइल curl (ऊपर) चलाएँ। यदि आपको JSON वापस मिलता है, तो आपका Authorization हेडर मान्य है।
2) फ़ील्ड मैपिंग मान्य करें
पहले avatar, name, blue_verified को अपने UI में मैप करें; header_image या desc जैसे गायब फ़ील्ड्स के लिए पाठ रेंडरिंग और फॉलबैक लॉजिक की पुष्टि करें।
3) फॉलोइंग सूची जोड़ें
Following प्राप्त करें और followers_count द्वारा क्रमबद्ध एक छोटी सूची प्रदर्शित करें। inline अवतार के लिए profile_image का उपयोग करें।
4) प्रतिक्रियाएँ समयरेखा जोड़ें
स्थानीय समय में created_at को प्रदर्शित करें, यदि retweeted और retweeted_tweet मौजूद हैं तो रीट्वीट्स को अलग तरीके से दिखाएँ।
5) कैश करें और अवलोकन करें
अपने फीचर के लिए उपयुक्त TTL लागू करें। यदि आप बार-बार पृष्ठ लोड की अपेक्षा करते हैं तो प्रोफाइल के लिए 10–30 मिनट और समयरेखाओं के लिए 1–5 मिनट से शुरू करें।
सुरक्षा और संचालन
- YOUR_API_KEY को सर्वर-साइड कॉन्फ़िगरेशन या प्रबंधित रहस्यों में रखें, कभी भी क्लाइंट जावास्क्रिप्ट में नहीं।
- त्वरित त्रिज्या के लिए अनुरोध URLs (टोकन के बिना) और प्रतिक्रिया HTTP कोड लॉग करें।
- योजना सीमाओं को हिट करने से बचने के लिए लगातार गैर-2xx प्रतिक्रियाओं पर पीछे हटें।
- समृद्धि में विफल होने वाले पोस्ट के लिए एक न्यूनतम डेड-लेटर कतार बनाएं ताकि आप बाद में पुनः प्रयास कर सकें।
अक्सर पूछे जाने वाले प्रश्न
प्रश्न: मैं प्रमाणीकरण के लिए कौन सा हेडर उपयोग करूँ?
उत्तर: Authorization: Bearer YOUR_API_KEY.
प्रश्न: क्या मुझे प्रति उपयोगकर्ता OAuth की आवश्यकता है?
उत्तर: नहीं। आप अपने Zyla API कुंजी और एक स्क्रीन नाम के साथ सीधे मार्केटप्लेस एंडपॉइंट्स को कॉल करते हैं।
प्रश्न: मैं Following पर पृष्ठांकन को कैसे संभालूँ?
उत्तर: more_users बूलियन की जाँच करें। यदि सत्य है, तो अतिरिक्त पृष्ठों को प्राप्त करने के लिए अपने योजना पर लिस्टिंग दस्तावेज़ की जाँच करें।
प्रश्न: created_at टाइमस्टैम्प किस समय क्षेत्र में हैं?
उत्तर: created_at को UTC टाइमस्टैम्प स्ट्रिंग के रूप में मानें और आवश्यकता अनुसार क्लाइंट-साइड में परिवर्तित करें।
प्रश्न: क्या कोई मुफ्त योजना है?
उत्तर: कोई मुफ्त योजना नहीं है। API सदस्यता + कोटा मॉडल का उपयोग करता है। लिस्टिंग से 7-दिन की परीक्षण उपलब्ध है; वर्तमान विकल्पों के लिए पृष्ठ की जाँच करें।
क्या आप इसे अपने ऐप में वायर करने के लिए तैयार हैं? लिस्टिंग पर सदस्यता लें और अपनी कुंजी प्राप्त करें: Twitter डेटा ऑल-इन-वन API पर 7-दिन की परीक्षण शुरू करें. Zyla के मार्केटप्लेस में एकल कुंजी के साथ निर्माण करें और इस सप्ताह अपने सामाजिक डेटा एकीकरण को शिप करें।