मुख्य सामग्री पर जाएं
यह मार्गदर्शिका आपको मार्च 2006 से अब तक के संपूर्ण X आर्काइव में पोस्ट्स खोजने के लिए अपना पहला पूर्ण आर्काइव खोज अनुरोध करने का तरीका बताती है।
पूर्ण आर्काइव खोज के लिए Self-serve या Enterprise एक्सेस आवश्यक है। इस endpoint का उपयोग करने के लिए अपना एक्सेस अपग्रेड करें
पूर्वापेक्षाएँशुरू करने से पहले, आपके पास ये होने चाहिए:
  • एक डेवलपर खाता
  • आपके ऐप का बेयरर टोकन (डेवलपर कंसोल में “Keys and tokens” के अंतर्गत उपलब्ध)

चरण 1: क्वेरी बनाएं

पूर्ण-संग्रह खोज सभी क्वेरी ऑपरेटरों का समर्थन करती है। क्वेरी उसी तरह बनाएं, जैसे हाल की खोज के लिए बनाते हैं:
from:XDevelopers lang:en
पूर्ण आर्काइव खोज 1,024 वर्णों तक की क्वेरी का समर्थन करता है (Enterprise के लिए 4,096)।

चरण 2: समय सीमा सेट करें

डिफ़ॉल्ट रूप से, परिणाम पिछले 30 दिनों की पोस्ट्स लौटाते हैं। किसी खास अवधि में खोजने के लिए start_time और end_time का उपयोग करें:
पैरामीटरप्रारूपउदाहरण
start_timeISO 86012020-01-01T00:00:00Z
end_timeISO 86012020-12-31T23:59:59Z

चरण 3: अनुरोध भेजें

cURL
curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

चरण 4: रिस्पॉन्स की समीक्षा करें

{
  "data": [
    {
      "id": "1271111223220809728",
      "text": "Tune in tonight and watch as @jessicagarson takes us through...",
      "edit_history_tweet_ids": ["1271111223220809728"]
    },
    {
      "id": "1270799243071062016",
      "text": "As we work towards building the new Twitter API...",
      "edit_history_tweet_ids": ["1270799243071062016"]
    }
  ],
  "meta": {
    "newest_id": "1271111223220809728",
    "oldest_id": "1270799243071062016",
    "result_count": 2
  }
}
संपादन सुविधा शुरू होने से पहले (सितंबर 2022) बनाए गए पोस्ट्स में edit_history_tweet_ids शामिल नहीं होगा।

चरण 5: फ़ील्ड्स और expansions जोड़ें

क्वेरी पैरामीटर का उपयोग करके अतिरिक्त डेटा का अनुरोध करें:
cURL
curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,description&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

चरण 6: परिणामों को पृष्ठों में प्राप्त करें

SDKs पेजिनेशन को अपने-आप संभालते हैं। cURL के लिए, रिस्पॉन्स से next_token का उपयोग करें:
curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
max_results=500&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

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

बड़े परिणाम सेट में नेविगेट करने के बारे में और जानें

सुविधाRecent SearchFull-Archive Search
समय-सीमापिछले 7 दिनमार्च 2006 से अब तक
आवश्यक ऐक्सेससभी डेवलपरPay-per-use, Enterprise
प्रति अनुरोध अधिकतम परिणाम100500
क्वेरी की लंबाई512 वर्ण1,024 वर्ण
रेट लिमिट450 / 15 मिनट300 / 15 मिनट, 1 / सेकंड
प्रमाणीकरणApp-Only, User Contextकेवल App-Only

सामान्य पैरामीटर

पैरामीटरविवरणडिफ़ॉल्ट
queryखोज क्वेरी (आवश्यक)
max_resultsप्रति पृष्ठ पोस्ट्स (10-500)10
start_timeसबसे पुराने पोस्ट का टाइमस्टैम्प30 दिन पहले
end_timeसबसे नए पोस्ट का टाइमस्टैम्पअभी
next_tokenपेजिनेशन टोकन
tweet.fieldsपोस्ट के अतिरिक्त फ़ील्ड्सid, text
expansionsशामिल किए जाने वाले संबंधित ऑब्जेक्ट्स

अगले चरण

क्वेरी बनाएं

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

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

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

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

बड़े रिज़ल्ट सेट संभालें

API संदर्भ

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