ट्विटर डेटा ऑल-इन-वन एपीआई का उपयोग कैसे करें

आपको लाइव ट्विटर (X) प्रोफ़ाइल विवरण, फॉलो सूची और एक उपयोगकर्ता की नवीनतम प्रतिक्रियाएँ खींचने की आवश्यकता है बिना एक स्क्रैपर बनाए और बनाए रखे। इस गाइड के अंत तक आप ट्विटर डेटा ऑल-इन-वन एपीआई पर ज़ाइला एपीआई हब पर प्रमाणित अनुरोध करेंगे ताकि एक प्रोफ़ाइल प्राप्त कर सकें, "about" मेटाडेटा प्राप्त कर सकें, यह सूची बना सकें कि एक उपयोगकर्ता किसे फॉलो करता है, और उनकी प्रतिक्रियाएँ पढ़ सकें—इस सप्ताह अपने सोशल मीडिया वर्कफ़्लो में डालने के लिए तैयार।

यह एपीआई क्या करता है और इसका उपयोग कब करें

ट्विटर डेटा ऑल-इन-वन एपीआई सार्वजनिक खाते के लिए ट्विटर (X) डेटा प्राप्त करने के लिए संरचित एंडपॉइंट प्रदान करता है: मुख्य प्रोफ़ाइल, अतिरिक्त प्रोफ़ाइल "about" जानकारी, फॉलोइंग सूची, और उपयोगकर्ता प्रतिक्रियाएँ। टीमें इसका उपयोग करती हैं:

• ऑनबोर्डिंग फ़्लो जो ट्विटर से उपयोगकर्ता बायो, अवतार और नाम को ऑटो-फिल करता है।
• सीआरएम/लीड समृद्धि—सत्यापित स्थिति और अनुयायी संदर्भ को संग्रहीत करना।
• क्रिएटर एनालिटिक्स—नए फॉलो और प्रतिक्रिया गतिविधि को ट्रैक करना।
• मॉडरेशन और मॉनिटरिंग—एक हैंडल से हाल की प्रतिक्रियाओं को स्कैन करना।

यह ज़ाइला एपीआई हब के माध्यम से वितरित किया गया है, जो एकल खाता, एक एपीआई कुंजी, और 10,000 से अधिक सार्वजनिक एपीआई के लिए एक सदस्यता-और-कोटा मॉडल प्रदान करता है। ट्विटर डेटा ऑल-इन-वन एपीआई सोशल मीडिया और नेटवर्किंग श्रेणी में आता है, इसलिए यह सामाजिक डेटा पाइपलाइनों में साफ़ तरीके से फिट बैठता है।

ज़ाइला एपीआई हब पर शुरू करना

ज़ाइला पर ट्विटर डेटा ऑल-इन-वन एपीआई पृष्ठ खोलें, सदस्यता लें या मुफ्त परीक्षण शुरू करें, और अपनी एपीआई कुंजी प्राप्त करें। एक खाते पर पहला एपीआई आमतौर पर 7-दिन का परीक्षण या 50 अनुरोध शामिल करता है; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए आइटम पृष्ठ की जांच करें। सभी अनुरोध Authorization: Bearer YOUR_API_KEY हेडर का उपयोग करते हैं—कोई अतिरिक्त टोकन की आवश्यकता नहीं है।

यहाँ से शुरू करें: ट्विटर डेटा ऑल-इन-वन एपीआई पर 7-दिन का परीक्षण शुरू करें.

आप एकल कुंजी के तहत अपने स्टैक में कई एपीआई को प्लग करने के लिए ज़ाइला एपीआई हब पर व्यापक मार्केटप्लेस को भी ब्राउज़ कर सकते हैं।

प्रमाणीकरण और अनुरोध पैटर्न

सभी एंडपॉइंट सरल GET अनुरोध हैं जब आवश्यक हो तो स्क्रीननेम पैरामीटर के साथ, और प्रमाणीकरण के लिए एक बियरर टोकन:

• हेडर: Authorization: Bearer YOUR_API_KEY
• पैराम: screenname (string), जैसे, elonmusk

इस गाइड में curl उदाहरणों को जस का तस कॉपी करें, YOUR_API_KEY को अपनी कुंजी से बदलें, और आपको तुरंत JSON प्रतिक्रियाएँ मिलेंगी।

आप जिन एंडपॉइंट्स का उपयोग करेंगे

1) प्रोफ़ाइल

हैंडल द्वारा एक मुख्य प्रोफ़ाइल प्राप्त करता है।

• विधि: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
• पैराम: screenname (आवश्यक)

आधिकारिक उदाहरण:

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"
}

आप वास्तव में क्या उपयोग करेंगे:

• UI प्रदर्शन के लिए name, desc, avatar, header_image।
• प्रमाणन बैज के लिए blue_verified।
• अपने डेटाबेस में स्थिर पहचानकर्ताओं के रूप में rest_id और id।
• खाते की उम्र की लॉजिक के लिए created_at।

2) प्रोफ़ाइल के बारे में

एक प्रोफ़ाइल के बारे में अतिरिक्त मेटाडेटा (संबंध, सत्यापन, "about" संदर्भ) लौटाता है।

• विधि: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
• पैराम: screenname (आवश्यक)

उदाहरण अनुरोध:

उदाहरण प्रतिक्रिया:

यह तब उपयोगी है जब आपको "blue_verified," संबंध बैज, या समृद्ध उपयोगकर्ता संदर्भ के लिए "about" ब्लॉक की आवश्यकता हो। स्क्रीननेम द्वारा बाद में पुनः-समाधान से बचने के लिए rest_id/id को अपने आंतरिक उपयोगकर्ता रिकॉर्ड के साथ संग्रहीत करें।

3) फॉलोइंग

एक उपयोगकर्ता द्वारा फॉलो किए गए खातों की सूची लौटाता है।

• विधि: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
• पैराम: screenname (आवश्यक)

उदाहरण अनुरोध:

उदाहरण प्रतिक्रिया:

मुख्य फ़ील्ड: user_id और screen_name को संबंधों को मैप करने के लिए; followers_count/friends_count के लिए त्वरित स्कोरिंग; more_users यह संकेत करता है कि क्या इस कॉल से अधिक परिणाम उपलब्ध हैं। कैशिंग करते समय, स्थिर कुंजी के रूप में user_id को प्राथमिकता दें।

4) उपयोगकर्ता प्रतिक्रियाएँ

एक उपयोगकर्ता की टाइमलाइन से प्रतिक्रियाओं की सूची प्राप्त करता है। सामुदायिक प्रबंधन, प्रभावशाली निगरानी, या "हाल की इंटरैक्शन" सुविधाएँ बनाने के लिए उपयोगी।

• विधि: GET
• URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
• पैराम: screenname (आवश्यक)

उदाहरण अनुरोध:

उदाहरण प्रतिक्रिया (स्रोत द्वारा संक्षिप्त):

{"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, created_at, text, retweets, replies, और entities.user_mentions शामिल हैं। created_at मान एक टाइमस्टैम्प स्ट्रिंग है; यदि आप इसे बनाए रखते हैं, तो इसे लिखने पर अपने पसंदीदा दिनांक समय प्रारूप में परिवर्तित करें।

एक अनुरोध जिसे आप अभी भेज सकते हैं

नीचे एक न्यूनतम पायथन उदाहरण है जो प्रोफ़ाइल के बारे में एंडपॉइंट को कॉल करता है और कुछ फ़ील्ड निकालता है जिन्हें आप आमतौर पर ऐप्स या वर्कफ़्लो में उपभोग करेंगे:

import requests

API_KEY = "YOUR_API_KEY"
SCREENNAME = "elonmusk"

url = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile"
params = {"screenname": SCREENNAME}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()

# सुरक्षित रूप से चयनित फ़ील्ड पढ़ें
rest_id = data.get("rest_id")
name = data.get("name")
blue_verified = data.get("blue_verified")
avatar = data.get("avatar")
about = data.get("about", {}) or {}
account_based_in = about.get("account_based_in")
affiliate_username = about.get("affiliate_username")

print({
"rest_id": rest_id,
"name": name,
"blue_verified": blue_verified,
"avatar": avatar,
"account_based_in": account_based_in,
"affiliate_username": affiliate_username
})

नोट्स:

• हमेशा Authorization हेडर को ठीक उसी तरह पास करें जैसा दिखाया गया है।
• यदि आप प्रतिक्रियाओं को कैश करते हैं, तो स्थिर पहचान के लिए rest_id/id को संग्रहीत करें।
• अवतार और हेडर छवियों के लिए, एक रिफ्रेश नीति पर विचार करें (जैसे, दैनिक) क्योंकि मीडिया यूआरएल बदल सकते हैं।

व्यावहारिक कार्यान्वयन विवरण जो समय बचाते हैं

• Authorization: सभी एंडपॉइंट्स को Authorization: Bearer YOUR_API_KEY की आवश्यकता होती है। अतिरिक्त टोकन या क्वेरी प्रमाणीकरण पैरामीटर न जोड़ें।
• पैरामीटर सतह: केवल स्क्रीननेम आवश्यक है जहाँ दिखाया गया है। अनडॉक्यूमेंटेड पैरामीटर न जोड़ें।
• टाइमस्टैम्प: created_at फ़ील्ड ट्विटर-शैली की स्ट्रिंग के रूप में प्रकट होते हैं (जैसे, Thu Mar 12 02:45:15 +0000 2009)। यदि आपका बैकएंड इसकी अपेक्षा करता है तो इसे ISO-8601 पर सामान्य करें।
• पहचान: एंडपॉइंट्स (प्रोफ़ाइल, प्रोफ़ाइल के बारे में, प्रतिक्रियाएँ) के बीच डुप्लिकेशन के लिए id/rest_id का उपयोग करें।
• फॉलोइंग पेजिनेशन: प्रतिक्रिया में more_users एक बूलियन संकेतक के रूप में शामिल है। यहाँ प्रदर्शित अनुरोध सतह पेजिनेशन पैरामीटर को प्रलेखित नहीं करती है; अपने समन्वय के अनुसार डिज़ाइन करें।
• कैशिंग: प्रोफ़ाइल और प्रोफ़ाइल के बारे में पर छोटे TTL (जैसे, मिनट से घंटे) पर विचार करें, और आपकी ताजगी की आवश्यकताओं के आधार पर फॉलोइंग/प्रतिक्रियाओं के लिए तंग लूप।
• त्रुटि हैंडलिंग: गैर-2xx को पुनः प्रयास योग्य या अलर्टिंग स्थितियों के रूप में मानें। JSON को सावधानी से पार्स करें क्योंकि कुछ नेस्टेड ऑब्जेक्ट्स शून्य या ऐरे हो सकते हैं।

सामान्य उपयोग के मामले

1) ट्विटर के साथ समृद्ध साइन-इन

पहली साइन-इन पर, उपयोगकर्ता रिकॉर्ड को नाम, desc, avatar, blue_verified, और संबंधों के साथ हाइड्रेट करने के लिए प्रोफ़ाइल और प्रोफ़ाइल के बारे में कॉल करें। blue_verified के आधार पर एक सत्यापित बैज प्रदर्शित करें।

2) लैंडिंग पृष्ठों पर सामाजिक प्रमाण

आपकी परवाह करने वाले विशेष खातों के लिए फॉलोअर्स_count और friends_count को फॉलोइंग आइटम से खींचें। "as of" टाइमस्टैम्प के साथ छोटे, कैश किए गए प्रोफ़ाइल कार्ड के लिए अवतार/नाम के साथ संयोजन करें।

3) क्रिएटर डैशबोर्ड

उपयोगकर्ता की नवीनतम प्रतिक्रियाएँ उपयोगकर्ता प्रतिक्रियाओं से प्रदर्शित करें जिसमें रीट्वीट, प्रतिक्रियाएँ, और उद्धरणों की गणना शामिल है। एक दिन या सप्ताह में कुल को रोल करें और रुझानों को प्लॉट करें।

4) सीआरएम समृद्धि

जब एक संभावित ग्राहक एक हैंडल प्रदान करता है, तो सत्यापन और सहयोगी लेबल की पुष्टि करने के लिए प्रोफ़ाइल के बारे में कॉल करें। भले ही वे अपना स्क्रीननेम बदलें, भविष्य के लुकअप के लिए rest_id को संग्रहीत करें।

एक एआई एजेंट के माध्यम से एपीआई कॉल करना MCP

आप ज़ाइला के मॉडल संदर्भ प्रोटोकॉल (MCP) एंडपॉइंट के माध्यम से अनुरोधों को क्लॉड कोड, कर्सर, विंडसर्फ, या किसी भी MCP-संगत क्लाइंट में रूट कर सकते हैं। अपने एजेंट/उपकरण को MCP एंडपॉइंट पर इंगित करें और अपनी एपीआई कुंजी शामिल करें:

• एंडपॉइंट: https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

वहाँ से, आपका एजेंट ऊपर प्रलेखित समान हब एंडपॉइंट्स को सक्रिय कर सकता है। यह तब उपयोगी है जब आप चाहते हैं कि आपका कोडिंग वातावरण या स्वायत्त एजेंट ट्विटर प्रोफ़ाइल डेटा, फॉलो सूची, या विकास के दौरान प्रतिक्रियाएँ इनलाइन प्राप्त करे। MCP परिवहन के बारे में अधिक जानकारी के लिए देखें MCP.

एंड-टू-एंड फ़्लो उदाहरण

1. प्राथमिक प्रोफ़ाइल रिकॉर्ड प्राप्त करें:
2. "about" जानकारी (सत्यापन, संबंध बैज) के साथ बढ़ाएँ:
3. यह प्राप्त करें कि उपयोगकर्ता किसे फॉलो कर रहा है (सामाजिक प्रमाण या नेटवर्क ग्राफ के लिए):
4. व्यस्तता विश्लेषण के लिए हाल की प्रतिक्रियाएँ सूचीबद्ध करें:

अपने डेटा मॉडल को सामान्य बनाए रखने के लिए कॉल के बीच rest_id/id को बनाए रखें। फ्रंटएंड के लिए, अवतार और हेडर छवियों को एक उचित TTL और एक ETag-जानकारी वाले CDN के साथ कैश करें जहाँ संभव हो।

समस्या निवारण चेकलिस्ट

• 401/403 त्रुटियाँ: सुनिश्चित करें कि आपका Authorization हेडर Bearer YOUR_API_KEY का उपयोग करता है और कि आपकी एपीआई पृष्ठ पर सदस्यता सक्रिय है।
• खाली या आंशिक ऐरे: उपयोगकर्ता की सीमित दृश्यता हो सकती है या उस श्रेणी में हाल का डेटा नहीं हो सकता है। खाली राज्यों को सुचारू रूप से संभालें।
• फ़ील्ड शून्यता: कुछ गुण (जैसे, business_account, affiliates) शून्य या खाली ऐरे हो सकते हैं। शून्य-सुरक्षित मैपर लिखें।
• अंतर्राष्ट्रीयकरण: टेक्स्ट और विवरण फ़ील्ड यूनिकोड हैं; सुनिश्चित करें कि UTF-8 अंत-से-अंत है।

अक्सर पूछे जाने वाले प्रश्न

प्रश्न 1: प्रमाणीकरण के लिए कौन सा हेडर आवश्यक है?
प्रत्येक अनुरोध पर Authorization: Bearer YOUR_API_KEY।

प्रश्न 2: न्यूनतम पैरामीटर सेट क्या है?
दिखाए गए एंडपॉइंट्स के लिए, स्क्रीननेम को एक आवश्यक क्वेरी पैरामीटर (जैसे, screenname=elonmusk) के रूप में पास करें।

प्रश्न 3: क्या मैं फॉलोइंग परिणामों को पेजिनेट कर सकता हूँ?
प्रतिक्रिया में more_users एक बूलियन संकेतक के रूप में शामिल है। पेजिनेशन के लिए अनुरोध पैरामीटर यहाँ प्रलेखित नहीं हैं; वर्तमान व्यवहार के लिए एपीआई पृष्ठ पर परामर्श करें।

प्रश्न 4: क्या सभी उपयोगकर्ताओं के बीच कोई गारंटीकृत फ़ील्ड हैं?
सभी फ़ील्ड गारंटीकृत नहीं हैं। कुछ शून्य या अनुपस्थित हो सकते हैं खाते के आधार पर। हमेशा अस्तित्व की जांच करें और शून्य को संभालें।

प्रश्न 5: मैं इसे एआई कोडिंग सहायक से कैसे कॉल करूँ?
अपने MCP-संगत क्लाइंट को https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY पर इंगित करें और समान हब एंडपॉइंट्स को सक्रिय करें। विवरण के लिए इस लेख में MCP लिंक देखें।

क्या आप इसे अपने स्टैक में जोड़ने के लिए तैयार हैं? एक मुफ्त खाता बनाएं, अपनी कुंजी प्राप्त करें, और आइटम पृष्ठ से 7-दिन के परीक्षण के साथ निर्माण शुरू करें: ट्विटर डेटा ऑल-इन-वन एपीआई पर 7-दिन का परीक्षण शुरू करें. यदि आप कई सेवाओं को एकीकृत कर रहे हैं, तो याद रखें कि आप सभी को ज़ाइला एपीआई हब पर एकल कुंजी के तहत प्रबंधित कर सकते हैं।