मुख्य सामग्री पर जाएं
इस गाइड में उन प्रमुख अवधारणाओं के बारे में बताया गया है जिनकी मदद से आप Search Posts एंडपॉइंट्स को अपने ऐप में एकीकृत कर सकते हैं।

​
प्रमाणीकरण

हालिया खोज कई प्रमाणीकरण विधियों का समर्थन करती है:
विधिउपयोग का परिदृश्य
OAuth 2.0 App-Onlyसार्वजनिक पोस्ट डेटा
OAuth 2.0 Authorization Code with PKCEनिजी मेट्रिक्स
OAuth 1.0a User Contextनिजी मेट्रिक्स
पूर्ण-आर्काइव खोज केवल OAuth 2.0 App-Only प्रमाणीकरण का समर्थन करती है।
निजी मेट्रिक्स (non_public_metrics, organic_metrics, promoted_metrics) पूर्ण-आर्काइव खोज में उपलब्ध नहीं हैं, क्योंकि यह केवल App-Only प्रमाणीकरण का समर्थन करती है।

​
क्वेरी बनाना

क्वेरी, पोस्ट्स का मिलान करने के लिए ऑपरेटरों का उपयोग करती हैं। ऑपरेटरों को बूलियन लॉजिक के साथ संयोजित करें: 
(AI OR "machine learning") lang:en -is:retweet has:links

​
क्वेरी लंबाई की सीमाएँ

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

​
ऑपरेटर के प्रकार

TypeDescriptionExample
स्वतंत्रअकेले इस्तेमाल किया जा सकता है#python, from:user
संयोजन-आवश्यककिसी स्वतंत्र ऑपरेटर के साथ ही इस्तेमाल किया जाना चाहिएhas:media, is:retweet

क्वेरी बनाएं

क्वेरी सिंटैक्स को विस्तार से जानें

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

सभी उपलब्ध ऑपरेटर देखें

​
फ़ील्ड्स और expansions

डिफ़ॉल्ट रूप से, रिस्पॉन्स में केवल id, text, और edit_history_tweet_ids शामिल होते हैं। अतिरिक्त डेटा पाने के लिए पैरामीटर का उपयोग करें।

​
अनुरोध का उदाहरण

cURL
curl "https://api.x.com/2/tweets/search/recent?\
query=python&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id,attachments.media_keys&\
user.fields=username,verified&\
media.fields=url,type" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
उपलब्ध expansions

Expansionक्या लौटाता है
author_idलेखक का उपयोगकर्ता ऑब्जेक्ट
attachments.media_keysसंलग्न मीडिया ऑब्जेक्ट्स
attachments.poll_idsसंलग्न पोल ऑब्जेक्ट्स
referenced_tweets.idकोट किए गए या जवाब दिए गए पोस्ट्स
geo.place_idस्थान ऑब्जेक्ट्स
entities.mentions.usernameउल्लेखित उपयोगकर्ता ऑब्जेक्ट्स

फ़ील्ड्स और expansions गाइड

रिस्पॉन्स को कस्टमाइज़ करने के बारे में और जानें
खोज एंडपॉइंट पेजों में परिणाम लौटाते हैं। अतिरिक्त पेज पाने के लिए रिस्पॉन्स से next_token का उपयोग करें।

​
यह कैसे काम करता है

  1. max_results के साथ अपना शुरुआती अनुरोध करें
  2. next_token के लिए meta ऑब्जेक्ट जाँचें
  3. बाद के अनुरोधों में next_token शामिल करें
  4. इसे तब तक दोहराएँ, जब तक next_token लौटना बंद न हो जाए

​
उदाहरण

cURL
# पहला अनुरोध
curl "https://api.x.com/2/tweets/search/recent?query=python&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

# पेजिनेशन टोकन के साथ अगला अनुरोध
curl "https://api.x.com/2/tweets/search/recent?query=python&max_results=100&next_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $BEARER_TOKEN"

पेजिनेशन गाइड

पेजिनेशन के बारे में और जानें

​
पोस्ट संपादन

पोस्ट्स को 30 मिनट के भीतर अधिकतम 5 बार संपादित किया जा सकता है। खोज एंडपॉइंट्स हमेशा सबसे नया संस्करण लौटाते हैं।

​
ध्यान देने योग्य बातें

  • edit_history_tweet_ids में सभी पोस्ट IDs शामिल हैं (सबसे पुराना पहले)
  • 30 मिनट की विंडो के बाद प्राप्त किए गए पोस्ट्स अंतिम संस्करण को दर्शाते हैं
  • लगभग रीयल-टाइम उपयोग मामलों में, हाल ही में प्रकाशित पोस्ट्स अभी भी संपादित किए जा सकते हैं

पोस्ट संपादन की बुनियादी बातें

पोस्ट संपादन के बारे में और जानें

​
सर्वोत्तम तरीके

शुरू से ही विशिष्ट रहें

नतीजों को सीमित करने और अनावश्यक शोर कम करने के लिए कई ऑपरेटरों का इस्तेमाल करें।

चरणबद्ध तरीके से परीक्षण करें

शुरुआत व्यापक रूप से करें, फिर नतीजों के आधार पर उसे परिष्कृत करें।

पेजिनेशन संभालें

बड़े परिणाम सेट के लिए सही पेजिनेशन लागू करें।

परिणाम कैश करें

बार-बार अनुरोध भेजने से बचने के लिए परिणामों को लोकल रूप से स्टोर करें।

​
अगले चरण

क्वेरी बनाएं

क्वेरी सिंटैक्स में महारत हासिल करें

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

सभी उपलब्ध ऑपरेटर

पेजिनेशन

बड़े परिणाम सेट संभालें

API संदर्भ

एंडपॉइंट का पूरा दस्तावेज़