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

​
प्रमाणीकरण

​
एंडपॉइंट आवश्यकताएँ

एंडपॉइंटApp-Onlyउपयोगकर्ता संदर्भ
उपयोगकर्ता पोस्ट्स टाइमलाइन✓✓
उपयोगकर्ता मेंशन्स टाइमलाइन✓✓
होम टाइमलाइन—✓ (आवश्यक)

​
निजी मेट्रिक्स

निजी मेट्रिक्स तक पहुँचने के लिए, आपको पोस्ट के लेखक की ओर से प्रमाणित होना होगा:
इन फ़ील्ड्स के लिए User Context प्रमाणीकरण आवश्यक है:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

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

डिफ़ॉल्ट रूप से, रिस्पॉन्स में केवल id, text, और edit_history_tweet_ids शामिल होते हैं। अतिरिक्त डेटा का अनुरोध करें:

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

cURL
curl "https://api.x.com/2/users/123/tweets?\
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"

​
मुख्य फ़ील्ड्स

फ़ील्डविवरण
created_atपोस्ट बनाए जाने का टाइमस्टैम्प
public_metricsएंगेजमेंट की संख्या
conversation_idथ्रेड पहचानकर्ता
context_annotationsविषय वर्गीकरण
entitiesहैशटैग, मेंशन, URL

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

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

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

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

​
उदाहरण

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

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

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

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

​
परिणामों को फ़िल्टर करना

​
समय-आधारित फ़िल्टरिंग

पैरामीटरविवरण
start_timeसबसे पुरानी पोस्ट का टाइमस्टैम्प (ISO 8601)
end_timeसबसे नई पोस्ट का टाइमस्टैम्प (ISO 8601)
since_idइस ID के बाद की पोस्ट्स लौटाएँ
until_idइस ID से पहले की पोस्ट्स लौटाएँ

​
Exclude पैरामीटर

परिणामों से विशिष्ट पोस्ट प्रकारों को हटाएँ:
cURL
curl "https://api.x.com/2/users/123/tweets?exclude=retweets,replies" \
  -H "Authorization: Bearer $BEARER_TOKEN"
मानप्रभाव
retweetsरीट्वीट शामिल न करें
repliesजवाब शामिल न करें

​
वॉल्यूम सीमाएँ

प्रत्येक टाइमलाइन के लिए अधिकतम रिट्रीवल सीमाएँ हैं:
एंडपॉइंटअधिकतम पोस्ट्स
उपयोगकर्ता पोस्ट्स टाइमलाइनसबसे हाल के 3,200
उपयोगकर्ता पोस्ट्स (exclude=replies)सबसे हाल के 800
उपयोगकर्ता मेंशन टाइमलाइनसबसे हाल के 800
होम टाइमलाइन3,200 या 7 दिन
इन सीमाओं से आगे के पोस्ट्स का अनुरोध करने पर बिना डेटा के सफल रिस्पॉन्स मिलता है।

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

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

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

  • 30 मिनट से अधिक पुराने पोस्ट्स उनके अंतिम संस्करण को दर्शाते हैं
  • निकट-वास्तविक-समय वाले उपयोग के मामलों में संभावित संपादनों को ध्यान में रखना चाहिए
  • ज़रूरत पड़ने पर अंतिम स्थिति की पुष्टि करने के लिए Post lookup का उपयोग करें

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

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

​
पोस्ट मेट्रिक्स

​
सार्वजनिक मेट्रिक्स

App-Only या User Context प्रमाणीकरण के साथ सभी पोस्ट्स के लिए उपलब्ध: 
{
  "public_metrics": {
    "retweet_count": 156,
    "reply_count": 23,
    "like_count": 892,
    "quote_count": 12
  }
}

​
निजी मेट्रिक्स

पोस्ट के लेखक से User Context प्रमाणीकरण आवश्यक है:
  • केवल पिछले 30 दिनों की पोस्ट्स के लिए उपलब्ध
  • केवल प्रमाणित उपयोगकर्ता द्वारा लिखी गई पोस्ट्स के लिए ही लौटाया जाता है
  • अन्य उपयोगकर्ताओं की पोस्ट्स के लिए त्रुटि लौटाई जाती है

​
एज केस

30 दिनों से पुराने पोस्ट्स के लिए गैर-सार्वजनिक मेट्रिक्स का अनुरोध करते समय, आपको result_count: 0 के साथ next_token मिल सकता है। इससे बचने के लिए:
  • अनुरोधों को पिछले 30 दिनों के भीतर सीमित रखें
  • max_results कम से कम 10 रखें
जिन पोस्ट्स को प्रमोट नहीं किया गया था, उनके लिए प्रमोटेड मेट्रिक्स का अनुरोध करने पर खाली रिस्पॉन्स मिलता है। यह एक ज्ञात समस्या है।
140 वर्णों से अधिक टेक्स्ट वाले Retweets के लिए, text फ़ील्ड ट्रंकेट हो जाता है। पूरा टेक्स्ट पाने के लिए referenced_tweets.id expansion का उपयोग करें।

​
अगले चरण

होम टाइमलाइन त्वरित शुरुआत

किसी उपयोगकर्ता की होम फ़ीड प्राप्त करें

मेंशन की त्वरित शुरुआत

किसी उपयोगकर्ता के मेंशन प्राप्त करें

API संदर्भ

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

पेजिनेशन

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