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

इस गाइड में उन प्रमुख अवधारणाओं के बारे में बताया गया है जिनकी मदद से आप 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 वर्ण

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

Type	Description	Example
स्वतंत्र	अकेले इस्तेमाल किया जा सकता है	`#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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# हाल की पोस्ट्स खोजें
for page in client.posts.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"],
    max_results=100
):
    for post in page.data:
        print(f"{post.text} - Likes: {post.public_metrics.like_count}")

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

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

// हाल की पोस्ट्स खोजें
const paginator = client.posts.searchRecent("python", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id", "attachments.media_keys"],
  userFields: ["username", "verified"],
  mediaFields: ["url", "type"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.text} - Likes: ${post.public_metrics?.like_count}`);
  });
}

उपलब्ध expansions

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

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

रिस्पॉन्स को कस्टमाइज़ करने के बारे में और जानें

पेजिनेशन

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

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

max_results के साथ अपना शुरुआती अनुरोध करें
next_token के लिए meta ऑब्जेक्ट जाँचें
बाद के अनुरोधों में next_token शामिल करें
इसे तब तक दोहराएँ, जब तक 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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# SDK पेजिनेशन को अपने-आप संभालता है
all_posts = []

for page in client.posts.search_recent(query="python", max_results=100):
    if page.data:
        all_posts.extend(page.data)

print(f"{len(all_posts)} पोस्ट्स मिले")

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

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

async function getAllResults(query) {
  const allPosts = [];

  // SDK पेजिनेशन को अपने-आप संभालता है
  const paginator = client.posts.searchRecent(query, { maxResults: 100 });

  for await (const page of paginator) {
    if (page.data) {
      allPosts.push(...page.data);
    }
  }

  return allPosts;
}

// उपयोग
const posts = await getAllResults("python");
console.log(`${posts.length} पोस्ट्स मिले`);

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

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

पोस्ट संपादन

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले चरण

क्वेरी बनाएं

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

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

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

पेजिनेशन

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

API संदर्भ

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

​प्रमाणीकरण

​हालिया खोज

​पूर्ण-आर्काइव खोज

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

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

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

क्वेरी बनाएं

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

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

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

​उपलब्ध expansions

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

​पेजिनेशन

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

​उदाहरण

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

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

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

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

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

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

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

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

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

​अगले चरण

क्वेरी बनाएं

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

पेजिनेशन

API संदर्भ

प्रमाणीकरण

हालिया खोज

पूर्ण-आर्काइव खोज

क्वेरी बनाना

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

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

फ़ील्ड्स और expansions

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

उपलब्ध expansions

पेजिनेशन

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

उदाहरण

पोस्ट संपादन

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

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

अगले चरण