पूर्ण आर्काइव खोज त्वरित शुरुआत

यह मार्गदर्शिका आपको मार्च 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_time`	ISO 8601	`2020-01-01T00:00:00Z`
`end_time`	ISO 8601	`2020-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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# पेजिनेशन के साथ पूर्ण आर्काइव खोज
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    max_results=100
):
    for post in page.data:
        print(post.text)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// पेजिनेशन के साथ पूर्ण आर्काइव खोज
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

चरण 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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# फ़ील्ड्स और expansions के साथ खोजें
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "description"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// फ़ील्ड्स और expansions के साथ खोजें
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "description"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.created_at}: ${post.text?.slice(0, 50)}...`);
  });
}

चरण 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 Search से मुख्य अंतर

सुविधा	Recent Search	Full-Archive Search
समय-सीमा	पिछले 7 दिन	मार्च 2006 से अब तक
आवश्यक ऐक्सेस	सभी डेवलपर	Pay-per-use, Enterprise
प्रति अनुरोध अधिकतम परिणाम	100	500
क्वेरी की लंबाई	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 संदर्भ

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

अवलोकन

पोस्ट्स

उपयोगकर्ता

डायरेक्ट मैसेज

लाइक्स

सूचियाँ

Spaces

Communities

Community Notes

ट्रेंड्स

समाचार

मीडिया

X गतिविधि

उपयोग

स्ट्रीम कनेक्शन

अनुपालन

Enterprise v2

लाइक्स स्ट्रीम्स

GNIP 2.0

पूर्ण आर्काइव खोज त्वरित शुरुआत

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

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

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

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

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

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

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

Recent Search से मुख्य अंतर

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

अगले चरण

क्वेरी बनाएं

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

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

API संदर्भ