| ऑब्जेक्ट | विवरण | फ़ील्ड्स पैरामीटर |
|---|---|---|
| पोस्ट (Tweet) | पोस्ट्स, जवाब, रीपोस्ट और कोट पोस्ट | tweet.fields |
| उपयोगकर्ता | अकाउंट प्रोफ़ाइल और मेटाडेटा | user.fields |
| स्पेस | लाइव ऑडियो बातचीत | space.fields |
| सूची | अकाउंट्स के चुने हुए संग्रह | list.fields |
| मीडिया | इमेज, वीडियो, GIF | media.fields |
| पोल | पोल प्रश्न और विकल्प | poll.fields |
| स्थान | लोकेशन और जियो डेटा | place.fields |
पोस्ट (Tweet)
id, text, edit_history_tweet_ids
अतिरिक्त फ़ील्ड्स का अनुरोध करने के लिए tweet.fields का उपयोग करें और संबंधित ऑब्जेक्ट्स शामिल करने के लिए expansions का उपयोग करें।
पोस्ट के सभी फ़ील्ड्स
| फ़ील्ड का मान | type | विवरण | इसे कैसे इस्तेमाल किया जा सकता है |
|---|---|---|---|
| id (डिफ़ॉल्ट) | string | अनुरोधित Tweet का अद्वितीय पहचानकर्ता। | किसी विशिष्ट Tweet को प्रोग्रामेटिक रूप से प्राप्त करने के लिए इसका उपयोग करें। |
| text (डिफ़ॉल्ट) | स्ट्रिंग | Tweet का वास्तविक UTF-8 टेक्स्ट। मान्य वर्णों के बारे में जानकारी के लिए twitter-text देखें। | कीवर्ड निष्कर्षण और भाव विश्लेषण/वर्गीकरण। |
| edit_history_tweet_ids (डिफ़ॉल्ट) | ऑब्जेक्ट | ऐसे अद्वितीय पहचानकर्ता जो किसी Tweet के सभी संस्करणों को दर्शाते हैं। जिन Tweets में कोई संपादन नहीं हुआ है, उनके लिए एक ID होगी। जिन Tweets का संपादन इतिहास है, उनके लिए कई IDs होंगी। | किसी Tweet का संपादन इतिहास पता लगाने के लिए इस जानकारी का उपयोग करें। |
| article | ऑब्जेक्ट | इस Tweet में मौजूद Article का मेटाडेटा शामिल है। | किसी Article का टेक्स्ट और entities प्राप्त करने के लिए इसका उपयोग करें। |
| attachments | object | यह इस Tweet में मौजूद attachments के type (यदि कोई हों) को निर्दिष्ट करता है। | अनुरोधित expansions के लिए लौटाए गए objects को समझने के लिए। |
| author_id | string | इस Tweet को पोस्ट करने वाले यूज़र का अद्वितीय पहचानकर्ता। | यूज़र ऑब्जेक्ट को हाइड्रेट करना, सहकर्मी समीक्षा के लिए डेटासेट साझा करना। |
| card_uri | string | इस Tweet में मौजूद Card का URI। | |
| community_id | string | उस Community का अद्वितीय पहचानकर्ता, जिससे यह पोस्ट संबंधित है। | |
| context_annotations | array | इसमें Tweet के संदर्भ एनोटेशन शामिल हैं। | इकाई पहचान/निष्कर्षण, विषयगत विश्लेषण। |
| conversation_id | string | वार्तालाप के मूल Tweet की Tweet ID (जिसमें सीधे जवाब और जवाबों के जवाब शामिल हैं)। | किसी Tweet से बातचीत को फिर से बनाने के लिए इसका उपयोग करें। |
| created_at | दिनांक (ISO 8601) | Tweet के बनाए जाने का समय। | समय-श्रृंखला विश्लेषण के लिए और यह समझने के लिए उपयोगी कि कोई Tweet कब बनाया गया था। |
| display_text_range | सरणी | एक ऐसी सरणी, जिसमें प्रदर्शित होने वाले टेक्स्ट के हिस्से के लिए आरंभ और अंत इंडेक्स शामिल हैं। | यह जानने के लिए उपयोगी है कि लंबे पोस्ट्स में डिफ़ॉल्ट रूप से टेक्स्ट का कौन-सा हिस्सा प्रदर्शित होता है। |
| edit_controls | ऑब्जेक्ट | यह बताता है कि Tweet को और कितनी देर तक संपादित किया जा सकता है और कितने संपादन शेष हैं। | यह निर्धारित करने के लिए इसका उपयोग करें कि कोई Tweet संपादन के योग्य है या नहीं। |
| entities | object | Tweet के टेक्स्ट से पार्स की गई एंटिटीज़। Twitter Objects में entities देखें। | हैशटैग, URL, उल्लेख आदि के बारे में अतिरिक्त जानकारी देता है। |
| geo | object | जियो-टैग किए गए Tweet के स्थान को दर्शाता है। | जियो-टैग किए गए Tweet का स्थान जानने के लिए इसका उपयोग करें। |
| in_reply_to_user_id | string | यदि संबंधित Tweet एक उत्तर है, तो इस फ़ील्ड में मूल Tweet के लेखक की ID होगी। | यह निर्धारित करें कि कोई Tweet किसी दूसरे Tweet के जवाब में था या नहीं। |
| lang | string | अगर Twitter ने इसका पता लगाया है, तो Tweet की भाषा। | बोली जाने वाली भाषा के आधार पर Tweets को वर्गीकृत करें। |
| non_public_metrics | object | अनुरोध के समय Tweet के लिए गैर-सार्वजनिक एंगेजमेंट मेट्रिक्स। इसके लिए यूज़र कॉन्टेक्स्ट ऑथेंटिकेशन आवश्यक है। | Tweet के लिए उत्पन्न कुल इम्प्रेशन्स निर्धारित करें। |
| note_tweet | ऑब्जेक्ट | लंबे-फ़ॉर्म पोस्ट्स (>280 वर्ण) के लिए पोस्ट का पूरा टेक्स्ट शामिल है। | किसी पोस्ट का पूरा टेक्स्ट प्राप्त करें। |
| organic_metrics | object | अनुरोध के समय Tweet के लिए ऑर्गेनिक संदर्भ में ट्रैक किए गए एंगेजमेंट मेट्रिक्स। इसके लिए यूज़र कॉन्टेक्स्ट ऑथेंटिकेशन आवश्यक है। | Tweet के लिए ऑर्गेनिक एंगेजमेंट मापें। |
| possibly_sensitive | boolean | यह दर्शाता है कि सामग्री को संभावित रूप से संवेदनशील माना जा सकता है या नहीं। | कुछ प्रकार की सामग्री के प्रसार का अध्ययन करें। |
| promoted_metrics | ऑब्जेक्ट | अनुरोध के समय Tweet के लिए प्रचारित संदर्भ में ट्रैक किए गए एंगेजमेंट मेट्रिक्स। इसके लिए उपयोगकर्ता-संदर्भ प्रमाणीकरण आवश्यक है। | Tweet के प्रमोट किए जाने पर उसकी सहभागिता मापें। |
| public_metrics | ऑब्जेक्ट | अनुरोध के समय Tweet के लिए सार्वजनिक सहभागिता मेट्रिक्स। | Tweet की सहभागिता मापें। |
| referenced_tweets | ऐरे | उन Tweets की सूची, जिनका संदर्भ यह Tweet देता है, जैसे Retweets, उद्धृत Tweets या जवाब. | रेट्वीट आदि के संवाद-संबंधी पहलुओं को समझें. |
| reply_settings | string | यह दर्शाता है कि किसी दिए गए Tweet का जवाब कौन दे सकता है. विकल्प हैं “everyone”, “mentioned_users”, और “followers”. | Tweet के लिए बातचीत के जवाब की सेटिंग तय करें। |
| withheld | ऑब्जेक्ट | रोकी गई सामग्री से संबंधित रोक विवरण शामिल हैं। | |
| scopes | ऑब्जेक्ट | Tweet के स्कोप का विवरण शामिल है। | यह बताता है कि पोस्ट को कौन देख सकता है। यह केवल प्रचारित पोस्ट्स के लिए लौटाया जाता है। |
| media_metadata | array | इसमें Tweet के मीडिया अटैचमेंट्स का मेटाडेटा शामिल है। | किसी Tweet के मीडिया अटैचमेंट का alt_text जैसे अतिरिक्त मेटाडेटा प्राप्त करें. |
$BEARER_TOKEN को अपने जनरेट किए गए बेयरर टोकन से बदलना न भूलें।
User
user.fields का उपयोग करें।
user ऑब्जेक्ट Tweet ऑब्जेक्ट में एक चाइल्ड ऑब्जेक्ट के रूप में भी मिल सकता है और इसे expand भी किया जा सकता है। केवल डिफ़ॉल्ट फ़ील्ड्स वाला संक्षिप्त ऑब्जेक्ट पाने के लिए, यह ऑब्जेक्ट ?expansions=author_id या ?expansions=in_reply_to_user_id के साथ expansion के लिए उपलब्ध है। ऑब्जेक्ट को पूरा करने के लिए अतिरिक्त फ़ील्ड्स का अनुरोध करते समय, फ़ील्ड्स पैरामीटर user.fields के साथ expansion का उपयोग करें।
| फ़ील्ड मान | Type | विवरण | इसका उपयोग कैसे किया जा सकता है |
|---|---|---|---|
| id (डिफ़ॉल्ट) | string | इस उपयोगकर्ता की विशिष्ट पहचान।"id": "2244994945" | किसी विशिष्ट Twitter उपयोगकर्ता के बारे में जानकारी प्रोग्राम के माध्यम से प्राप्त करने के लिए इसका उपयोग करें। |
| नाम (डिफ़ॉल्ट) | स्ट्रिंग | उपयोगकर्ता का वह नाम, जैसा उन्होंने अपनी प्रोफ़ाइल पर तय किया है। यह ज़रूरी नहीं कि वह किसी व्यक्ति का वास्तविक नाम ही हो। आम तौर पर यह 50 वर्णों तक सीमित होता है, लेकिन इसमें बदलाव हो सकता है।"name": "Twitter Dev" | |
| यूज़रनेम (डिफ़ॉल्ट) | स्ट्रिंग | इस उपयोगकर्ता का Twitter screen name, handle या alias, जिससे वह अपनी पहचान बताता है। यूज़रनेम अद्वितीय होते हैं, लेकिन समय के साथ बदल सकते हैं। आम तौर पर इनकी अधिकतम लंबाई 15 वर्ण होती है, लेकिन कुछ पुराने खातों में इससे लंबे नाम भी मिल सकते हैं।"username": "TwitterDev" | |
| affiliation | object | इसमें उपयोगकर्ता की संबद्धता का विवरण होता है। | इसका उपयोग उपयोगकर्ता का अफ़िलिएट बैज प्राप्त करने के लिए किया जा सकता है। |
| confirmed_email | string | प्रमाणीकृत उपयोगकर्ता का पुष्टि किया गया ईमेल पता। | |
| connection_status | ऐरे | प्रमाणित उपयोगकर्ता और देखे जा रहे उपयोगकर्ता के बीच संबंधों की एक सूची प्रदान करता है, जैसे फ़ॉलो करना, फ़ॉलो किया जाना, फ़ॉलो अनुरोध भेजा गया, फ़ॉलो अनुरोध प्राप्त हुआ, ब्लॉक करना, म्यूट करना ”connection_status”: [ “follow_request_received”, “follow_request_sent”, “blocking”, “followed_by”, “following”, “muting” ] | प्रमाणीकृत उपयोगकर्ता और जिस उपयोगकर्ता को खोजा जा रहा है, उनके बीच कनेक्शन की स्थिति निर्धारित करने के लिए इसका उपयोग किया जा सकता है। |
| created_at | दिनांक (ISO 8601) | UTC दिनांक-समय, जब उपयोगकर्ता का खाता Twitter पर बनाया गया था।"created_at": "2013-12-14T04:35:55.000Z" | इसका उपयोग यह निर्धारित करने के लिए किया जा सकता है कि कोई व्यक्ति Twitter का उपयोग कितने समय से कर रहा है |
| विवरण | स्ट्रिंग | इस उपयोगकर्ता की प्रोफ़ाइल के विवरण का टेक्स्ट (जिसे bio भी कहा जाता है), अगर उपयोगकर्ता ने इसे दिया हो।"description": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API." | |
| entities | ऑब्जेक्ट | उपयोगकर्ता के विवरण में ऐसे टेक्स्ट का विवरण शामिल है जिसका एक विशेष अर्थ होता है।"entities": { <br/> "url": { <br/> "urls": [ <br/> { <br/> "start": 0, <br/> "end": 23, <br/> "url": "https://t.co/3ZX3TNiZCY", <br/> "expanded_url": "/content/developer-twitter/en/community", <br/> "display_url": "developer.x.com/en/community" <br/> } <br/> ] <br/> }, <br/> "description": { <br/> "urls": [ <br/> { <br/> "start": 0, <br/> "end": 23, <br/> "url": "https://t.co/3ZX3TNiZCY", <br/> "expanded_url": "/content/developer-twitter/en/community", <br/> "display_url": "developer.x.com/en/community" <br/> }, <br/> "hashtags": [ <br/> { <br/> "start": 23, <br/> "end": 30, <br/> "tag": "DevRel" <br/> }, <br/> { <br/> "start": 113, <br/> "end": 130, <br/> "tag": "BlackLivesMatter" <br/> }, <br/> "mentions": [ <br/> { <br/> "start": 0, <br/> "end": 10, <br/> "tag": "TwitterDev" <br/> }, <br/> "cashtags": [ <br/> { <br/> "start": 12, <br/> "end": 16, <br/> "tag": "twtr" <br/> } <br/> ] <br/> } <br/> } | एंटिटीज़ JSON ऑब्जेक्ट होते हैं, जो description से जुड़े hashtags, urls, user mentions, और cashtags के बारे में अतिरिक्त जानकारी देते हैं। अधिक जानकारी के लिए प्रत्येक संबंधित entity का संदर्भ लें। सभी user start indices समावेशी हैं, जबकि सभी user end indices अपवर्जी हैं। |
| is_identity_verified | boolean | यह इंगित करता है कि उपयोगकर्ता की ID सत्यापित है या नहीं। | |
| location | string | यदि उपयोगकर्ता ने अपनी प्रोफ़ाइल में कोई स्थान दिया है, तो वही यहाँ दिखता है। चूँकि यह एक मुक्त-रूप मान है, यह ज़रूरी नहीं कि किसी मान्य स्थान को दर्शाए, लेकिन स्थान क्वेरी के साथ खोज करते समय इसका अनुमानित मिलान के आधार पर मूल्यांकन किया जा सकता है।"location": "127.0.0.1" | |
| most_recent_tweet_id | string | इस उपयोगकर्ता के सबसे हालिया Tweet का अद्वितीय पहचानकर्ता। | उपयोगकर्ता के सबसे हालिया Tweet की पहचान करें। |
| parody | boolean | यह बताता है कि इस उपयोगकर्ता खाते पर Parody लेबल है या नहीं। | |
| pinned_tweet_id | string | इस उपयोगकर्ता के पिन किए गए Tweet की अद्वितीय पहचान।"pinned_tweet_id": "1255542774432063488" | उपयोगकर्ता की प्रोफ़ाइल के शीर्ष पर पिन किए गए Tweet की पहचान करें। संभावित रूप से इसका उपयोग उपयोगकर्ता की भाषा निर्धारित करने के लिए भी किया जा सकता है। |
| profile_banner_url | string | इस उपयोगकर्ता की प्रोफ़ाइल पर दिखने वाले प्रोफ़ाइल बैनर का URL।"profile_banner_url": "https://pbs.twimg.com/profile_banners/1716450569358098432/1721022977" | इस उपयोगकर्ता की प्रोफ़ाइल बैनर छवि डाउनलोड करने के लिए इसका उपयोग किया जा सकता है। |
| profile_image_url | string | इस उपयोगकर्ता की प्रोफ़ाइल छवि का URL, जैसा कि उसकी प्रोफ़ाइल पर दिखाया जाता है।"profile_image_url": "https://pbs.twimg.com/profile_images/1267175364003901441/tBZNFAgA_normal.jpg" | इस उपयोगकर्ता की प्रोफ़ाइल इमेज डाउनलोड करने के लिए इसका उपयोग किया जा सकता है। |
| protected | boolean | यह बताता है कि क्या इस उपयोगकर्ता ने अपने Tweets को सुरक्षित रखा है (अर्थात, क्या इस उपयोगकर्ता के Tweets निजी हैं)।"protected": false | |
| public_metrics | object | इस उपयोगकर्ता की गतिविधि का विवरण शामिल है।"public_metrics": { "followers_count": 507902, "following_count": 1863, "tweet_count": 3561, "listed_count": 1550 } | इसका संभावित रूप से उपयोग किसी Twitter उपयोगकर्ता की पहुँच या प्रभाव का निर्धारण करने, उसकी रुचियों के दायरे का आकलन करने, और Twitter पर उसकी सहभागिता के स्तर को मापने के लिए किया जा सकता है। |
| receives_your_dm | बूलियन | यह दर्शाता है कि यह उपयोगकर्ता प्रमाणीकृत उपयोगकर्ता का DM प्राप्त करेगा या नहीं। | |
| subscription | object | इसमें इस बारे में विवरण शामिल है कि उपयोगकर्ता ने प्रमाणीकृत उपयोगकर्ता की सदस्यता ली है या नहीं। | |
| subscription_type | string | एक स्ट्रिंग, जो प्रमाणीकृत उपयोगकर्ता के पास मौजूद X Premium सदस्यता के type को दर्शाती है। उदाहरण: None, Basic, Premium,PremiumPlus। यदि उपयोगकर्ता प्रमाणीकृत उपयोगकर्ता नहीं है, तो यह हमेशा None लौटाएगा। | |
| url | string | उपयोगकर्ता की प्रोफ़ाइल में दिया गया URL, यदि उपलब्ध हो।"url": "https://t.co/3ZX3TNiZCY" | Twitter उपयोगकर्ता द्वारा अपनी प्रोफ़ाइल में दिया गया URL। यह होमपेज हो सकता है, लेकिन ज़रूरी नहीं कि हमेशा ऐसा ही हो। |
| verified | बूलियन | यह दर्शाता है कि यह उपयोगकर्ता एक सत्यापित Twitter उपयोगकर्ता है या नहीं।"verified": true | यह दर्शाता है कि इस Twitter उपयोगकर्ता का खाता सत्यापित है या नहीं। सत्यापित खाता लोगों को यह समझने में मदद करता है कि सार्वजनिक रुचि वाला खाता प्रामाणिक है। |
| verified_followers_count | स्ट्रिंग | उपयोगकर्ता के सत्यापित फ़ॉलोअर्स की संख्या को दर्शाने वाली एक स्ट्रिंग। | |
| verified_type | string | उपयोगकर्ता के सत्यापन के प्रकार को दर्शाने वाली एक string। उदाहरण: “blue”, “business”, “government” | |
| withheld | object | यदि लागू हो, तो रोकी गई सामग्री से संबंधित विवरण शामिल हैं। |
$BEARER_TOKEN को अपने द्वारा जनरेट किए गए बेयरर टोकन से बदलें।
Space
expansions query parameter में host_ids, creator_id, speaker_ids, mentioned_user_ids में से कम-से-कम एक जोड़कर expansion के लिए उपलब्ध कराया जा सकता है।
Tweets के विपरीत, Spaces अस्थायी होते हैं और उनके समाप्त होने के बाद या उनके creator द्वारा रद्द किए जाने पर उपलब्ध नहीं रहते। जब आपका ऐप Spaces डेटा को हैंडल करता है, तो सबसे अद्यतित जानकारी लौटाना आपकी ज़िम्मेदारी होती है और जो डेटा अब प्लेटफ़ॉर्म पर उपलब्ध नहीं है, उसे हटाना भी ज़रूरी है। Spaces lookup endpoints यह सुनिश्चित करने में आपकी मदद कर सकते हैं कि आप उपयोगकर्ताओं की अपेक्षाओं और मंशा का सम्मान करें।
| Field Value | Type | Description | How it can be used |
|---|---|---|---|
| id (default) | string | अनुरोधित Space का अद्वितीय पहचानकर्ता।"id": "1zqKVXPQhvZJB" | रिस्पॉन्स में लौटाए गए Space की विशिष्ट पहचान करें। |
| state (default) | string | यह बताता है कि Space शुरू हो चुका है, शुरू होगा, या समाप्त हो चुका है।"state": "live" | लाइव या शेड्यूल किए गए Spaces को फ़िल्टर करें। |
| created_at | date (ISO 8601) | इस Space के बनाए जाने का समय।"created_at": "2021-07-04T23:12:08.000Z" | समझें कि Space कब बनाया गया था और समय के अनुसार क्रमबद्ध करें। |
| creator_id | string | Space creator का अद्वितीय पहचानकर्ता।"creator_id": "2244994945" | |
| ended_at | date (ISO 8601) | यदि लागू हो, तो वह समय जब Space समाप्त हुआ।"ended_at": "2021-07-04T00:11:44.000Z" | अवधि जानने के लिए निर्धारित करें कि लाइव Space कब समाप्त हुआ। |
| host_ids | array | Space hosts के अद्वितीय पहचानकर्ता।"host_ids": ["2244994945", "6253282"] | User ऑब्जेक्ट्स expand करें, सहभागिता समझें। |
| lang | string | यदि पता चल सके, तो Space की भाषा।"lang": "en" | Spaces को भाषा के आधार पर वर्गीकृत करें। |
| is_ticketed | boolean | यह बताता है कि क्या यह टिकट वाला Space है।"is_ticketed": false | रुचिकर सामग्री को प्रमुखता दें। |
| invited_user_ids | array | speakers के रूप में आमंत्रित user IDs की सूची।"invited_user_ids": ["2244994945", "6253282"] | User ऑब्जेक्ट्स expand करें, सहभागिता समझें। |
| participant_count | integer | Space में users की संख्या, जिसमें Hosts और Speakers शामिल हैं।"participant_count": 420 | सहभागिता समझें, रिपोर्ट बनाएँ। |
| subscriber_count | integer | उन लोगों की संख्या जिन्होंने Space के लिए रिमाइंडर सेट किया।"subscriber_count": 36 | इवेंट में रुचि समझें। |
| scheduled_start | date (ISO 8601) | Space का निर्धारित शुरू होने का समय।"scheduled_start": "2021-07-14T08:00:00.000Z" | कैलेंडर सूचनाओं के साथ एकीकृत करें। |
| speaker_ids | array | उन users की सूची जिन्होंने किसी भी समय बात की।"speaker_ids": ["2244994945", "6253282"] | User ऑब्जेक्ट्स expand करें, सहभागिता समझें। |
| started_at | date (ISO 8601) | Space का वास्तविक शुरू होने का समय।"started_at": "2021-07-14T08:00:12.000Z" | Space के शुरू होने का समय निर्धारित करें। |
| title | string | Space का शीर्षक।"title": "Say hello to the Space data object!" | कीवर्ड, hashtags, mentions समझें। |
| topic_ids | array | Space creator द्वारा चुने गए topics की IDs।"topic_ids": ["2244994945", "6253282"] | कीवर्ड, hashtags, mentions समझें। |
| updated_at | date (ISO 8601) | Space metadata का सबसे हाल का अपडेट।"updated_at": "2021-07-11T14:44:44.000Z" | जानकारी को अद्यतित रखें। |
$BEARER_TOKEN को अपने जनरेट किए गए बेयरर टोकन से बदलना न भूलें।
सूची
list.fields का उपयोग करें।
सूची ऑब्जेक्ट अन्य डेटा ऑब्जेक्ट्स के child के रूप में नहीं मिलता। हालांकि, user ऑब्जेक्ट्स user resource में मिल सकते हैं और उन्हें expand किया जा सकता है। ये ऑब्जेक्ट्स, expansions query parameter में owner_id जोड़कर expansion के लिए उपलब्ध हो जाते हैं। प्राथमिक सूची ऑब्जेक्ट को पूरा करने के लिए अतिरिक्त फ़ील्ड्स का अनुरोध करते समय, इस expansion का उपयोग list.fields फ़ील्ड्स पैरामीटर के साथ करें, और expansion ऑब्जेक्ट को पूरा करने के लिए user.fields का उपयोग करें।
| Field Value | Type | Description | How it can be used |
|---|---|---|---|
| id (default) | string | इस सूची का अद्वितीय पहचानकर्ता।"id": "2244994945" | किसी विशिष्ट सूची के बारे में प्रोग्राम के माध्यम से जानकारी प्राप्त करने के लिए इसका उपयोग करें। |
| name (default) | string | सूची का नाम, जैसा कि सूची बनाते समय निर्धारित किया गया था।"name": "Twitter Lists" | |
| created_at | date (ISO 8601) | वह UTC datetime जब सूची बनाई गई थी।"created_at": "2013-12-14T04:35:55.000Z" | यह निर्धारित करें कि कोई सूची Twitter पर कब से मौजूद है। |
| description | string | उपयोगकर्ताओं को सूची के बारे में बताने के लिए एक संक्षिप्त विवरण।"description": "People that are active members of the Bay area cycling community on Twitter." | |
| follower_count | integer | यह दिखाता है कि इस सूची को कितने उपयोगकर्ता फ़ॉलो करते हैं।"follower_count": 198 | |
| member_count | integer | यह दिखाता है कि इस सूची में कितने सदस्य हैं।"member_count": 60 | |
| private | boolean | यह बताता है कि सूची निजी है या नहीं।"private": false | |
| owner_id | string | इस सूची के स्वामी का अद्वितीय पहचानकर्ता।"owner_id": "1255542774432063488" | इसका उपयोग यह पता लगाने के लिए किया जा सकता है कि क्या यह उपयोगकर्ता अन्य सूचियों का स्वामी है, और User ऑब्जेक्ट्स को expand करने के लिए भी। |
$BEARER_TOKEN को अपने जनरेट किए गए बेयरर टोकन से बदलें।
मीडिया
?expansions=attachments.media_keys के साथ expansion के लिए उपलब्ध है। ऑब्जेक्ट को पूरा करने के लिए अतिरिक्त फ़ील्ड्स का अनुरोध करते समय फ़ील्ड पैरामीटर media.fields के साथ expansion का उपयोग करें।
| Field value | Type | Description | How it can be used |
|---|---|---|---|
| media_key (default) | string | विस्तारित मीडिया सामग्री का अद्वितीय identifier। "media_key": "13_1263145212760805376" | मीडिया को प्रोग्राम के माध्यम से प्राप्त करने के लिए उपयोग किया जा सकता है |
| type (default) | string | सामग्री का प्रकार (animated_gif, photo, video)। "type": "video" | मीडिया को photo, GIF या video के रूप में वर्गीकृत करें |
| url | string | Twitter पर मीडिया फ़ाइल का सीधा URL। | photos के लिए URL फ़ील्ड के साथ एक Media ऑब्जेक्ट लौटाता है |
| duration_ms | integer | जब type video हो, तब उपलब्ध। वीडियो की अवधि milliseconds में। "duration_ms": 46947 | |
| height | integer | pixels में इस सामग्री की ऊँचाई। "height": 1080 | |
| non_public_metrics | object | अनुरोध के समय मीडिया सामग्री के लिए गैर-सार्वजनिक engagement metrics। user context authentication आवश्यक है। "non_public_metrics": { "playback_0_count": 1561, "playback_100_count": 116, "playback_25_count": 559, "playback_50_count": 305, "playback_75_count": 183,} | वीडियो engagement निर्धारित करें: कितने उपयोगकर्ताओं ने वीडियो के प्रत्येक चौथाई हिस्से तक उसे चलाया। |
| organic_metrics | object | अनुरोध के समय मीडिया सामग्री के लिए engagement metrics, जिन्हें organic context में track किया गया है। user context authentication आवश्यक है। "organic_metrics": { "playback_0_count": 1561, "playback_100_count": 116, "playback_25_count": 559, "playback_50_count": 305, "playback_75_count": 183, "view_count": 629} | organic मीडिया engagement निर्धारित करें। |
| preview_image_url | string | इस सामग्री के स्थिर placeholder preview का URL। "preview_image_url": "https://pbs.twimg.com/media/EYeX7akWsAIP1_1.jpg" | |
| promoted_metrics | object | अनुरोध के समय मीडिया सामग्री के लिए engagement metrics, जिन्हें promoted context में track किया गया है। user context authentication आवश्यक है। "promoted_metrics": { "playback_0_count": 259, "playback_100_count": 15, "playback_25_count": 113, "playback_50_count": 57, "playback_75_count": 25, "view_count": 124} | जब Tweet promoted किया गया हो, तब मीडिया engagement निर्धारित करें। |
| public_metrics | object | अनुरोध के समय मीडिया सामग्री के लिए सार्वजनिक engagement metrics। "public_metrics": { "view_count": 6865141} | Tweet से संलग्न वीडियो के लिए views की कुल संख्या निर्धारित करें। |
| width | integer | pixels में इस सामग्री की चौड़ाई। "width": 1920 | |
| alt_text | string | accessibility को सक्षम बनाने और समर्थन देने के लिए किसी इमेज का विवरण। यह 1000 वर्णों तक लंबा हो सकता है। फिलहाल alt text केवल images में जोड़ा जा सकता है। "alt_text": "Rugged hills along the Na Pali coast on the island of Kauai" | यदि कोई उपयोगकर्ता दृष्टिबाधित हो, तो इमेज का लिखित विवरण प्रदान करने के लिए इसका उपयोग किया जा सकता है। |
| variants | array | प्रत्येक मीडिया ऑब्जेक्ट में अलग-अलग resolutions या formats के साथ कई display या playback variants हो सकते हैं। "variants": [{ "bit_rate": 632000, "content_type": "video/mp4", "url": "https://video.twimg.com/ext_tw_video/1527322141724532740/pu/vid/320x568/lnBaR2hCqE-R_90a.mp4?tag=12"}] |
attachment.media_keys एक्सपैंशन आवश्यक है। $BEARER_TOKEN को अपने स्वयं के जनरेट किए गए बेयरर टोकन से बदलना न भूलें।
पोल
?expansions=attachments.poll_ids के साथ expansion हेतु उपलब्ध है। ऑब्जेक्ट को पूरा करने के लिए अतिरिक्त फ़ील्ड्स का अनुरोध करते समय poll.fields फ़ील्ड्स पैरामीटर के साथ इस expansion का उपयोग करें।
| फ़ील्ड मान | प्रकार | विवरण |
|---|---|---|
| id (default) | string | expanded पोल का अद्वितीय पहचानकर्ता। |
{"id": "1199786642791452673"} | ||
| options (default) | array | संदर्भित पोल में हर विकल्प का वर्णन करने वाले ऑब्जेक्ट्स शामिल हैं। |
{"options": [ { "position": 1, "label": "“C Sharp”", "votes": 795 }, { "position": 2, "label": "“C Hashtag”", "votes": 156 } ]} | ||
| duration_minutes | integer | इस पोल की कुल अवधि बताता है। |
{"duration_minutes": 1440} | ||
| end_datetime | date (ISO 8601) | इस पोल की समाप्ति की तारीख और समय बताता है। |
{"end_datetime": "2019-11-28T20:26:41.000Z"} | ||
| voting_status | string | बताता है कि यह पोल अभी भी सक्रिय है और वोट ले सकता है, या मतदान अब बंद हो चुका है। |
{"voting_status": "closed"} |
attachments.poll_id expansion आवश्यक है। $BEARER_TOKEN को अपने जनरेट किए गए बेयरर टोकन से बदलना न भूलें।
स्थान
?expansions=geo.place_id के साथ expansion के लिए उपलब्ध है। ऑब्जेक्ट को पूरा करने के लिए अतिरिक्त फ़ील्ड्स का अनुरोध करते समय field parameter place.fields के साथ expansion का उपयोग करें।
| फ़ील्ड मान | प्रकार | विवरण | इसका उपयोग कैसे किया जा सकता है |
|---|---|---|---|
| full_name (default) | string | स्थान का अधिक विस्तृत, लंबा नाम। | किसी विशिष्ट स्थान-नाम के आधार पर Tweet को वर्गीकृत करें |
"full_name": "Manhattan, NY" | |||
| id (default) | string | expanded स्थान का विशिष्ट पहचानकर्ता, अगर यह Tweet में टैग किया गया कोई point of interest है। | इसका उपयोग करके किसी स्थान को प्रोग्राम के माध्यम से प्राप्त करें |
"id": "01a9a39529b27f36" | |||
| contained_within | array | उन ज्ञात स्थानों के पहचानकर्ता लौटाता है जिनके भीतर संदर्भित स्थान शामिल है। | |
| country | string | उस देश का पूरा नाम जिससे यह स्थान संबंधित है। | देश के नाम के आधार पर Tweet को वर्गीकृत करें |
"country": "United States" | |||
| country_code | string | उस देश का ISO Alpha-2 country code जिससे यह स्थान संबंधित है। | country code के आधार पर Tweet को वर्गीकृत करें |
"country_code": "US" | |||
| geo | object | इसमें GeoJSON format में स्थान का विवरण शामिल होता है। | |
| `json | |||
| ”geo”: | |||
| “type”: “Feature”, | |||
| “bbox”: [ | |||
| -74.026675, | |||
| 40.683935, | |||
| -73.910408, | |||
| 40.877483 | |||
| ], | |||
| “properties”: | |||
| } | |||
| ` | |||
| name | string | इस स्थान का संक्षिप्त नाम। | किसी विशिष्ट स्थान-नाम के आधार पर Tweet को वर्गीकृत करें |
"name": "Manhattan" | |||
| place_type | string | यह बताता है कि इस स्थान की जानकारी किस विशेष प्रकार की जानकारी दर्शाती है, जैसे शहर का नाम या point of interest. | किसी विशिष्ट प्रकार के स्थान के आधार पर Tweet को वर्गीकृत करें |
"place_type": "city" |
geo.place_id expansion आवश्यक है। $BEARER_TOKEN को अपने जनरेट किए गए बेयरर टोकन से बदलना न भूलें।
Direct Message ईवेंट्स
- sender_id - उस अकाउंट की ID जिसने संदेश भेजा, या जिसने किसी प्रतिभागी को ग्रुप वार्तालाप में आमंत्रित किया
- partricipants_ids - अकाउंट IDs की एक array। ParticipantsJoin और ParticipantsLeave ईवेंट्स के लिए, इस array में उस अकाउंट की एक ही ID होगी जिसने ईवेंट बनाया
- attachments - उस कॉन्टेंट के लिए media IDs देता है जिसे प्रेषक ने Twitter पर अपलोड किया है
- referenced_tweets - अगर text फ़ील्ड में कोई Tweet URL मिलता है, तो उस Tweet की ID रिस्पॉन्स में शामिल की जाती है
| फ़ील्ड मान | Type | विवरण | इसे कैसे उपयोग किया जा सकता है |
| id (default) | string | इवेंट का अद्वितीय पहचानकर्ता। “id”: “1050118621198921728” | इसका उपयोग प्रोग्राम के ज़रिए किसी विशिष्ट वार्तालाप इवेंट को प्राप्त करने के लिए करें (v1.1 endpoints के साथ उपलब्ध)। |
| event_type (default) | string | इवेंट के प्रकार का वर्णन करता है। वर्तमान में तीन प्रकार समर्थित हैं: * MessageCreate * ParticipantsJoin * ParticipantsLeave “event_type”: “MessageCreate” | किसी वार्तालाप का इतिहास प्राप्त करते समय, इससे यह समझा जा सकता है कि संदेश कब बनाए गए थे, और समूह वार्तालापों में प्रतिभागी कब जुड़े और कब बाहर गए। सभी GET methods, event_type= query parameter के साथ विशिष्ट इवेंट प्रकारों पर फ़िल्टरिंग का समर्थन करती हैं। |
| text (default) | string | Direct Message का वास्तविक UTF-8 टेक्स्ट। “text”: “Hello, just you!“ | chatbots के साथ, इसका उपयोग संदेश सामग्री का विश्लेषण करने और स्वचालित रिस्पॉन्स तय करने के लिए किया जा सकता है। इसका उपयोग वार्तालाप खोज सुविधाएँ बनाने के लिए भी किया जा सकता है। |
| entities | object | वे entities जो DM के टेक्स्ट से पार्स की गई हैं। | hashtags, URLs, mentions आदि के बारे में अतिरिक्त जानकारी प्रदान करता है। |
| sender_id | string | इवेंट बनाने वाले User की ID। रिस्पॉन्स में इस object का विस्तार करने के लिए, sender_id को expansion के रूप में शामिल करें और रुचि के User object attributes निर्दिष्ट करने के लिए user.fields query parameter का उपयोग करें। “sender_id”: “906948460078698496” | MessageCreate या ParticipantsJoin इवेंट बनाने वाले User object को प्राप्त करें। |
| participant_ids | array (of strings) | समूह वार्तालाप में शामिल होने और छोड़ने वाले प्रतिभागियों की IDs। नए समूह वार्तालाप बनाते समय भी इसका उपयोग किया जाता है। रिस्पॉन्स में this object का विस्तार करने के लिए, participant_ids को expansion के रूप में शामिल करें और रुचि के User object attributes निर्दिष्ट करने के लिए user.fields query parameter का उपयोग करें। “participant_ids”: [ “906948460078698496” ] | समूह वार्तालापों में शामिल होने और छोड़ने वाले प्रतिभागियों के User objects प्राप्त करने के लिए उपयोग किया जाता है। |
| dm_conversation_id | string | उस वार्तालाप का अद्वितीय पहचानकर्ता, जिसका यह इवेंट हिस्सा है। “dm_conversation_id”: “1584988213961031680” | इसका उपयोग प्रोग्राम के ज़रिए किसी वार्तालाप से इवेंट प्राप्त करने और उसमें Direct Messages जोड़ने के लिए करें। |
| created_at | date (ISO 8601) | Tweet का निर्माण समय (UTC)। “created_at”: “2019-06-04T23:12:08.000Z” | इस फ़ील्ड का उपयोग यह समझने के लिए किया जा सकता है कि Direct Message कब बनाया गया था या वार्तालाप के प्रतिभागी कब जुड़े या कब बाहर गए। |
| referenced_tweets | array | Direct Message टेक्स्ट में उल्लिखित किसी भी Tweet की ID। रिस्पॉन्स में इस object का विस्तार करने के लिए, referenced_tweets.id को expansion के रूप में शामिल करें और रुचि के Tweet object attributes निर्दिष्ट करने के लिए tweet.fields query parameter का उपयोग करें। “referenced_tweets”: [ “id”: “1578868150510456833” ] | जब Direct Messages किसी Tweet का संदर्भ देते हैं, तो इन IDs का उपयोग Tweet का विवरण देखने के लिए किया जा सकता है। |
| attachments | object | संलग्न Media वाले Direct Messages के लिए, अपलोड की गई सामग्री (photo, video, या GIF) की media key प्रदान करता है। रिस्पॉन्स में इस object का विस्तार करने के लिए, attachments.media_keys को expansion के रूप में शामिल करें और रुचि के media object attributes निर्दिष्ट करने के लिए media.fields query parameter का उपयोग करें। वर्तमान में, एक attachment समर्थित है। “attachments”: “media_keys”: [ “3_1136048009270239232” ] | Direct Messages से जुड़े media objects को समझने के लिए। |
- मूलभूत event attributes, जैसे यह कब बनाया गया था और यह किस वार्तालाप का हिस्सा है (dm_conversation)।
- Direct Message भेजने वाले का account ID और description।
- किसी भी referenced Tweet का टेक्स्ट, और वह कब पोस्ट किया गया था।
- किसी भी referenced Tweet author का account ID और description।
?dm_event.fields=id,sender_id,text,created_at,dm_conversation_id&expansions=sender_id,referenced_tweets.id&tweet.fields=created_at,text,author_id&user.fields=description
Community
| Field value | Type | Description | |
|---|---|---|---|
| created_at | date (ISO 8601) | Community के बनाए जाने का समय। | |
| id | string | Community का अद्वितीय पहचानकर्ता। | |
| name | string | Community का नाम। | |
| description | string | अगर दिया गया हो, तो Community के विवरण का टेक्स्ट। | |
| access | string | Community का एक्सेस स्तर। यह इनमें से एक हो सकता है: | |
- Public | |||
- Closed | |||
| join_policy | string | Community की जॉइन नीति। यह इनमें से एक हो सकता है: | |
- Open | |||
- RestrictedJoinRequestsDisabled | |||
- RestrictedJoinRequestsRequireAdminApproval | |||
- RestrictedJoinRequestsRequireModeratorApproval | |||
- SuperFollowRequired | |||
| member_count | integer | Community में शामिल हुए सदस्यों की संख्या। |
$BEARER_TOKEN को अपने जनरेट किए गए बेयरर टोकन से बदलना न भूलें।
फ़ील्ड्स और expansions का उपयोग कैसे करें
fields और expansions क्वेरी पैरामीटर का उपयोग करके अपने रिस्पॉन्स में अतिरिक्त ऑब्जेक्ट और फ़ील्ड्स कैसे प्राप्त करें।
इस गाइड में, हम नीचे दिए गए Tweet स्क्रीनशॉट में दिख रहे कई फ़ील्ड्स का अनुरोध करेंगे।
जैसा कि आप स्क्रीनशॉट में देख सकते हैं, Tweet से जुड़ी जानकारी के कई हिस्से दिखाई दे रहे हैं, जिनमें Tweet लेखक, Tweet मेट्रिक्स, बनाया गया टाइमस्टैम्प, वीडियो और वीडियो व्यू काउंट शामिल हैं। डेटा के कुछ ऐसे हिस्से भी हैं जो स्क्रीनशॉट में दिखाई नहीं देते, लेकिन फिर भी अनुरोध करने के लिए उपलब्ध हैं।
API को रिक्वेस्ट करते समय, डिफ़ॉल्ट रिस्पॉन्स सरल होता है और उसमें केवल डिफ़ॉल्ट Tweet फ़ील्ड्स (id और text) शामिल होते हैं। साथ ही, आपको केवल वही प्राथमिक ऑब्जेक्ट मिलेगा जो आपके द्वारा उपयोग किए जा रहे endpoint से लौटता है, उससे जुड़े अन्य संबद्ध डेटा ऑब्जेक्ट नहीं।
यह सरलता, फ़ील्ड्स और expansions पैरामीटर के साथ मिलकर, आपको अपने उपयोग के मामले के अनुसार केवल उन्हीं फ़ील्ड्स का अनुरोध करने में सक्षम बनाती है जिनकी आपको आवश्यकता है।
अतिरिक्त फ़ील्ड्स और ऑब्जेक्ट्स का अनुरोध करना।
- हमारे ऑब्जेक्ट मॉडल का उपयोग करके या एंडपॉइंट्स के API संदर्भ पृष्ठों में फ़ील्ड्स की सूची देखकर, उन अतिरिक्त फ़ील्ड्स की पहचान करें जिनका आप अनुरोध करना चाहते हैं। इस स्थिति में, हम निम्नलिखित अतिरिक्त फ़ील्ड्स का अनुरोध करेंगे: attachments, author_id, created_at, public_metrics.
-
ऊपर दिए गए फ़ील्ड्स को कॉमा-सेपरेटेड सूची के रूप में मान बनाकर
tweet.fieldsक्वेरी पैरामीटर बनाएँ:?tweet.fields=attachments,author_id,created_at,public_metrics - आपके द्वारा पहले किए गए GET /tweets अनुरोध में query parameter जोड़ें।
curl --request GET --url 'https://api.x.com/2/tweets?ids=1260294888811347969&tweet.fields=attachments,author_id,created_at,public_metrics' \ --header 'Authorization: Bearer $BEARER_TOKEN'
रिस्पॉन्स:
- अब हम Tweet में शामिल वीडियो से जुड़े फ़ील्ड्स का अनुरोध करेंगे। इसके लिए
expansionsपैरामीटर का उपयोग करेंगे औरattachments.media_keysको इसका मान देते हुए इसे अनुरोध में जोड़ेंगे।
- और अंत में, हम वीडियो का व्यू काउंट और अवधि प्राप्त करेंगे। ये डिफ़ॉल्ट फ़ील्ड्स नहीं हैं, इसलिए इन्हें अलग से अनुरोध करना होगा। अपने अनुरोध में
media.fieldsपैरामीटर के साथ कॉमा-सेपरेटेड वैल्यूpublic_metricsऔरduration_msका उपयोग करें।
curl --request GET --url 'https://api.x.com/2/tweets?ids=1260294888811347969&tweet.fields=attachments,author_id,created_at,public_metrics&expansions=attachments.media_keys&media.fields=duration_ms,public_metrics' --header 'Authorization: Bearer $BEARER_TOKEN'
रिस्पॉन्स, जिसमें अब वह सारा डेटा शामिल है जो Tweet के स्क्रीनशॉट में दिखाया गया है:
- ids=1260294888811347969
- tweet.fields=attachments,author_id,created_at,public_metrics
- expansions=attachments.media_keys
- media.fields=public_metrics,duration_ms