मुख्य सामग्री पर जाएं

क्वेरी बनाना

क्वेरी की सीमाएँ! आप कौन-सा access level इस्तेमाल कर रहे हैं, इसके आधार पर आपकी क्वेरी पर सीमाएँ लागू होंगी।  पे-पर-यूज़ ग्राहकों के लिए आपकी क्वेरी 512 वर्णों तक लंबी हो सकती है, जबकि Enterprise ग्राहकों के लिए यह 4,096 वर्णों तक हो सकती है। अगर आपके पास Enterprise एक्सेस है, तो कृपया अपने अकाउंट मैनेजर से संपर्क करें।  ऑपरेटर की उपलब्धता हालाँकि ज़्यादातर ऑपरेटर सभी डेवलपर्स के लिए उपलब्ध हैं, कुछ ऑपरेटर केवल उन लोगों के लिए आरक्षित हैं जिन्हें Enterprise एक्सेस के लिए स्वीकृति मिली है। हम ऑपरेटरों की सूची तालिका में यह दर्शाते हैं कि हर ऑपरेटर किस एक्सेस स्तर पर उपलब्ध है, और इसके लिए नीचे दिए गए लेबल का उपयोग करते हैं:
  • Core operators: किसी भी Project का उपयोग करते समय उपलब्ध।
  • Advanced operators: Enterprise एक्सेस वाले Project का उपयोग करते समय उपलब्ध।   

ऑपरेटर के प्रकार: standalone और conjunction-required

Standalone operators का इस्तेमाल अकेले या किसी भी अन्य ऑपरेटर के साथ किया जा सकता है (उन ऑपरेटरों सहित जिन्हें conjunction की आवश्यकता होती है)। उदाहरण के लिए, नीचे दी गई क्वेरी काम करेगी क्योंकि इसमें #hashtag ऑपरेटर का उपयोग किया गया है, जो standalone है: #xapiv2 Conjunction-required operators का उपयोग किसी क्वेरी में अपने-आप नहीं किया जा सकता; इनका उपयोग केवल तभी किया जा सकता है जब क्वेरी में कम-से-कम एक standalone operator शामिल हो। ऐसा इसलिए है क्योंकि इन ऑपरेटरों का अकेले उपयोग बहुत ज़्यादा सामान्य होगा, और यह पोस्ट्स की अत्यंत बड़ी मात्रा से मेल खाएगा। उदाहरण के लिए, नीचे दी गई क्वेरियाँ समर्थित नहीं हैं क्योंकि इनमें केवल conjunction-required operators शामिल हैं: has:media has:links OR is:retweet अगर हम एक standalone operator जोड़ दें, जैसे वाक्यांश “X data”, तो क्वेरी सही तरीके से काम करेगी।  “X data” has:mentions (has:media OR has:links)

बूलियन ऑपरेटर और समूहबद्धता

यदि आप एक ही क्वेरी में कई ऑपरेटरों को एक साथ जोड़ना चाहते हैं, तो इसके लिए आपके पास निम्नलिखित विकल्प हैं:
AND लॉजिकदो क्रमागत ऑपरेटरों के बीच स्पेस होने पर बूलियन “AND” लॉजिक लागू होता है, यानी पोस्ट्स तभी मेल खाएँगे जब दोनों शर्तें पूरी हों। उदाहरण के लिए, snow day #NoSchool उन पोस्ट्स से मेल खाएगा जिनमें snow और day शब्द तथा #NoSchool हैशटैग शामिल हों।
OR लॉजिकदो क्रमागत ऑपरेटरों के बीच OR होने पर OR लॉजिक लागू होता है, यानी पोस्ट्स तब मेल खाएँगे जब कोई एक शर्त पूरी हो। उदाहरण के लिए, grumpy OR cat OR #meme निर्दिष्ट करने पर वे सभी पोस्ट्स मेल खाएँगे जिनमें grumpy या cat शब्द, या #meme हैशटैग शामिल हो।
NOT लॉजिक, निषेधकिसी कीवर्ड (या किसी भी ऑपरेटर) के आगे डैश (-) लगाकर उसे निषेध (NOT) किया जा सकता है। उदाहरण के लिए, cat #meme -grumpy उन पोस्ट्स से मेल खाएगा जिनमें #meme हैशटैग और cat शब्द हो, लेकिन केवल तब जब उनमें grumpy शब्द न हो। एक सामान्य क्वेरी क्लॉज़ -is:retweet है, जो Retweets से मेल नहीं खाएगा, इसलिए यह केवल मूल पोस्ट्स, Quote Tweets, और replies से मेल खाएगा। सभी ऑपरेटरों का निषेध किया जा सकता है, लेकिन निषेध किए गए ऑपरेटर अकेले उपयोग नहीं किए जा सकते।
समूहबद्धताआप ऑपरेटरों को एक साथ समूहित करने के लिए कोष्ठकों का उपयोग कर सकते हैं। उदाहरण के लिए, (grumpy cat) OR (#meme has:images) या तो उन पोस्ट्स को लौटाएगा जिनमें grumpy और cat शब्द हों, या उन इमेज वाले पोस्ट्स को जिनमें #meme हैशटैग हो। ध्यान दें कि पहले AND लागू होता है, फिर OR।
निषेध के बारे में एक टिप्पणी ऑपरेटर -is:nullcast का हमेशा निषेध किया जाना चाहिए। निषेध किए गए ऑपरेटर अकेले उपयोग नहीं किए जा सकते। कोष्ठकों में एक साथ समूहित किए गए ऑपरेटरों के पूरे सेट का निषेध न करें। इसके बजाय, हर अलग ऑपरेटर का निषेध करें। उदाहरण के लिए, skiing -(snow OR day OR noschool) का उपयोग करने के बजाय, हम सुझाव देते हैं कि आप skiing -snow -day -noschool का उपयोग करें।  ऑपरेशन का क्रम जब AND और OR कार्यक्षमता को एक साथ इस्तेमाल किया जाता है, तो नीचे दिया गया ऑपरेशन क्रम तय करता है कि आपकी क्वेरी का मूल्यांकन कैसे होगा।
  1. AND लॉजिक से जुड़े ऑपरेटर पहले संयोजित किए जाते हैं
  2. उसके बाद, OR लॉजिक से जुड़े ऑपरेटर लागू किए जाते हैं
उदाहरण के लिए:
  • apple OR iphone ipad का मूल्यांकन apple OR (iphone ipad) के रूप में किया जाएगा
  • ipad iphone OR android का मूल्यांकन (iphone ipad) OR android के रूप में किया जाएगा
अनिश्चितता को दूर करने और यह सुनिश्चित करने के लिए कि आपकी क्वेरी का मूल्यांकन आपके इरादे के अनुसार हो, जहाँ उचित हो वहाँ शब्दों को कोष्ठकों में समूहित करें।  उदाहरण के लिए:
  • (apple OR iphone) ipad
  • iphone (ipad OR android)  
विराम-चिह्न, डायक्रिटिक्स, और केस सेंसिटिविटी यदि आप किसी कीवर्ड या हैशटैग क्वेरी में उच्चारण चिह्न या डायक्रिटिक्स वाले वर्ण निर्दिष्ट करते हैं, तो वह उस पोस्ट टेक्स्ट से मेल खाएगी जिसमें वही शब्द उच्चारण चिह्न और डायक्रिटिक्स के साथ हों, साथ ही उन शब्दों से भी जिनमें सामान्य वर्ण हों। उदाहरण के लिए, Diacrítica कीवर्ड या #cumpleaños हैशटैग वाली क्वेरी Diacrítica या #cumpleaños से मेल खाएगी, साथ ही Diacritica या #cumpleanos से भी, जिनमें tilde í या eñe न हो। उच्चारण चिह्न या डायक्रिटिक्स वाले वर्णों को सामान्य वर्णों के समान माना जाता है और उन्हें शब्द-सीमा नहीं माना जाता। उदाहरण के लिए, cumpleaños कीवर्ड वाली क्वेरी केवल उन गतिविधियों से मेल खाएगी जिनमें cumpleaños शब्द शामिल हो, और उन गतिविधियों से मेल नहीं खाएगी जिनमें cumpleacumplean, या os शामिल हों। सभी ऑपरेटरों का मूल्यांकन case-insensitive तरीके से किया जाता है। उदाहरण के लिए, cat क्वेरी निम्नलिखित सभी वाले पोस्ट्स से मेल खाएगी: catCATCat फ़िल्टर की गई स्ट्रीम का मिलान व्यवहार पोस्ट काउंट्स से अलग तरह से काम करता है। जब आप फ़िल्टर की गई स्ट्रीम के लिए नियम बना रहे हों, तो ध्यान रखें कि उच्चारण चिह्न और डायक्रिटिक्स वाले कीवर्ड और हैशटैग केवल उन्हीं शब्दों से मेल खाएँगे जिनमें वही उच्चारण चिह्न और डायक्रिटिक्स भी हों, और उन शब्दों से मेल नहीं खाएँगे जो इसके बजाय सामान्य वर्णों का उपयोग करते हैं।  उदाहरण के लिए, ऐसे फ़िल्टर की गई स्ट्रीम rules जिनमें Diacrítica कीवर्ड या #cumpleaños हैशटैग शामिल हो, वे केवल Diacrítica और #cumpleaños शब्दों से मेल खाएँगे, और Diacritica या #cumpleanos से मेल नहीं खाएँगे, जिनमें tilde í या eñe न हो विशिष्टता और दक्षता जब आप अपनी क्वेरी बनाना शुरू करते हैं, तो कुछ बातों को ध्यान में रखना महत्वपूर्ण है।
  • अपनी क्वेरी के लिए बहुत व्यापक, अकेले इस्तेमाल होने वाले ऑपरेटर—जैसे कोई एक कीवर्ड या #hashtag—का उपयोग करना आम तौर पर अनुशंसित नहीं है, क्योंकि इससे संभवतः बहुत बड़ी संख्या में पोस्ट्स मैच होंगी। अधिक सशक्त क्वेरी बनाने से मैच होने वाली पोस्ट्स का अधिक विशिष्ट सेट मिलेगा, और उम्मीद है कि इससे आपके पोस्ट काउंट्स की सटीकता बढ़ेगी, जिससे आपको अधिक मूल्यवान जानकारी मिल सकेगी। 
    • उदाहरण के लिए, यदि आपकी क्वेरी सिर्फ happy कीवर्ड हो, तो आपको संभवतः प्रति दिन 200,000 - 300,000 पोस्ट्स मिल सकती हैं।
    • अधिक शर्तीय ऑपरेटर जोड़ने से आपके परिणाम सीमित होते हैं, उदाहरण के लिए (happy OR happiness) place_country:GB -birthday -is:retweet
  • प्रभावी क्वेरी लिखना, क्वेरी की लंबाई पर लागू वर्ण-सीमा के भीतर बने रहने के लिए भी फायदेमंद है। वर्ण गणना में स्पेस और ऑपरेटर सहित पूरी क्वेरी स्ट्रिंग शामिल होती है।
    • उदाहरण के लिए, नीचे दी गई क्वेरी 59 वर्ण लंबी है: (happy OR happiness) place_country:GB -birthday -is:retweet
Quote Tweet मिलान व्यवहार पोस्ट काउंट्स endpoints का उपयोग करते समय, ऑपरेटर उस मूल पोस्ट की सामग्री पर मैच नहीं करेंगे जिसे Quote किया गया था, लेकिन Quote Tweet में शामिल सामग्री पर मैच करेंगे। हालाँकि, कृपया ध्यान दें कि फ़िल्टर की गई स्ट्रीम Quote की गई मूल पोस्ट की सामग्री और Quote Tweet की सामग्री, दोनों पर मैच करेगा।   क्रमिक रूप से क्वेरी बनाना अपनी क्वेरी का जल्दी और बार-बार परीक्षण करें पहली बार में “सही” परिणाम लौटाने वाली क्वेरी मिलना दुर्लभ है। X पर बहुत कुछ ऐसा है जो शुरुआत में स्पष्ट भी हो सकता है और नहीं भी, और ऊपर बताए गए क्वेरी सिंटैक्स को अपनी इच्छित क्वेरी के अनुरूप बनाना कठिन हो सकता है। जब आप क्वेरी बना रहे हों, तो यह ज़रूरी है कि आप समय-समय पर Search Post endpoints में से किसी एक का उपयोग करके उसका परीक्षण करें, ताकि यह सुनिश्चित हो सके कि आपकी क्वेरी से मैच होने वाली पोस्ट्स आपके उपयोग के मामले के लिए प्रासंगिक हैं। इस अनुभाग में, हम नीचे दी गई क्वेरी से शुरुआत करेंगे और अपने परीक्षण के दौरान मिले परिणामों के आधार पर उसमें बदलाव करेंगे:  happy OR happiness क्वेरी को सीमित करने के लिए परिणामों का उपयोग करें जब आप Search Posts के साथ क्वेरी का परीक्षण करते हैं, तो आपको लौटाई गई पोस्ट्स को देखकर यह जाँचना चाहिए कि क्या उनमें वह डेटा शामिल है जिसकी आप अपेक्षा कर रहे हैं और जिसे आप पाना चाहते हैं। व्यापक क्वेरी और पोस्ट मैचों के बड़े सेट से शुरुआत करने पर आप परिणामों की समीक्षा कर सकते हैं और अवांछित परिणामों को हटाने के लिए क्वेरी को सीमित कर सकते हैं।   जब हमने उदाहरण क्वेरी का परीक्षण किया, तो हमने देखा कि हमें कई अलग-अलग भाषाओं में पोस्ट्स मिल रही थीं। इस स्थिति में, हम केवल अंग्रेज़ी में पोस्ट्स प्राप्त करना चाहते हैं, इसलिए हम lang: ऑपरेटर जोड़ेंगे: (happy OR happiness) lang:en परीक्षण में लोगों को happy birthday की शुभकामनाएँ देने वाली कई पोस्ट्स मिलीं, इसलिए हम नकारात्मक कीवर्ड ऑपरेटर के रूप में -birthday जोड़ेंगे। हम केवल मूल पोस्ट्स ही प्राप्त करना चाहते हैं, इसलिए हमने नकारात्मक -is:retweet ऑपरेटर भी जोड़ा है: (happy OR happiness) lang:en -birthday -is:retweet जहाँ आवश्यक हो, समावेशन के लिए समायोजन करें यदि आप देखते हैं कि Search Posts के माध्यम से आपको वह डेटा नहीं मिल रहा है जिसकी आप अपेक्षा करते हैं, और आप जानते हैं कि ऐसी मौजूदा पोस्ट्स हैं जो वापस आनी चाहिए, तो हो सकता है आपको अपनी क्वेरी को व्यापक बनाने के लिए ऐसे ऑपरेटर हटाने पड़ें जो इच्छित डेटा को फ़िल्टर कर रहे हों।  हमारे उदाहरण में, हमने देखा कि हमारी निजी timeline में कुछ अन्य पोस्ट्स भी थीं जो उस भावना को व्यक्त कर रही थीं जिसकी हम तलाश कर रहे हैं, लेकिन वे परीक्षण परिणामों में शामिल नहीं थीं। बेहतर कवरेज सुनिश्चित करने के लिए, हम excited और elated कीवर्ड जोड़ेंगे। (happy OR happiness OR excited OR elated) lang:en -birthday -is:retweet समयावधि के दौरान लोकप्रिय ट्रेंड्स/उछाल के अनुसार समायोजन करें ट्रेंड्स X पर तेज़ी से आते-जाते हैं। अपनी क्वेरी को बनाए रखना एक सक्रिय प्रक्रिया होनी चाहिए। यदि आप किसी क्वेरी का कुछ समय तक उपयोग करने की योजना बना रहे हैं, तो हम सुझाव देते हैं कि आप समय-समय पर प्राप्त हो रहे डेटा की जाँच करें, ताकि पता चल सके कि किसी समायोजन की आवश्यकता है या नहीं। हमारे उदाहरण में, हमने देखा कि हमें कुछ ऐसी पोस्ट्स मिलने लगीं जो लोगों को “happy holidays” कह रही हैं। चूँकि हम नहीं चाहते कि ये पोस्ट्स हमारे परिणामों में शामिल हों, इसलिए हम नकारात्मक -holidays कीवर्ड जोड़ेंगे। (happy OR happiness OR excited OR elated) lang:en -birthday -is:retweet -holidays  एक बार जब आप अपनी क्वेरी का ठीक से परीक्षण कर लें और उसमें कई बार सुधार कर लें, तो आप इसे पोस्ट काउंट्स endpoints के साथ भेजना शुरू कर सकते हैं, ताकि पूर्ण Post payloads के बजाय केवल पोस्ट्स की संख्या प्राप्त हो।

अपने अनुरोध में क्वेरी जोड़ना

अपने अनुरोध में क्वेरी जोड़ने के लिए, आपको query पैरामीटर का उपयोग करना होगा। अन्य क्वेरी पैरामीटर की तरह, आपको यह सुनिश्चित करना होगा कि आपकी बनाई गई क्वेरी HTTP-encoded हो। cURL कमांड का उपयोग करके यह कैसा दिख सकता है, इसका एक उदाहरण यहाँ दिया गया है। यदि आप इस कमांड का उपयोग करना चाहते हैं, तो कृपया $BEARER_TOKEN को अपने बेयरर टोकन से बदल दें:
      curl https://api.x.com/2/tweets/counts/recent?query=cat%20has%3Amedia%20-grumpy&tweet.fields=created_at&max_results=100 -H "Authorization: Bearer $BEARER_TOKEN"

क्वेरी उदाहरण

किसी प्राकृतिक आपदा को ट्रैक करना नीचे दी गई क्वेरी 2017 में ह्यूस्टन से आए Hurricane Harvey पर चर्चा करने वाली मौसम एजेंसियों और गेजों के मूल पोस्ट्स से मेल खाती थी। HTTP एन्कोडिंग के बिना क्वेरी इस प्रकार दिखेगी: has:geo (from:NWSNHC OR from:NHC_Atlantic OR from:NWSHouston OR from:NWSSanAntonio OR from:USGS_TexasRain OR from:USGS_TexasFlood OR from:JeffLindner1) -is:retweet और HTTP एन्कोडिंग, query पैरामीटर, और recent पोस्ट काउंट्स URI के साथ क्वेरी इस प्रकार दिखेगी: https://api.x.com/2/tweets/counts/recent?query=-is%3Aretweet%20has%3Ageo%20(from%3ANWSNHC%20OR%20from%3ANHC_Atlantic%20OR%20from%3ANWSHouston%20OR%20from%3ANWSSanAntonio%20OR%20from%3AUSGS_TexasRain%20OR%20from%3AUSGS_TexasFlood%20OR%20from%3AJeffLindner1) किसी बातचीत की भावना का विश्लेषण करना अगला नियम हैशटैग, #nowplaying, के आसपास विकसित हो रही बातचीत की भावना को बेहतर ढंग से समझने के लिए इस्तेमाल किया जा सकता है, लेकिन इसका दायरा केवल North America में प्रकाशित पोस्ट्स तक सीमित है। HTTP एन्कोडिंग के बिना, सकारात्मक और नकारात्मक के लिए दो अलग-अलग क्वेरियाँ इस प्रकार दिखेंगी: #nowplaying (happy OR exciting OR excited OR favorite OR fav OR amazing OR lovely OR incredible) (place_country:US OR place_country:MX OR place_country:CA) -horrible -worst -sucks -bad -disappointing #nowplaying (horrible OR worst OR sucks OR bad OR disappointing) (place_country:US OR place_country:MX OR place_country:CA) -happy -exciting -excited -favorite -fav -amazing -lovely -incredible और HTTP एन्कोडिंग, query पैरामीटर, और recent पोस्ट काउंट्स URI के साथ क्वेरी इस प्रकार दिखेगी: https://api.x.com/2/tweets/counts/recent?query=%23nowplaying%20(happy%20OR%20exciting%20OR%20excited%20OR%20favorite%20OR%20fav%20OR%20amazing%20OR%20lovely%20OR%20incredible)%20(place_country%3AUS%20OR%20place_country%3AMX%20OR%20place_country%3ACA)%20-horrible%20-worst%20-sucks%20-bad%20-disappointing https://api.x.com/2/tweets/counts/recent?query=%23nowplaying%20(horrible%20OR%20worst%20OR%20sucks%20OR%20bad%20OR%20disappointing)%20(place_country%3AUS%20OR%20place_country%3AMX%20OR%20place_country%3ACA)%20-happy%20-exciting%20-excited%20-favorite%20-fav%20-amazing%20-lovely%20-incredible ऐसे पोस्ट्स खोजें जो किसी विशिष्ट Post annotation से संबंधित हों यह नियम उन मूल पोस्ट्स को फ़िल्टर करने के लिए बनाया गया था जिनमें किसी ऐसे पालतू जानवर की छवि शामिल हो जो बिल्ली न हो, और जिनमें पोस्ट की पहचानी गई भाषा जापानी हो। ऐसा करने के लिए, हमने context: operator का उपयोग किया ताकि Post annotation की सुविधा का लाभ उठाया जा सके। हमने पहले Post lookup endpoint और tweet.fields=context_annotations फ़ील्ड्स पैरामीटर का उपयोग करके यह पहचाना कि अपनी क्वेरी में हमें कौन-सी domain.entity IDs इस्तेमाल करनी हैं:
  • बिल्लियों से संबंधित पोस्ट्स domain 66 (Interests and Hobbies category) और entity 852262932607926273 (Cats) लौटाते हैं। 
  • पालतू जानवरों से संबंधित पोस्ट्स domain 65 (Interests and Hobbies Vertical) और entity 852262932607926273 (Pets) लौटाते हैं। 
HTTP एन्कोडिंग के बिना क्वेरी इस प्रकार दिखेगी: context:65.852262932607926273 -context:66.852262932607926273 -is:retweet has:images lang:ja और HTTP एन्कोडिंग, query पैरामीटर, और recent पोस्ट काउंट्स URI के साथ क्वेरी इस प्रकार दिखेगी: https://api.x.com/2/tweets/counts/recent?query=context%3A65.852262932607926273%20-context%3A66.852262932607926273%20-is%3Aretweet%20has%3Aimages%20lang%3Aja

ऑपरेटर

ऑपरेटरtypeउपलब्धताविवरण
keywordस्टैंडअलोनकोरपोस्ट के मुख्य भाग में किसी कीवर्ड से मेल खाता है। यह टोकनाइज़्ड मिलान है, अर्थात आपकी कीवर्ड स्ट्रिंग का मिलान पोस्ट के मुख्य भाग के टोकनाइज़्ड टेक्स्ट से किया जाएगा। टोकनाइज़ेशन विराम चिह्नों, प्रतीकों और Unicode basic plane separator characters के आधार पर शब्दों को विभाजित करता है। उदाहरण के लिए, “I like coca-cola” टेक्स्ट वाली एक पोस्ट को निम्नलिखित टोकनों में विभाजित किया जाएगा: I, like, coca, cola। फिर इन टोकनों की तुलना आपकी क्वेरी में इस्तेमाल की गई कीवर्ड स्ट्रिंग से की जाएगी। जिन स्ट्रिंग्स में विराम चिह्न (उदाहरण के लिए coca-cola), प्रतीक या separator characters हों, उनसे मेल कराने के लिए आपको अपने कीवर्ड को डबल कोट्स में रखना होगा। उदाहरण: pepsi OR cola OR "coca cola"
emojiस्टैंडअलोनकोरपोस्ट के मुख्य भाग में किसी emoji से मेल खाता है। keyword की तरह, emojis भी tokenized match होते हैं, यानी आपका emoji पोस्ट के मुख्य भाग के tokenized text से मिलाया जाएगा। ध्यान दें कि अगर किसी emoji का कोई variant है, तो उसे query में जोड़ने के लिए आपको double quotes में रखना होगा। उदाहरण: (😃 OR 😡) 😬
"exact phrase match"स्टैंडअलोनकोरपोस्ट के मुख्य भाग में मौजूद सटीक वाक्यांश से मेल खाता है। उदाहरण: ("X API" OR #v2) -"recent counts"
#स्टैंडअलोनकोरऐसे किसी भी पोस्ट से मेल खाता है जिसमें कोई मान्य हैशटैग शामिल हो, यदि उस हैशटैग को पोस्ट में एक मान्य इकाई के रूप में पहचाना गया हो। यह ऑपरेटर सटीक मिलान करता है, टोकनाइज़्ड मिलान नहीं; अर्थात, नियम #thanku ठीक #thanku हैशटैग वाले पोस्ट्स से मेल खाएगा, लेकिन #thankunext हैशटैग वाले पोस्ट्स से नहीं। उदाहरण: #thankunext #fanart OR @arianagrande
@स्टैंडअलोनकोरकिसी भी ऐसे पोस्ट से मेल खाता है जिसमें दिया गया उपयोगकर्ता नाम मेंशन किया गया हो, बशर्ते वह उपयोगकर्ता नाम एक मान्य इकाई के रूप में पहचाना गया हो (@ वर्ण सहित)। उदाहरण: (@XDevelopers OR @API) -@X
$स्टैंडअलोनएडवांस्डकिसी भी ऐसे पोस्ट से मेल खाता है जिसमें निर्दिष्ट ‘cashtag’ शामिल हो (जहाँ टोकन का पहला वर्ण ‘’ होता है)। ध्यान दें कि cashtag ऑपरेटर, cashtag से मिलान करने के लिए X's ‘symbols’ एंटिटी एक्सट्रैक्शन पर निर्भर करता है, बजाय इसके कि वह पोस्ट के मुख्य भाग से cashtag निकालने का प्रयास करे। उदाहरण: `twtr OR @XDevelopers -$fb`
from:स्टैंडअलोनCoreकिसी विशिष्ट उपयोगकर्ता की किसी भी पोस्ट से मेल खाता है। मान username (जिसमें @ वर्ण शामिल नहीं होता) या उपयोगकर्ता की संख्यात्मक user ID, दोनों में से कोई एक हो सकता है। आप प्रत्येक from: ऑपरेटर के लिए केवल एक username/ID पास कर सकते हैं। उदाहरण: from:XDevelopers OR from:API -from:X
to:स्टैंडअलोनCoreकिसी विशेष उपयोगकर्ता को दिए गए जवाब में मौजूद किसी भी पोस्ट से मेल खाता है। मान username (जिसमें @ वर्ण शामिल न हो) या उपयोगकर्ता की संख्यात्मक user ID में से कोई एक हो सकता है। आप प्रत्येक to: operator के लिए केवल एक username/ID पास कर सकते हैं। उदाहरण: to:XDevelopers OR to:API -to:X
url:स्टैंडअलोनCoreकिसी पोस्ट के किसी भी सही प्रारूप वाले URL पर टोकनाइज़्ड मिलान करता है। यह ऑपरेटर url और expanded_url दोनों फ़ील्ड्स की सामग्री पर मिलान कर सकता है। उदाहरण के लिए, “You should check out X Developer Labs: https://t.co/c0A36SWil4” वाली एक पोस्ट (जिसमें छोटा URL https://developer.x.com पर रीडायरेक्ट होता है) नीचे दिए गए दोनों नियमों से मेल खाएगी: from:XDevelopers url:"https://developer.x.com" और from:XDevelopers url:"https://t.co"। विराम चिह्नों या विशेष वर्णों वाले टोकन और वाक्यांशों को डबल कोट्स में रखा जाना चाहिए।
retweets_of:स्टैंडअलोनकोरउन पोस्ट्स से मेल खाता है जो निर्दिष्ट उपयोगकर्ता के Retweets हैं। मान या तो उपयोगकर्ता नाम (@ वर्ण को छोड़कर) हो सकता है या उपयोगकर्ता की संख्यात्मक ID। आप प्रत्येक retweets_of: operator के लिए केवल एक उपयोगकर्ता नाम/ID पास कर सकते हैं। उदाहरण: retweets_of:XDevelopers OR retweets_of:API
context:स्टैंडअलोनकोरविशिष्ट domain id/entity id जोड़ी से मेल खाने वाले पोस्ट्स। आप प्रत्येक context: ऑपरेटर में केवल एक domain/entity ही दे सकते हैं। उदाहरण: context:domain_id.entity_id। आप OR ऑपरेटर का उपयोग करके कई domain/entities को संयोजित कर सकते हैं: (context:47.113922 9372198469633 OR context:11.1088514520308342784)
entity:स्टैंडअलोनकोरकिसी विशिष्ट एंटिटी स्ट्रिंग वैल्यू वाले पोस्ट्स से मेल खाता है। आप केवल एक entity: ऑपरेटर पास कर सकते हैं। उदाहरण: entity:"string declaration of entity/place"। कृपया ध्यान दें कि यह केवल हाल की खोज के साथ उपलब्ध है।
conversation_id:स्टैंडअलोनकोरउन पोस्ट्स से मेल खाता है जो एक ही conversation ID साझा करती हैं। किसी conversation की शुरुआत करने वाली पोस्ट की Post ID को conversation ID के रूप में सेट किया जाता है। जब किसी पोस्ट पर जवाब पोस्ट किए जाते हैं, यहाँ तक कि जवाबों के जवाब भी, तो conversation_id उसके JSON payload में जोड़ दिया जाता है। आप प्रत्येक conversation_id: operator में केवल एक conversation ID पास कर सकते हैं। उदाहरण: conversation_id:1334987486343299072 (from:XDevelopers OR from:API)
list:स्टैंडअलोनएडवांस्डनिर्दिष्ट सूची के सदस्य उपयोगकर्ताओं द्वारा प्रकाशित पोस्ट्स से मेल खाता है। उदाहरण के लिए, यदि @XDevelopers और @API, सूची 123 के सदस्य हों और आपने अपनी क्वेरी में list:123 शामिल किया हो, तो आपके रिस्पॉन्स में केवल उन खातों द्वारा प्रकाशित पोस्ट्स ही शामिल होंगी। आप List lookup endpoint का उपयोग करके सूची id ढूंढ सकते हैं। उदाहरण: list:123
place:स्टैंडअलोनएडवांस्डनिर्दिष्ट स्थान या X place ID से टैग की गई पोस्ट्स से मेल खाता है। कई शब्दों वाले स्थान-नामों (“New York City”, “Palo Alto”) को उद्धरण चिह्नों में रखा जाना चाहिए। आप प्रत्येक place: ऑपरेटर के लिए केवल एक स्थान पास कर सकते हैं। ध्यान दें: X place IDs प्राप्त करने का तरीका जानने के लिए GET geo/search standard v1.1 endpoint देखें। उदाहरण: place:"new york city" OR place:seattle OR place:fd70c22040963ac7
place_country:स्टैंडअलोनउन्नतउन पोस्ट्स से मेल खाता है जिनमें टैग किए गए स्थान/लोकेशन से संबद्ध देश कोड, दिए गए ISO alpha-2 कैरेक्टर कोड से मेल खाता है। आप Wikipedia पर मान्य ISO कोड्स की सूची देख सकते हैं। आप प्रत्येक place_country: ऑपरेटर के लिए केवल एक ISO कोड दे सकते हैं। उदाहरण: place_country:US OR place_country:MX OR place_country:CA
point_radius:स्टैंडअलोनएडवांस्डजब place.geo.coordinates ऑब्जेक्ट पोस्ट में मौजूद होता है, तो उससे मिलान करता है, और X में, किसी स्थान के geo polygon से मिलान करता है, जहाँ Place polygon पूरी तरह से परिभाषित क्षेत्र के भीतर शामिल होता है। point_radius:[longitude latitude radius]. radius के लिए समर्थित इकाइयाँ miles (mi) और kilometers (km) हैं। Radius 25mi से कम होना चाहिए। Longitude की सीमा ±180 है। Latitude की सीमा ±90 है। सभी coordinates दशमलव डिग्री में होते हैं। नियम के arguments brackets के भीतर होते हैं और space से अलग किए जाते हैं। उदाहरण: point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]
bounding_box:स्टैंडअलोनएडवांस्डजब मौजूद हो, तो यह पोस्ट के place.geo.coordinates ऑब्जेक्ट से मेल खाता है, और X में किसी place geo polygon से, जहाँ place polygon पूरी तरह परिभाषित क्षेत्र के भीतर हो। bounding_box:[west_long south_lat east_long north_lat]. bounding box की चौड़ाई और ऊँचाई 25mi से कम होनी चाहिए। देशांतर ±180 की सीमा में होना चाहिए। अक्षांश ±90 की सीमा में होना चाहिए। सभी निर्देशांक दशमलव डिग्री में होते हैं। नियम आर्ग्युमेंट brackets के भीतर होते हैं और space से अलग किए जाते हैं। उदाहरण: bounding_box:[-105.301758 39.964069 -105.178505 40.09455]
is:retweetकंजंक्शन आवश्यककोरनिर्दिष्ट नियम के बाकी हिस्से से मेल खाने वाले Retweets का मिलान करता है। यह ऑपरेटर केवल वास्तविक Retweets को ही देखता है (उदाहरण के लिए, वे जो Retweet बटन का उपयोग करके जनरेट किए गए हों)। Quote Tweets का इस ऑपरेटर से मिलान नहीं होगा। उदाहरण: data @XDevelopers -is:retweet
is:replyसंयोजन आवश्यककोरकिसी नियम से मेल खाने वाले केवल स्पष्ट जवाब ही डिलीवर करें। डिलीवरी से किसी क्वेरी से मेल खाने वाले जवाबों को बाहर रखने के लिए इसे नकारा भी जा सकता है। ध्यान दें: यह ऑपरेटर filtered stream endpoint के साथ भी उपलब्ध है। filtered stream के साथ उपयोग करने पर, यह ऑपरेटर किसी मूल पोस्ट के जवाबों, quoted पोस्ट्स में दिए गए जवाबों और Retweets में दिए गए जवाबों से मेल खाता है। उदाहरण: from:XDevelopers is:reply
is:quoteसंयोजन आवश्यककोरटिप्पणी वाले पोस्ट्स के रूप में भी जाने जाने वाले सभी Quote Tweets लौटाता है। उदाहरण: "sentiment analysis" is:quote
is:verifiedसंयोजन आवश्यककोरकेवल वही पोस्ट्स दें जिनके लेखक X द्वारा सत्यापित हों। उदाहरण: #nowplaying is:verified
-is :nullcastसंयोजन आवश्यकउन्नतads.x.com पर केवल प्रचार के लिए बनाए गए उन पोस्ट्स को हटाता है जिनका "source":"Twitter for Advertisers (legacy)" या "source":"Twitter for Advertisers" होता है। इस ऑपरेटर का उपयोग नकारात्मक रूप में किया जाना चाहिए। Nullcasted Posts के बारे में अधिक जानकारी के लिए, पोस्ट की उपलब्धता वाला हमारा पेज देखें। उदाहरण: "mobile games" -is:nullcast
has:hashtagsअन्य ऑपरेटर के साथ आवश्यककोरकम से कम एक हैशटैग वाले पोस्ट्स से मेल खाता है। उदाहरण: from:XDevelopers -has:hashtags
has:cashtagsअन्य ऑपरेटर के साथ आवश्यकउन्नतउन पोस्ट्स से मेल खाता है जिनमें कैशटैग प्रतीक होता है (यानी जिसकी शुरुआत ‘’वर्णसेहोतीहै।उदाहरणकेलिए,’ वर्ण से होती है। उदाहरण के लिए, `tag)। उदाहरण: #stonks has:cashtags`
has:linksअन्य ऑपरेटर के साथ आवश्यकCoreयह ऑपरेटर उन पोस्ट्स से मेल खाता है जिनकी पोस्ट बॉडी में लिंक और मीडिया होते हैं। उदाहरण: from:XDevelopers announcement has:links
has:mentionsसंयोजन आवश्यकCoreउन पोस्ट्स से मेल खाता है जिनमें किसी अन्य X उपयोगकर्ता का उल्लेख किया गया हो। उदाहरण: #nowplaying has:mentions
has:mediaसंयोजन आवश्यकCoreX के अनुसार, उन पोस्ट्स से मेल खाता है जिनमें फ़ोटो, GIF, या वीडियो जैसी कोई मीडिया ऑब्जेक्ट शामिल हो। यह Periscope से बनाए गए मीडिया या अन्य मीडिया होस्टिंग साइटों के लिंक वाले पोस्ट्स से मेल नहीं खाएगा। उदाहरण: (kittens OR puppies) has:media
has:imagesसंयोजन आवश्यककोरउन पोस्ट्स से मेल खाता है जिनमें किसी छवि का पहचाना गया URL शामिल होता है। उदाहरण: #meme has:images
has:videosसंयोजन आवश्यककोरउन पोस्ट्स से मेल खाता है जिनमें X पर सीधे अपलोड किए गए नेटिव X वीडियो शामिल हों। यह Periscope से बनाए गए वीडियो या अन्य वीडियो होस्टिंग साइटों के लिंक वाले पोस्ट्स से मेल नहीं खाएगा। उदाहरण: #icebucketchallenge has:videos
has:geoसंयोजन आवश्यकउन्नतउन पोस्ट्स से मेल खाता है जिनमें X उपयोगकर्ता द्वारा प्रदान किया गया पोस्ट-विशिष्ट भौगोलिक स्थान डेटा होता है। यह या तो X place के रूप में कोई स्थान हो सकता है, जिसमें संबंधित डिस्प्ले नाम, geo polygon और अन्य फ़ील्ड्स शामिल होते हैं, या दुर्लभ मामलों में geo lat-long coordinate हो सकता है। नोट: place (Post geo) पर मेल खाने वाले ऑपरेटर्स में केवल मूल पोस्ट्स के मैच शामिल होंगे। रीट्वीट्स में कोई place डेटा नहीं होता। उदाहरण: recommend #paris has:geo -bakery
lang:संयोजन आवश्यकCoreउन पोस्ट्स से मेल खाता है जिन्हें X ने किसी विशेष भाषा का माना है (यदि, और केवल यदि, उस पोस्ट का भाषा-वर्गीकरण किया गया हो)। यह ध्यान रखना महत्वपूर्ण है कि वर्तमान में प्रत्येक पोस्ट को केवल एक ही भाषा में वर्गीकृत किया जाता है, इसलिए कई भाषाओं को AND के साथ जोड़ने पर कोई परिणाम नहीं मिलेगा। आप प्रत्येक lang: ऑपरेटर के लिए केवल एक BCP 47 भाषा पहचानकर्ता ही दे सकते हैं। नोट: यदि किसी भाषा का वर्गीकरण नहीं किया जा सकता, तो परिणाम ‘und’ होगा (undefined के लिए)। उदाहरण: recommend #paris lang:en
अम्हारिक: amजर्मन: deमलयालम: mlस्लोवाक: sk
अरबी: arग्रीक: elमालदीवी: dvस्लोवेनियाई: sl
आर्मेनियाई: hyगुजराती: guमराठी: mrसोरानी कुर्दी: ckb
बास्क: euहैतियन क्रियोल: htनेपाली: neस्पेनिश: es
बंगाली: bnहिब्रू: iwनॉर्वेजियन: noस्वीडिश: sv
बोस्नियाई: bsहिंदी: hiओड़िया: orतागालोग: tl
बुल्गारियाई: bgलैटिन लिपि में हिंदी: hi-Latnपंजाबी: paतमिल: ta
बर्मी: myहंगेरियाई: huपश्तो: psतेलुगु: te
क्रोएशियाई: hrआइसलैंडिक: isफ़ारसी: faथाई: th
कैटलन: caइंडोनेशियाई: inपोलिश: plतिब्बती: bo
चेक: csइतालवी: itपुर्तगाली: ptपारंपरिक चीनी: zh-TW
डेनिश: daजापानी: jaरोमानियाई: roतुर्की: tr
डच: nlकन्नड़: knरूसी: ruयूक्रेनी: uk
अंग्रेज़ी: enखमेर: kmसर्बियाई: srउर्दू: ur
एस्टोनियाई: etकोरियाई: koसरलीकृत चीनी: zh-CNउइग़ुर: ug
फ़िनिश: fiलाओ: loसिंधी: sdवियतनामी: vi
फ़्रेंच: frलातवियाई: lvसिंहला: siवेल्श: cy
जॉर्जियाई: kaलिथुआनियाई: lt