आपको इस सप्ताह एक सोशल मीडिया इंटीग्रेशन भेजने की आवश्यकता है जो विश्वसनीय ट्विटर प्रोफ़ाइल डेटा और संबंध खींचता है, और आप स्पष्ट प्रमाणीकरण, पूर्वानुमानित बिलिंग और कॉपी-पेस्ट करने योग्य कॉल चाहते हैं। इस गाइड के अंत तक, आप ज़ाइला एपीआई हब पर ट्विटर डेटा ऑल-इन-वन एपीआई के खिलाफ प्रमाणीकरण करेंगे, उत्पादन एंडपॉइंट्स को कॉल करेंगे, प्रतिक्रियाओं को पार्स करेंगे, और यहां तक कि इसे अपने एआई एजेंट से एमसीपी के माध्यम से कनेक्ट करेंगे।
आप ट्विटर डेटा ऑल-इन-वन एपीआई के साथ क्या बना सकते हैं
Twitter Data All-in-One API आपको पुनः प्राप्त करने की अनुमति देता है:
- एक ट्विटर प्रोफ़ाइल के बारे में अतिरिक्त जानकारी (प्रमाणन, rest_id, अवतार, सहयोगी, स्थान मेटाडेटा)।
- उन खातों की सूची जिन्हें एक उपयोगकर्ता फॉलो कर रहा है।
- एक उपयोगकर्ता की प्रतिक्रियाओं की सूची।
विशिष्ट उपयोग के मामलों में निर्माता ऑनबोर्डिंग, सीआरएम/सोशल समृद्धि, ब्रांड निगरानी, और एजेंटिक वर्कफ़्लो शामिल हैं जिन्हें ट्विटर से ताज़ा उपयोगकर्ता संदर्भ की आवश्यकता होती है बिना ओऑथ जटिलता से निपटे।
प्रमाणीकरण और बिलिंग: ज़ाइला एपीआई हब पर यह कैसे काम करता है
ज़ाइला एपीआई हब एक खाता और एक एपीआई कुंजी प्रदान करता है जिसका आप 10,000 से अधिक सार्वजनिक एपीआई में उपयोग कर सकते हैं, जिसमें यह सोशल मीडिया लिस्टिंग शामिल है। प्रमाणीकरण सरल है: हर अनुरोध पर zylalabs.com एंडपॉइंट्स के लिए हेडर Authorization: Bearer YOUR_API_KEY पास करें।
बिलिंग सब्सक्रिप्शन प्लस कोटा है (पे-पर-कॉल नहीं)। आपकी पहली एपीआई सब्सक्रिप्शन के लिए, आप वर्तमान उपलब्धता के आधार पर 7-दिन की परीक्षण या 50 अनुरोधों के साथ शुरू कर सकते हैं। कोई मुफ्त योजना नहीं है। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
आप कभी भी एक मूल एक्सेस कुंजी या एक विक्रेता-विशिष्ट टोकन पास नहीं करते हैं—केवल आपकी ज़ाइला एपीआई हब कुंजी।
ज़ाइला एपीआई हब पर शुरू करना
- एपीआई पृष्ठ खोलें: Twitter Data All-in-One API.
- सब्सक्राइब या फ्री ट्रायल शुरू करने के लिए क्लिक करें (जब उपलब्ध हो)। सब्सक्रिप्शन+कोटा योजना के लिए चेकआउट पूरा करें।
- अपने डैशबोर्ड से अपनी एपीआई कुंजी कॉपी करें। आप इसे सभी कॉल के लिए प्रमाणीकरण हेडर में उपयोग करेंगे।
यदि आप ज़ाइला में नए हैं, तो आप यहां अपना खाता बना सकते हैं: पंजीकरण करें. जब आप अधिक इंटीग्रेशन जोड़ने के लिए तैयार हों, तो zylalabs.com पर व्यापक मार्केटप्लेस का अन्वेषण करें।
आप आज जिन एंडपॉइंट्स को कॉल कर सकते हैं
नीचे सभी एंडपॉइंट्स GET का उपयोग करते हैं और प्रमाणीकरण हेडर की आवश्यकता होती है। आवश्यक पैरामीटर ठीक उसी तरह सूचीबद्ध हैं जैसे लागू किया गया है।
प्रोफ़ाइल के बारे में
- विधि: GET
- यूआरएल: 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"}
क्या उपयोग करें: - rest_id और id: स्थिर पहचानकर्ता जिन्हें आप अपने DB में संग्रहीत कर सकते हैं। - blue_verified: प्रमाणीकरण स्थिति के लिए बूलियन। - अवतार और नाम: UI के लिए डिस्प्ले तत्व। - affiliates.label फ़ील्ड: व्यवसाय/सहयोगी संदर्भ का स्नैपशॉट। - about.account_based_in और संबंधित फ़ील्ड: समृद्धि मेटाडेटा।
फॉलोइंग
- विधि: GET
- यूआरएल: 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"
उदाहरण प्रतिक्रिया फ़ील्ड में following (user_id, screen_name, description, profile_image, statuses_count, followers_count, friends_count, media_count, name के साथ एक ऐरे), status, और more_users (boolean यह इंगित करता है कि क्या अधिक डेटा उपलब्ध हो सकता है) शामिल हैं।
उपयोगकर्ता प्रतिक्रियाएँ
- विधि: GET
- यूआरएल: 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"
प्रतिक्रिया में टाइमलाइन प्रविष्टियाँ होती हैं जिनमें tweet_id, created_at (UTC स्ट्रिंग), text, counts (retweets, replies, quotes, favorites), entities, और लेखक मेटाडेटा शामिल होते हैं। इसका उपयोग प्रतिक्रिया धाराओं को प्रस्तुत करने या मॉडरेशन/सगाई वर्कफ़्लो को शक्ति देने के लिए करें।
एंड-टू-एंड कोड: प्रोफ़ाइल के बारे में पायथन में
नीचे का स्निपेट आपके ज़ाइला कुंजी के साथ प्रमाणीकरण करता है, प्रोफ़ाइल के बारे में कॉल करता है, और संग्रहण या UI के लिए प्रमुख फ़ील्ड निकालता है।
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=15)
resp.raise_for_status()
data = resp.json()
profile = {
"rest_id": data.get("rest_id"),
"id": data.get("id"),
"screenname": data.get("profile"),
"name": data.get("name"),
"avatar": data.get("avatar"),
"blue_verified": data.get("blue_verified"),
"account_based_in": (data.get("about") or {}).get("account_based_in"),
}
print(profile)
टाइमस्टैम्प, काउंट और पेजिनेशन की व्याख्या करना
- टाइमस्टैम्प: User replies में created_at एक स्ट्रिंग है जैसे "Thu Dec 12 13:15:59 +0000 2024" (UTC)। एक मजबूत RFC2822-जैसे पार्सर या एक फ़ॉर्मेट स्ट्रिंग का उपयोग करें जो समय क्षेत्र को संभालता है।
- कैशिंग: प्रोफ़ाइल विवरण (अवतार, प्रमाणीकरण, सहयोगी) बदलते हैं लेकिन ट्वीट्स की तुलना में कम बार। आपकी ताजगी की आवश्यकताओं के आधार पर मिनटों से घंटों के लिए प्रोफ़ाइल के बारे में कैश करें; प्रतिक्रियाओं के लिए छोटे समय के लिए कैश करें।
- पेजिनेशन: Following प्रतिक्रिया में more_users (boolean) शामिल है। जब सत्य हो, तो अपने ऐप लॉजिक में बाद के फ़ेच के लिए योजना बनाएं। हब एंडपॉइंट के पेजिनेशन पैरामीटर यहां प्रदर्शित नहीं किए गए हैं; अपडेट के लिए एपीआई पृष्ठ पर परामर्श करें।
- कोटा: उपयोग आपकी सब्सक्रिप्शन कोटा से खींचता है। अपने ज़ाइला डैशबोर्ड में अपने कोटा की निगरानी करें। कोई मुफ्त योजना नहीं है। पहली बार एपीआई सब्सक्रिप्शन के लिए, 7-दिन की परीक्षण या 50 अनुरोध उपलब्ध हो सकते हैं; वर्तमान पहुंच के लिए एपीआई पृष्ठ की जांच करें।
वास्तविक दुनिया के कार्यान्वयन पैटर्न
साइनअप पर उपयोगकर्ता रिकॉर्ड समृद्ध करें
जब एक उपयोगकर्ता ट्विटर हैंडल प्रदान करता है तो प्रोफ़ाइल के बारे में एक बार कॉल करें। rest_id, blue_verified, avatar, और name संग्रहीत करें। यह प्रोफाइल को ऑटो-फिल करने और ऑनबोर्डिंग में प्रामाणिकता संकेतों को सत्यापित करने में मदद करता है।
"वे किसे फॉलो करते हैं" पैनल क्यूरेट करें
आपके ऐप में आपसी रुचियों को दिखाने या खातों की सिफारिश करने के लिए Following का उपयोग करें। screen_name, name, और profile_image को बनाए रखें। यदि more_users सत्य है, तो बैच फ़ेच लॉजिक डिज़ाइन करें या UI को आंशिक परिणामों की जानकारी दें।
मॉडरेशन और सगाई उपकरण
आपके द्वारा ट्रैक किए गए हैंडल के लिए हाल की प्रतिक्रिया गतिविधि को सतह करने के लिए User replies का उपयोग करें। उल्लेखों और लिंक को उजागर करने के लिए पाठ और संस्थाओं को पार्स करें। आउटरीच को प्राथमिकता देने के लिए काउंट (retweets, replies) द्वारा ट्रायेज़ करें।
एजेंटिक सहायक जिन्हें सामाजिक संदर्भ की आवश्यकता होती है
बेसलाइन संदर्भ के लिए About profile और हाल के लिए User replies को मिलाएं। आपका एजेंट प्रमाणीकरण स्थिति, सहयोगी लेबल विवरण, और नवीनतम इंटरैक्शन का संदर्भ ले सकता है।
MCP के माध्यम से एआई एजेंटों से एपीआई कॉल करना
हर ज़ाइला एपीआई एआई एजेंटों के लिए MCP एंडपॉइंट के माध्यम से उपलब्ध है, जो क्लॉड कोड, कर्सर, विंडसर्फ, और किसी भी MCP-सक्षम क्लाइंट के साथ संगत है। अपने क्लाइंट को इस पर इंगित करें:
अपने ज़ाइला कुंजी को MCP क्लाइंट कॉन्फ़िगरेशन में अपने उपकरण द्वारा आवश्यकतानुसार पास करें। वही Authorization: Bearer YOUR_API_KEY अंदर लागू होता है, इसलिए आपको प्रति एपीआई अलग टोकन की आवश्यकता नहीं है। गैर-एजेंट इंटीग्रेशन के लिए, ऊपर वर्णित HTTPS एंडपॉइंट्स को सीधे कॉल करें।
उत्पादन के लिए संचालन चेकलिस्ट
- प्रमाणीकरण: हमेशा Authorization: Bearer YOUR_API_KEY सेट करें।
- इनपुट मान्यता: गंदगी अनुरोधों से बचने के लिए screenname को अपेक्षित वर्णों तक सीमित करें।
- टाइमआउट और पुनः प्रयास: एक उचित टाइमआउट (जैसे, 10–20s) और अस्थायी विफलताओं के लिए एक सीमित पुनः प्रयास नीति का उपयोग करें।
- कैशिंग: User replies की तुलना में About profile को अधिक समय तक कैश करें; अपने UI अपेक्षाओं के साथ TTL को संरेखित करें।
- निगरानी: स्थिति, विलंबता, और प्रतिक्रिया आकार लॉग करें। अपने ज़ाइला डैशबोर्ड में कोटा बर्न को ट्रैक करें।
- डेटा संरक्षण: केवल उन फ़ील्ड को संग्रहीत करें जिनकी आपको वास्तव में आवश्यकता है (जैसे, rest_id, name, avatar, blue_verified) ताकि PII एक्सपोज़र को कम किया जा सके।
ज़ाइला पर अन्वेषण के और तरीके
एक बार जब आप ट्विटर डेटा ऑल-इन-वन एपीआई के साथ चालू हो जाते हैं, तो आप उसी मार्केटप्लेस से समान कुंजी का उपयोग करके आसन्न सोशल मीडिया एपीआई जोड़ सकते हैं। zylalabs.com पर कैटलॉग ब्राउज़ करें और एक क्लिक के साथ सब्सक्राइब करें। याद रखें: एक खाता, एक एपीआई कुंजी, और एक सब्सक्रिप्शन + कोटा मॉडल जो 10,000 से अधिक सार्वजनिक एपीआई में स्केल करता है।
फॉलोइंग के लिए कॉपी-रेडी कर्ल और एक त्वरित पार्स टिप
इसे उपयोगकर्ता द्वारा फॉलो किए गए खातों के पहले पृष्ठ को सूचीबद्ध करने के लिए उपयोग करें। more_users ध्वज आपको यह तय करने में मदद करता है कि क्या अपने कार्यप्रवाह में अतिरिक्त डेटा लाना है।
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"
UI को Populate करने या सिफारिश लॉजिक को फीड करने के लिए user_id, screen_name, name, followers_count, और profile_image जैसे फ़ील्ड की जांच करें। यदि more_users गलत है, तो आपके पास उस अनुरोध के लिए एक पूर्ण परिणाम सेट है।
समस्या निवारण टिप्स
- 401 Unauthorized: अपने Authorization हेडर की वर्तनी और मान की पुष्टि करें। सुनिश्चित करें कि कुंजी उस खाते के लिए है जिसने इस एपीआई की सदस्यता ली है।
- गायब या अमान्य screenname: आवश्यक screenname को ठीक उसी तरह प्रदान करें जैसा कि दस्तावेज़ित किया गया है (जैसे, elonmusk)।
- कोटा समाप्त: अपने ज़ाइला डैशबोर्ड की जांच करें और अपने योजना नियमों के अनुसार कोटा रीसेट के लिए अपग्रेड या प्रतीक्षा करें।
- डेटा ताजगी: यदि आप आक्रामक रूप से कैश करते हैं, तो समय के साथ अवतार और काउंट में भिन्नता की अपेक्षा करें; महत्वपूर्ण दृश्य पर ताज़ा करें।
अक्सर पूछे जाने वाले प्रश्न
मैं अनुरोधों का प्रमाणीकरण कैसे करता हूँ?
हर HTTPS अनुरोध पर zylalabs.com एंडपॉइंट्स के लिए हेडर Authorization: Bearer YOUR_API_KEY जोड़ें।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। आपकी पहली एपीआई सब्सक्रिप्शन के लिए, आप 7-दिन की परीक्षण या 50 अनुरोधों के साथ शुरू कर सकते हैं जब उपलब्ध हो। वर्तमान विकल्पों और मूल्य निर्धारण के लिए एपीआई पृष्ठ की जांच करें।
कौन से पैरामीटर आवश्यक हैं?
सभी सूचीबद्ध एंडपॉइंट्स को screenname (string) की आवश्यकता होती है। यहां उदाहरण के लिए, यह elonmusk है। दस्तावेज़ित मार्गों द्वारा कोई अन्य पैरामीटर आवश्यक नहीं है।
मैं पेजिनेशन को कैसे संभालूं?
Following एंडपॉइंट more_users (boolean) लौटाता है। इसका उपयोग करें यह पता लगाने के लिए कि क्या अतिरिक्त डेटा उपलब्ध हो सकता है। पेजिनेशन पैरामीटर इस दस्तावेज़ में प्रदर्शित नहीं किए गए हैं; अपडेट के लिए एपीआई पृष्ठ की जांच करें।
क्या मैं इन एपीआई को एआई एजेंट से कॉल कर सकता हूँ?
हाँ। ज़ाइला एमसीपी एंडपॉइंट और आपकी ज़ाइला एपीआई कुंजी का उपयोग करें। विवरण के लिए MCP लिंक देखें।
क्या आप सरल, सुसंगत प्रमाणीकरण के साथ ट्विटर डेटा ऑल-इन-वन एपीआई को एकीकृत करने के लिए तैयार हैं? अभी अपना खाता बनाएं और अपनी एपीआई कुंजी प्राप्त करें: पंजीकरण करें. फिर Twitter Data All-in-One API पर एपीआई लिस्टिंग खोलें और आज एंडपॉइंट्स को कॉल करना शुरू करें।