आपको इस सप्ताह एक "सूचियों-जैसी" टाइमलाइन दृश्य भेजने की आवश्यकता है—एक उपयोगकर्ता की प्रोफ़ाइल दिखाएँ, एक साफ़ उत्तर फ़ीड खींचें, और इसे उन लोगों के साथ समृद्ध करें जिनका वे अनुसरण करते हैं। इस लेख के अंत तक, आप जानेंगे कि ज़ाइला API हब के ट्विटर डेटा ऑल-इन-वन API पर कॉल करने के लिए सटीक एंडपॉइंट्स क्या हैं ताकि एक उपयोगकर्ता प्रोफ़ाइल प्राप्त की जा सके, उनके उत्तर टाइमलाइन को पुनः प्राप्त किया जा सके, और यह गिनती की जा सके कि वे किसका अनुसरण करते हैं—आपके ऐप में एक संक्षिप्त, स्किम-फ्रेंडली टाइमलाइन घटक प्रस्तुत करने के लिए पर्याप्त।
यह API क्या प्रदान करता है और इसका उपयोग कब करें
ट्विटर डेटा ऑल-इन-वन API सार्वजनिक ट्विटर खातों के लिए संरचित डेटा लौटाता है। यहां कवर किए गए एंडपॉइंट्स के साथ आप:
- स्क्रीन नाम द्वारा एक प्रोफ़ाइल को हल करें, जिसमें स्थिति, अवतार, हेडर छवि, और गिनतियाँ शामिल हैं।
- सत्यापन, सहयोगी लेबल, और मूल जानकारी जैसे विस्तृत "प्रोफ़ाइल के बारे में" मेटाडेटा प्राप्त करें।
- लोगों-आधारित फ़ीड को बीज देने के लिए एक उपयोगकर्ता द्वारा अनुसरण किए गए खातों की सूची बनाएं।
- उपयोगकर्ता की उत्तर टाइमलाइन प्राप्त करें (जब आप केंद्रित, संवादात्मक सामग्री चाहते हैं तो "सूचियों की टाइमलाइन" के लिए एक व्यावहारिक स्टैंड-इन)।
ये टुकड़े आमतौर पर उपयोगकर्ता कार्ड, विवरण दृश्य, और डैशबोर्ड, CRM-साइडबार, अनुसंधान उपकरण, और आंतरिक निगरानी कंसोल में टाइमलाइन पैनों को शक्ति देने के लिए उपयोग किए जाते हैं।
ज़ाइला API हब पर शुरू करना
ज़ाइला API हब एक खाते, एक कुंजी, और एक सदस्यता मॉडल के पीछे 10,000 से अधिक सार्वजनिक APIs को केंद्रीकृत करता है। API के पृष्ठ को खोलें, सदस्यता लें, और सूचीबद्ध एंडपॉइंट्स के बीच अपनी कुंजी का उपयोग करें।
- ज़ाइला API हब खोलें और ट्विटर डेटा ऑल-इन-वन API पृष्ठ खोजें (CTA में लिंक नीचे)। ज़ाइला की सूची zylalabs.com पर ब्राउज़ करने योग्य है।
- अपनी API कुंजी उत्पन्न करने के लिए सदस्यता लें (या जब उपलब्ध हो तो मुफ्त परीक्षण शुरू करें)।
- नीचे दिए गए हब URLs पर Authorization: Bearer YOUR_API_KEY के साथ अनुरोध भेजें।
बिलिंग सदस्यता + कोटा है (प्रति कॉल भुगतान नहीं)। पहले API के लिए, आप 7-दिन के परीक्षण या 50 अनुरोधों की अपेक्षा कर सकते हैं—वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। कोई मुफ्त योजना नहीं है।
आप जिन एंडपॉइंट्स का उपयोग करेंगे
नीचे सार्वजनिक रूप से प्रलेखित हब URLs, HTTP विधियाँ, और आवश्यक पैरामीटर हैं जैसे कि प्रदान किया गया है। सभी अनुरोधों में हेडर Authorization: Bearer YOUR_API_KEY का उपयोग होता है। अतिरिक्त पैरामीटर न जोड़ें।
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"
}आप जो तुरंत उपयोग करेंगे:
- स्थिति: फ़etch समय पर खाता स्थिति।
- rest_id और id: आंतरिक पहचानकर्ता जिन्हें आप जोड़ों के लिए संग्रहीत कर सकते हैं।
- अवतार, हेडर_इमेज, नाम, विवरण, स्थान: प्रोफ़ाइल कार्ड प्रस्तुत करने के लिए।
- मित्र, सब्सक्राइबर, स्थिति_गिनती, मीडिया_गिनती: बैज/गिनती के लिए आँकड़े।
- created_at: UTC ऑफ़सेट (+0000) के साथ एक RFC822-जैसा टाइमस्टैम्प।
2) प्रोफ़ाइल के बारे में
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- आवश्यक क्वेरी पैरामीटर: स्क्रीन नाम (स्ट्रिंग)
- उद्देश्य: प्रोफ़ाइल के लिए अतिरिक्त सत्यापन, संबद्धता, और "के बारे में" मेटाडेटा लौटाता है।
यह एंडपॉइंट तब उपयोगी होता है जब आपको सत्यापित/बैज जानकारी और मूल विवरण की आवश्यकता होती है ताकि कोर प्रोफ़ाइल प्रतिक्रिया को पूरा किया जा सके।
3) अनुसरण करना
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- आवश्यक क्वेरी पैरामीटर: स्क्रीन नाम (स्ट्रिंग)
- उद्देश्य: उपयोगकर्ता द्वारा अनुसरण किए गए खातों की सूची लौटाता है, जिसमें प्रमुख गिनतियाँ और प्रोफ़ाइल जानकारी होती है।
इसे "अनुसरण करने के लिए लोग" अनुभाग बनाने, आपके टाइमलाइन को अनुसरण किए गए खातों के लिए ट्यून करने, या उत्तर फ़ीड को फ़िल्टर करने के लिए अनुमति सूचियाँ बनाने के लिए उपयोग करें।
4) उपयोगकर्ता उत्तर
- विधि: GET
- URL: https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- आवश्यक क्वेरी पैरामीटर: स्क्रीन नाम (स्ट्रिंग)
- उद्देश्य: उपयोगकर्ता के उत्तरों की एक सूची लौटाता है (एक केंद्रित, संवाद-भारी टाइमलाइन)।
उन डेवलपर्स के लिए जो एक "सूचियों की टाइमलाइन" अनुभव को शिप करने की कोशिश कर रहे हैं जो चयनात्मक चर्चा पर केंद्रित है न कि पूर्ण फायरहोज़ पर, एक उत्तर टाइमलाइन एक व्यावहारिक विकल्प है: एनालिटिक्स, समर्थन टिकट, या CRM रिकॉर्ड के बगल में एम्बेड करने के लिए एक छोटा, अधिक प्रासंगिक फ़ीड।
एक कार्यशील अनुरोध जिसे आप अभी चला सकते हैं
यहाँ वह आधिकारिक प्रोफ़ाइल फ़ेच है जिसे आप अपने टर्मिनल में पेस्ट कर सकते हैं। यह प्रोफ़ाइल एंडपॉइंट और प्राधिकरण हेडर का उपयोग करता है:
पायथन उदाहरण: एक संक्षिप्त प्रोफ़ाइल कार्ड प्रस्तुत करें
यह पायथन स्निपेट उसी प्रोफ़ाइल एंडपॉइंट को कॉल करता है, उन फ़ील्ड्स को पढ़ता है जिन्हें आप वास्तव में प्रस्तुत करते हैं, और एक सारांश प्रिंट करता है जिसे आप लॉग या टेम्पलेट में डाल सकते हैं।
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
SCREENNAME = "elonmusk"
URL = "https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile"
resp = requests.get(
URL,
params={"screenname": SCREENNAME},
headers={"Authorization": f"Bearer {API_KEY}"}
)
resp.raise_for_status()
data = resp.json()
card = {
"status": data.get("status"),
"id": data.get("id"),
"rest_id": data.get("rest_id"),
"name": data.get("name"),
"handle": data.get("profile"),
"avatar": data.get("avatar"),
"header_image": data.get("header_image"),
"desc": data.get("desc"),
"location": data.get("location"),
"counts": {
"friends": data.get("friends"),
"subscribers": data.get("sub_count"),
"statuses": data.get("statuses_count"),
"media": data.get("media_count"),
},
"created_at": data.get("created_at")
}
print("Profile card:")
for k, v in card.items():
print(f"- {k}: {v}")आप जो प्रतिक्रियाएँ पार्स करेंगे उन्हें समझना
प्रोफ़ाइल के बारे में
जब आप एक स्क्रीन नाम के साथ प्रोफ़ाइल के बारे में कॉल करते हैं, तो आपको सत्यापन, सहयोगियों, और "के बारे में" अनुभाग सहित विस्तृत मेटाडेटा प्राप्त होगा। सटीक उदाहरण:
आप जिन फ़ील्ड्स का उपयोग करेंगे:
- blue_verified: बैज प्रस्तुत करने के लिए बूलियन।
- affiliates.label.badge.url और affiliates.label.description: नाम के बगल में एक संगठन बैज दिखाएँ।
- about.account_based_in, about.source: प्रोफ़ाइल मूल पर संदर्भित टूलटिप्स।
अनुसरण करना
अनुसरण करने वाला एंडपॉइंट उन हल्के उपयोगकर्ता वस्तुओं का एक एरे लौटाता है जिनका प्रोफ़ाइल अनुसरण करता है। सटीक उदाहरण:
ध्यान देने योग्य फ़ील्ड्स:
- अनुसरण करना: चिप्स/कार्ड के लिए उपयुक्त गिनतियों के साथ खातों का एरे।
- more_users: यदि सत्य है, तो आपको पृष्ठांकन या बाद के फ़ेच के लिए योजना बनानी चाहिए।
उपयोगकर्ता उत्तर
उपयोगकर्ता उत्तर एंडपॉइंट उपयोगकर्ता के लिए एक संवाद-केंद्रित टाइमलाइन लौटाता है। सटीक उदाहरण (जैसा प्रदान किया गया है, संक्षिप्त):
{"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.
https:\/\/t.co\/B8boPofzKx","lang":"en","quotes":2,"replies":60,"retweets":10,"conv…कार्यान्वयन नोट्स:
- created_at एक RFC822-जैसा टाइमस्टैम्प है जिसमें UTC ऑफ़सेट (+0000) है। यदि आवश्यक हो तो अपने सेवा स्तर में UTC या ISO 8601 में सामान्यीकृत करें।
- entities स्वचालित लिंकिंग के लिए मानक URL, उल्लेख, और हैशटैग वस्तुओं को शामिल करते हैं।
- retweeted और retweeted_tweet तब प्रकट होते हैं जब आइटम एक रीट्वीट होता है; लगातार प्रस्तुत करने के लिए पाठ और नेस्टेड वस्तुओं दोनों की जांच करें।
इन टुकड़ों से "सूचियों की टाइमलाइन" कैसे बनाएं
हालांकि यहाँ कोई समर्पित "सूचियों की टाइमलाइन" एंडपॉइंट प्रलेखित नहीं है, आप निम्नलिखित को मिलाकर एक केंद्रित, सूची-जैसा फ़ीड बना सकते हैं:
- अनुसरण करने के लिए फ़ेच करें ताकि आपके उपयोगकर्ता के लिए रुचि के खातों का एक सेट बनाया जा सके।
- उपयोगकर्ता उत्तर फ़ेच करें ताकि उस उपयोगकर्ता से संवादात्मक आइटम सामने आ सकें—अक्सर निगरानी के लिए सबसे प्रासंगिक संकेत।
- बैज और संदर्भ (blue_verified, affiliate badge) के लिए प्रोफ़ाइल/प्रोफ़ाइल के बारे में मिलाएं ताकि विश्वास और स्रोत विवरण को इनलाइन प्रस्तुत किया जा सके।
यह दृष्टिकोण डैशबोर्ड के लिए व्यावहारिक है जहाँ आप एक संक्षिप्त, चर्चा-प्रथम दृश्य चाहते हैं न कि पूर्ण होम टाइमलाइन। प्रोफ़ाइल और अनुसरण परिणामों को कई मिनटों के लिए कैश करें ताकि दोहराए गए मेटाडेटा फ़ेच से बचा जा सके; यदि आप निकट-वास्तविक समय की गतिविधि प्रदर्शित करते हैं तो उत्तर फ़ेच को ताज़ा रखें।
समय बचाने वाले उत्पादन नोट्स
- Auth: प्रत्येक अनुरोध में Authorization: Bearer YOUR_API_KEY शामिल होना चाहिए।
- समय प्रबंधन: created_at फ़ील्ड में +0000 ऑफ़सेट शामिल है—UTC के रूप में व्यवहार करें। फ़ेच समय पर एक बार परिवर्तित करें और अपने DB में datetime के रूप में संग्रहीत करें।
- पृष्ठांकन: यदि more_users अनुसरण करने पर प्रकट होता है, तो अनुवर्ती फ़ेच के लिए योजना बनाएं। यदि एक टाइमलाइन एंडपॉइंट आपके UI में ट्रंकशन का संकेत देता है, तो "अधिक लोड करें" जोड़ें भले ही इसे अंश में नहीं दिखाया गया हो।
- कैशिंग: प्रोफ़ाइल और प्रोफ़ाइल के बारे में कम बार बदलते हैं। उन्हें उत्तरों या अन्य टाइमलाइनों से अलग कैश करें।
- कोटा: हब सदस्यता + कोटा का उपयोग करता है। पहले API के लिए, 7-दिन के परीक्षण या 50 अनुरोधों की अपेक्षा करें; सीमाएँ हार्डकोड न करें—आइटम पृष्ठ की जांच करें।
इन APIs को MCP के माध्यम से AI एजेंट से कॉल करें
यदि आप इसे एक AI कोडिंग एजेंट (Claude Code, Cursor, Windsurf या कोई भी MCP-संगत क्लाइंट) में वायर कर रहे हैं, तो इसे MCP एंडपॉइंट पर इंगित करें और अपने ज़ाइला कुंजी को URL में पास करें:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEYअपने एजेंट की MCP कॉन्फ़िगरेशन का उपयोग HTTP उपकरणों को उजागर करने और इस लेख में हब URLs पर कॉल को रूट करने के लिए करें। संदर्भ के लिए, देखें MCP. यह एक एजेंट को प्रोफ़ाइल पढ़ने, उत्तर फ़ेच करने, और परिवर्तनों पर पुनरावृत्ति करने की अनुमति देता है बिना आपको हर अनुरोध को हाथ से लिखे।
एंडपॉइंट संदर्भ: सटीक अनुरोध URLs और पैरामीटर
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3673/profile
- पैरामीटर: स्क्रीन नाम (स्ट्रिंग, आवश्यक)
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/22582/about-profile
- पैरामीटर: स्क्रीन नाम (स्ट्रिंग, आवश्यक)
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3679/following
- पैरामीटर: स्क्रीन नाम (स्ट्रिंग, आवश्यक)
- GET https://zylalabs.com/api/3399/twitter-data-all-in-one-api/3682/user-replies
- पैरामीटर: स्क्रीन नाम (स्ट्रिंग, आवश्यक)
इसे एक साथ रखना: "सूचियों-जैसे" पैनल के लिए न्यूनतम प्रवाह
- प्रोफ़ाइल लोड पर: प्रोफ़ाइल (अवतार, गिनतियाँ के लिए) और प्रोफ़ाइल के बारे में (सत्यापित और सहयोगी बैज के लिए) कॉल करें।
- अनुसरण करने के लिए पूर्व-फ़ेच करें और छोटे अंतराल (जैसे, 10–30 मिनट) के लिए कैश करें ताकि फ़िल्टर चिप्स या लोगों की सूचियों को शक्ति मिल सके।
- उपयोगकर्ता उत्तरों को स्क्रॉलिंग पैन में प्रस्तुत करें। उल्लेख और URLs को स्वचालित लिंक करने के लिए entities का उपयोग करें। यदि आप retweeted_tweet का पता लगाते हैं, तो नेस्टेड पाठ और गिनतियों को प्रदर्शित करें।
- जोड़े के लिए rest_id/id को संग्रहीत करें ताकि आप स्क्रीन नाम परिवर्तनों पर निर्भर न हों।
आप हमेशा ज़ाइला API हब सूची पर लौट सकते हैं ताकि बाद में इस दृश्य में अधिक क्षमताएँ जोड़ सकें; एक खाता और कुंजी zylalabs.com पर मार्केटप्लेस को कवर करते हैं।
अक्सर पूछे जाने वाले प्रश्न
मैं प्रमाणीकरण कैसे करूँ?
हर अनुरोध के साथ हेडर Authorization: Bearer YOUR_API_KEY को हब URLs पर भेजें जो ऊपर दिखाए गए हैं।
उत्तर किस टाइमस्टैम्प प्रारूप का उपयोग करते हैं?
created_at एक RFC822-जैसा स्ट्रिंग है जिसमें UTC ऑफ़सेट शामिल है (जैसे, Thu Dec 12 13:15:59 +0000 2024)। संग्रहण से पहले UTC या ISO 8601 में सामान्यीकृत करें।
क्या कोई समर्पित "सूचियों की टाइमलाइन" एंडपॉइंट है?
यहाँ सूचीबद्ध एंडपॉइंट्स में नहीं। आप अनुसरण करने के साथ उपयोगकर्ता उत्तरों को मिलाकर और प्रोफ़ाइल/प्रोफ़ाइल के बारे में मेटाडेटा के साथ समृद्ध करके एक सूचियों-शैली दृश्य का अनुमान लगा सकते हैं।
वर्तमान कोटा और मूल्य निर्धारण क्या हैं?
ज़ाइला सदस्यता + कोटा का उपयोग करता है (प्रति कॉल भुगतान नहीं)। पहले API के लिए, 7-दिन के परीक्षण या 50 अनुरोधों की अपेक्षा करें। वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें।
क्या मैं इन एंडपॉइंट्स को AI एजेंट से कॉल कर सकता हूँ?
हाँ। अपने MCP-संगत क्लाइंट में MCP एंडपॉइंट https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY का उपयोग करें और एजेंट के उपकरण कॉल के भीतर हब URLs पर अनुरोधों को रूट करें।
ट्विटर डेटा ऑल-इन-वन API पर 7-दिन का परीक्षण शुरू करें ताकि अपनी कुंजी प्राप्त करें और अपनी टाइमलाइन एकीकरण भेजें। एक खाता, एक कुंजी, ज़ाइला पर हजारों APIs।
