अवलोकन

X API के Search पोस्ट्स एंडपॉइंट्स की तुलना

v2 Search Tweets endpoint अंततः standard v1.1 search/posts endpoint और enterprise Search API की जगह ले लेगा। यदि आपके पास ऐसा कोड, ऐप्स या टूल हैं जो X search endpoint के किसी पुराने संस्करण का उपयोग करते हैं और आप नए X API v2 एंडपॉइंट्स पर माइग्रेट करने पर विचार कर रहे हैं, तो यह मार्गदर्शिका आपके लिए है।

---

हाल की खोज की तुलना

निम्न तालिका हाल की खोज के विभिन्न प्रकार के एंडपॉइंट्स की तुलना करती है:

विवरण	Standard v1.1	X API v2
होस्ट डोमेन	https://api.x.com	https://api.x.com
एंडपॉइंट पाथ	/1.1/search/tweets.json	/2/tweets/search/recent
प्रमाणीकरण	OAuth 1.0a User Context OAuth 2.0 ऐप-Only	OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE OAuth 2.0 ऐप-Only
टाइमस्टैम्प फ़ॉर्मैट	YYYYMMDD	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
इससे अधिक पुराने नहीं होने वाले पोस्ट्स लौटाता है	7 दिन	7 दिन
समर्थित HTTP मेथड	GET	GET
डिफ़ॉल्ट अनुरोध रेट लिमिट्स	OAuth 1.0a User Context के साथ प्रति 15 मिनट 180 अनुरोध OAuth 2.0 ऐप-Only के साथ प्रति 15 मिनट 450 अनुरोध	Self-serve: OAuth 2.0 ऐप-Only के साथ प्रति 15 मिनट 60 अनुरोध OAuth 1.0a User Context के साथ प्रति 15 मिनट 60 अनुरोध OAuth 2.0 Authorization Code with PKCE के साथ प्रति 15 मिनट 60 अनुरोध
पूरी तरह अनवाइंड किए गए URLs उपलब्ध कराता है		✔
प्रति रिस्पॉन्स अधिकतम पोस्ट्स (डिफ़ॉल्ट)	100 (15)	100 (10)
पोस्ट JSON फ़ॉर्मैट	Standard v1.1 format	X API v2 format (यह fields और expansions अनुरोध पैरामीटर्स से निर्धारित होता है, और v1.1 formats के साथ backward-compatible नहीं है) Standard v1.1 format से X API v2 format में माइग्रेट करने के बारे में अधिक जानने के लिए, कृपया हमारी data formats migration guide देखें।
payload में कौन-से फ़ील्ड्स लौटाए जाएँ, यह चुनने का समर्थन करता है		✔
annotations का अनुरोध करने और उन्हें प्राप्त करने का समर्थन करता है		✔
पोस्ट ऑब्जेक्ट के भीतर विशिष्ट metrics का अनुरोध करने का समर्थन करता है		✔
conversation_id ऑपरेटर और फ़ील्ड का समर्थन करता है		✔
पोस्ट संपादन इतिहास उपलब्ध कराता है	✔	✔
पोस्ट data array के लिए JSON key name	statuses	data
pagination के लिए JSON key name	search_metadata.next_results	meta.next_token
समय-सीमा के आधार पर आर्काइव में नेविगेट करने का समर्थन करता है	✔	✔
समय-आधारित अनुरोधों की समय रेज़ोल्यूशन	day	second
टाइमज़ोन	UTC	UTC
समय के आधार पर नेविगेट करने के लिए अनुरोध पैरामीटर्स	until	start_time end_time
पोस्ट ID के आधार पर नेविगेट करने के लिए अनुरोध पैरामीटर्स	since_id max_id	since_id until_id
pagination के लिए अनुरोध पैरामीटर	URL-encoded query उपलब्ध कराता है	next_token
Project से संबद्ध developer ऐप के credentials का उपयोग आवश्यक है		✔

फुल-आर्काइव सर्च तुलना

निम्न तालिका फुल-आर्काइव सर्च एंडपॉइंट्स के विभिन्न प्रकारों की तुलना करती है:

विवरण	Enterprise	X API v2
होस्ट डोमेन	https://gnip-api.x.com	https://api.x.com
एंडपॉइंट पाथ	/search/fullarchive/accounts/:account_name/:label	/2/tweets/search/all
प्रमाणीकरण	Basic auth	OAuth 2.0 App-Only
टाइमस्टैम्प फ़ॉर्मैट	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
ऐसे पोस्ट्स लौटाता है जो इससे पुराने न हों	मार्च 2006 से पूरा आर्काइव	मार्च 2006 से पूरा आर्काइव
समर्थित HTTP मेथड्स	GET POST	GET
डिफ़ॉल्ट अनुरोध रेट लिमिट्स	प्रति मिनट रेट लिमिट आपके अनुबंध में निर्दिष्ट अनुसार पार्टनर के हिसाब से अलग-अलग होगी। Basic auth के साथ प्रति सेकंड 20 अनुरोध	OAuth 2.0 App-Only के साथ प्रति 15 मिनट 300 अनुरोध OAuth 2.0 App-Only के साथ प्रति सेकंड 1 अनुरोध
पूरी तरह अनवाइंड किए गए URLs उपलब्ध कराता है	✔	✔
प्रति रिस्पॉन्स पोस्ट्स	अधिकतम: 500 डिफ़ॉल्ट: 100	अधिकतम: 500 डिफ़ॉल्ट: 10
पोस्ट JSON फ़ॉर्मैट	Native Enriched or Activity Streams फ़ॉर्मैट	X API v2 फ़ॉर्मैट (fields और expansions अनुरोध पैरामीटर्स द्वारा निर्धारित)
payload में कौन-से फ़ील्ड्स लौटाए जाएँ, इसे चुनने का समर्थन करता है		✔
annotations का अनुरोध करने और उन्हें प्राप्त करने का समर्थन करता है		✔
पोस्ट ऑब्जेक्ट के भीतर विशिष्ट metrics का अनुरोध करने का समर्थन करता है		✔
conversation_id ऑपरेटर और फ़ील्ड का समर्थन करता है		✔
पोस्ट संपादन इतिहास उपलब्ध कराता है	✔	✔
पोस्ट data array के लिए JSON key name	results	data
pagination के लिए JSON key name	next	meta.next_token
समय-आधारित अनुरोधों की समय-रिज़ॉल्यूशन	second	second
टाइमज़ोन	UTC	UTC
पोस्ट ID के आधार पर आर्काइव में नेविगेट करने का समर्थन करता है		✔
समय के आधार पर नेविगेशन के लिए अनुरोध पैरामीटर्स	fromDate toDate	start_time end_time
पोस्ट ID के आधार पर नेविगेट करने के लिए अनुरोध पैरामीटर्स		since_id until_id
pagination के लिए अनुरोध पैरामीटर	next_token	next_token
Academic Research एक्सेस वाले Project से जुड़े developer ऐप के credentials का उपयोग आवश्यक है		✔

फ़िल्टरिंग ऑपरेटर तुलना

सर्च पोस्ट्स के चार अलग-अलग संस्करणों (standard, enterprise, और v2) में उपलब्ध ऑपरेटर अलग-अलग हैं। साथ ही, प्रत्येक संस्करण के भीतर भी ऑपरेटर उपलब्धता के स्तर भिन्न हैं, जिनकी व्याख्या नीचे दी गई है।

Enterprise

• enterprise ऑपरेटरों के कोई उप-स्तर नहीं हैं

X API v2

• Self-serve: किसी भी Project का उपयोग करने पर उपलब्ध
• Enterprise: किसी Project का उपयोग करने पर उपलब्ध

आप इन सभी ऑपरेटर सेट्स के बारे में उनकी संबंधित गाइड्स में अधिक जान सकते हैं:

• Enterprise operators
• X API v2 operators

अब जब हम X API v2 के भीतर अलग-अलग ऑपरेटर स्तरों को समझ चुके हैं, तो यहाँ वह तालिका है जो सर्च पोस्ट्स के लिए ऑपरेटर उपलब्धता दिखाती है (ध्यान दें कि यदि कोई सेल खाली छोड़ा गया है, तो वह ऑपरेटर उपलब्ध नहीं है):

खोज ऑपरेटर	Standard	Enterprise	v2
keyword	उपलब्ध q:keyword	उपलब्ध	उपलब्ध
emoji	उपलब्ध q:😄	उपलब्ध	उपलब्ध
”exact phrase”	उपलब्ध	उपलब्ध	उपलब्ध
#	उपलब्ध	उपलब्ध	उपलब्ध
$	उपलब्ध	उपलब्ध	उपलब्ध
@	उपलब्ध	उपलब्ध	उपलब्ध
from:	उपलब्ध	उपलब्ध	उपलब्ध
to:	उपलब्ध	उपलब्ध	उपलब्ध
url:	उपलब्ध	उपलब्ध	उपलब्ध
retweets_of:		उपलब्ध	उपलब्ध
context:			उपलब्ध
entity:			सेल्फ-सर्व - केवल recent search में उपलब्ध
conversation_id:			उपलब्ध
place:		उपलब्ध	उपलब्ध
place_country:		उपलब्ध	उपलब्ध
point_radius:	geocode पैरामीटर	उपलब्ध	उपलब्ध
bounding_box:		उपलब्ध	उपलब्ध
is:retweet	filter:retweets	उपलब्ध	उपलब्ध
is:reply		उपलब्ध	उपलब्ध
is:quote		उपलब्ध	उपलब्ध
is:verified		उपलब्ध	उपलब्ध
-is:nullcast		उपलब्ध	उपलब्ध
has:hashtags		उपलब्ध	उपलब्ध
has:cashtags		उपलब्ध	उपलब्ध
has:links	filter:links	उपलब्ध	उपलब्ध
has:mentions		उपलब्ध	उपलब्ध
has:media	filter:media	उपलब्ध	उपलब्ध
has:images	filter:images, filter:twimg	उपलब्ध	उपलब्ध
has:videos	filter:videos filter:native_video	उपलब्ध	उपलब्ध
has:geo		उपलब्ध	उपलब्ध
lang:	lang - इसे ऑपरेटर या पैरामीटर, दोनों रूपों में इस्तेमाल किया जा सकता है	उपलब्ध	उपलब्ध
has:profile_geo		उपलब्ध
profile_country		उपलब्ध
profile_locality		उपलब्ध
profile_region		उपलब्ध
proximity		उपलब्ध
:(	उपलब्ध
:)	उपलब्ध
?	उपलब्ध
filter:periscope	उपलब्ध
list:	उपलब्ध		उपलब्ध
filter:replies	उपलब्ध
filter:pro_video	उपलब्ध
filter:social	उपलब्ध
filter:trusted	उपलब्ध
filter:follows	उपलब्ध
filter:has_engagement	उपलब्ध
include:antisocial	उपलब्ध
include:offensive_user	उपलब्ध
include:antisocial_offensive_user	उपलब्ध
include:sensitive_content	उपलब्ध
source:	उपलब्ध
min_replies:	उपलब्ध
min_retweets:	उपलब्ध
min_faves:	उपलब्ध
card_name:	उपलब्ध
card_domain:	उपलब्ध

अन्य माइग्रेशन संसाधन

X API migration hub

इन एंडपॉइंट्स के लिए कुछ sample code देखें

पोस्ट्स खोज: Standard v1.1 से X API v2

पोस्ट्स खोज: Enterprise से X API v2