क्वेरी बनाएं

खोज एंडपॉइंट्स GET अनुरोध के साथ एक क्वेरी स्वीकार करते हैं और उससे मेल खाने वाली ऐतिहासिक पोस्ट्स का एक सेट लौटाते हैं। क्वेरी ऐसे ऑपरेटरों से मिलकर बनती है, जो पोस्ट के विभिन्न गुणों पर मिलान करते हैं।

क्वेरी सीमाएँ

आप किस एक्सेस स्तर का उपयोग कर रहे हैं, इसके आधार पर आपकी क्वेरियों पर निम्न सीमाएँ लागू होंगी:

एक्सेस स्तर	हालिया खोज	पूर्ण-आर्काइव खोज
सेल्फ-सर्व	512 वर्ण	1,024 वर्ण
Enterprise	4,096 वर्ण	4,096 वर्ण

ऑपरेटर की उपलब्धता

हालाँकि अधिकांश ऑपरेटर किसी भी डेवलपर के लिए उपलब्ध हैं, कुछ केवल खास एक्सेस स्तरों के लिए आरक्षित हैं:

कोर ऑपरेटर: किसी भी Project का उपयोग करते समय उपलब्ध
उन्नत ऑपरेटर: कुछ खास एक्सेस स्तरों वाले Project का उपयोग करते समय उपलब्ध

उपलब्धता की पूरी जानकारी के लिए ऑपरेटरों की पूरी सूची देखें।

ऑपरेटर के प्रकार: स्वतंत्र और संयोजन-आवश्यक

स्वतंत्र ऑपरेटरों का उपयोग अकेले या किसी भी अन्य ऑपरेटर के साथ किया जा सकता है (उन ऑपरेटरों सहित जिनके लिए संयोजन आवश्यक होता है)। उदाहरण के लिए, यह क्वेरी काम करती है क्योंकि #hashtag एक स्वतंत्र ऑपरेटर है:

#xapiv2

संयोजन-आवश्यक ऑपरेटरों का किसी क्वेरी में अकेले उपयोग नहीं किया जा सकता; इनका उपयोग तभी किया जा सकता है, जब उसमें कम से कम एक स्वतंत्र ऑपरेटर शामिल हो। ऐसा इसलिए है क्योंकि केवल इन ऑपरेटरों का उपयोग करने पर बहुत बड़ी संख्या में पोस्ट्स मैच हो जाएँगे। उदाहरण के लिए, नीचे दी गई क्वेरियाँ समर्थित नहीं हैं, क्योंकि उनमें केवल संयोजन-आवश्यक ऑपरेटर शामिल हैं:

has:media

has:links OR is:retweet

यदि हम "X data" वाक्यांश जैसे किसी स्वतंत्र ऑपरेटर को जोड़ते हैं, तो क्वेरी सही तरीके से काम करती है:

"X data" has:mentions (has:media OR has:links)

बूलियन ऑपरेटर और ग्रुपिंग

इन टूल्स का उपयोग करके कई ऑपरेटरों को एक साथ जोड़ें:

Operator	Description	Example
AND (space)	पोस्ट्स को दोनों शर्तों से मेल खाना चाहिए	`snow day #NoSchool` उन पोस्ट्स से मेल खाता है जिनमें “snow” AND “day” AND #NoSchool हो
OR	पोस्ट्स को किसी एक शर्त से मेल खाना चाहिए	`grumpy OR cat OR #meme` उन पोस्ट्स से मेल खाता है जिनमें “grumpy” OR “cat” OR #meme हो
NOT (dash)	इस शर्त से मेल खाने वाले पोस्ट्स को बाहर रखें	`cat #meme -grumpy` उन पोस्ट्स से मेल खाता है जिनमें “cat” और #meme हो, लेकिन “grumpy” न हो
Grouping (parentheses)	ऑपरेटरों को एक साथ समूहित करें	`(grumpy cat) OR (#meme has:images)` किसी एक समूह से मेल खाता है

नेगेशन के बारे में एक नोट

ऑपरेटर -is:nullcast का उपयोग हमेशा नकारात्मक रूप में ही किया जाना चाहिए
नकारात्मक ऑपरेटरों का अकेले उपयोग नहीं किया जा सकता
समूहित ऑपरेटरों को नकारें नहीं। skiing -(snow OR day OR noschool) के बजाय skiing -snow -day -noschool का उपयोग करें

संचालन का क्रम

AND और OR को साथ में इस्तेमाल करते समय:

AND लॉजिक से जुड़े ऑपरेटर पहले जोड़े जाते हैं
इसके बाद, OR लॉजिक से जुड़े ऑपरेटर लागू किए जाते हैं

उदाहरण:

Query	इस रूप में मूल्यांकित किया जाता है
`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 Diacrítica और Diacritica दोनों से मेल खाता है। केस सेंसिटिविटी: सभी ऑपरेटर बड़े और छोटे अक्षरों के प्रति असंवेदनशील हैं। क्वेरी cat cat, CAT, और Cat से मेल खाती है।

फ़िल्टर्ड स्ट्रीम अलग तरह से काम करता हैजब फ़िल्टर्ड स्ट्रीम नियम बनाए जाते हैं, तो एक्सेंट वाले कीवर्ड केवल उन्हीं पोस्ट्स से मेल खाते हैं जिनमें वही एक्सेंट भी शामिल हो। उदाहरण के लिए, Diacrítica केवल Diacrítica से मेल खाता है, Diacritica से नहीं।

Quote Tweet मिलान

Search Posts का उपयोग करते समय, ऑपरेटर Quote Tweet की सामग्री से मेल खाते हैं, लेकिन उद्धृत की गई मूल पोस्ट की सामग्री से नहीं।

फ़िल्टर्ड स्ट्रीम का व्यवहार अलग है—यह Quote Tweet और मूल पोस्ट, दोनों की सामग्री से मेल खाता है।

विशिष्टता और दक्षता

किसी एक कीवर्ड या हैशटैग जैसे व्यापक ऑपरेटरों का उपयोग करने की अनुशंसा नहीं की जाती—ये बहुत बड़ी संख्या में पोस्ट्स से मेल खाएँगे और आपकी उपयोग सीमाएँ जल्दी खत्म कर देंगे।

प्रभावी क्वेरी बनाने के सुझाव:

शुरुआत में विशिष्ट रहें, फिर दायरा बढ़ाएँ — ऐसी लक्षित क्वेरियाँ बनाएँ जो प्रासंगिक परिणाम लौटाएँ
एकाधिक ऑपरेटरों का उपयोग करें — परिणामों को सीमित करने के लिए ऑपरेटरों को मिलाकर इस्तेमाल करें
अपने वर्णों की संख्या पर नज़र रखें — पूरी क्वेरी स्ट्रिंग सीमा में गिनी जाती है

उदाहरण के तौर पर प्रगति:

# बहुत व्यापक - प्रति दिन 200,000+ पोस्ट्स
happy

# बेहतर - भाषा फ़िल्टर और बहिष्करण जोड़ता है
(happy OR happiness) lang:en -birthday -is:retweet

# और भी बेहतर - 59 अक्षर, अधिक विशिष्ट
(happy OR happiness) place_country:GB -birthday -is:retweet

चरण-दर-चरण क्वेरी बनाना

चरण 1: एक बुनियादी क्वेरी से शुरू करें

happy OR happiness

चरण 2: परिणामों के आधार पर जाँचें और दायरा सीमित करें

हमें कई भाषाओं में पोस्ट्स मिलीं। भाषा फ़िल्टर जोड़ें:

(happy OR happiness) lang:en

हमें जन्मदिन की शुभकामनाओं वाले पोस्ट मिल रहे हैं। उन्हें और Retweets को बाहर रखें:

(happy OR happiness) lang:en -birthday -is:retweet

चरण 3: बेहतर कवरेज के लिए दायरा बढ़ाएँ

हम और अधिक भावना कैप्चर करना चाहते हैं। संबंधित कीवर्ड जोड़ें:

(happy OR happiness OR excited OR elated) lang:en -birthday -is:retweet

चरण 4: रुझानों के अनुसार समायोजित करें

हॉलिडे पोस्ट्स दिखाई दे रही हैं। इन्हें शामिल न करें:

(happy OR happiness OR excited OR elated) lang:en -birthday -is:retweet -holidays

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

query पैरामीटर का उपयोग करें और अपनी क्वेरी को HTTP-एन्कोड करें:

curl "https://api.x.com/2/tweets/search/recent?\
query=cat%20has%3Amedia%20-grumpy&\
tweet.fields=created_at&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

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

किसी प्राकृतिक आपदा को ट्रैक करना

हरिकेन हार्वी के बारे में मौसम एजेंसियों की पोस्ट्स का मिलान करें: क्वेरी:

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

पूर्ण अनुरोध URL:

https://api.x.com/2/tweets/search/recent?query=has%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)%20-is%3Aretweet

#nowplaying के लिए भावना विश्लेषण

सकारात्मक भावना:

#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

पोस्ट एनोटेशन का उपयोग

context: ऑपरेटर का उपयोग करके छवियों सहित पालतू जानवरों (बिल्लियाँ नहीं) के बारे में जापानी पोस्ट्स खोजें: सबसे पहले, domain.entity IDs की पहचान करने के लिए tweet.fields=context_annotations के साथ पोस्ट लुकअप का उपयोग करें:

बिल्लियाँ: domain 66, entity 852262932607926273
पालतू जानवर: domain 65, entity 852262932607926273

क्वेरी:

context:65.852262932607926273 -context:66.852262932607926273 -is:retweet has:images lang:ja

टूल्स

क्वेरी बिल्डर टूल

अपनी क्वेरी इंटरैक्टिव तरीके से बनाएँ और टेस्ट करें

अगले चरण

ऑपरेटर संदर्भ

उपलब्ध ऑपरेटरों की पूरी सूची

खोज की त्वरित शुरुआत

अपना पहला खोज अनुरोध करें

इंटीग्रेशन गाइड

पूर्ण इंटीग्रेशन दस्तावेज़