फ़ील्ड्स

API रिस्पॉन्स में विशिष्ट डेटा फ़ील्ड्स का अनुरोध करें

X API v2 डिफ़ॉल्ट रूप से न्यूनतम डेटा लौटाता है। प्रत्येक ऑब्जेक्ट type के लिए अतिरिक्त डेटा का अनुरोध करने हेतु फ़ील्ड्स पैरामीटर का उपयोग करें।

---

​

फ़ील्ड्स कैसे काम करते हैं

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

# डिफ़ॉल्ट रिस्पॉन्स - न्यूनतम फ़ील्ड्स
curl "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: Bearer $TOKEN"

# अतिरिक्त फ़ील्ड्स के साथ
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=created_at,public_metrics,author_id" \
  -H "Authorization: Bearer $TOKEN"

---

​

उपलब्ध फ़ील्ड पैरामीटर

प्रत्येक ऑब्जेक्ट type के लिए अलग फ़ील्ड्स पैरामीटर होता है:

ऑब्जेक्ट	पैरामीटर	दस्तावेज़
पोस्ट (Tweet)	tweet.fields	पोस्ट फ़ील्ड्स
उपयोगकर्ता	user.fields	User फ़ील्ड्स
Media	media.fields	Media फ़ील्ड्स
Poll	poll.fields	Poll फ़ील्ड्स
Place	place.fields	Place फ़ील्ड्स

---

​

उदाहरण: पोस्ट फ़ील्ड्स

tweet.fields का उपयोग करके विशिष्ट पोस्ट फ़ील्ड्स का अनुरोध करें:

curl "https://api.x.com/2/tweets/1234567890?tweet.fields=created_at,public_metrics,lang" \
  -H "Authorization: Bearer $TOKEN"

रिस्पॉन्स:

{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "edit_history_tweet_ids": ["1234567890"],
    "created_at": "2024-01-15T12:00:00.000Z",
    "lang": "en",
    "public_metrics": {
      "retweet_count": 10,
      "reply_count": 5,
      "like_count": 100,
      "quote_count": 2
    }
  }
}

---

​

उदाहरण: उपयोगकर्ता फ़ील्ड्स

user.fields के साथ उपयोगकर्ता के लिए विशिष्ट फ़ील्ड्स का अनुरोध करें:

curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
  -H "Authorization: Bearer $TOKEN"

रिस्पॉन्स:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X Developer Platform",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

---

​

संबंधित ऑब्जेक्ट्स के लिए फ़ील्ड्स

संबंधित ऑब्जेक्ट्स (जैसे किसी पोस्ट के लेखक) के फ़ील्ड्स पाने के लिए, आपको दो चीज़ें चाहिए:

1. संबंधित ऑब्जेक्ट को शामिल करने के लिए एक expansion
2. उस ऑब्जेक्ट type के लिए फ़ील्ड्स पैरामीटर

# लेखक विवरण सहित पोस्ट प्राप्त करें
curl "https://api.x.com/2/tweets/1234567890?expansions=author_id&user.fields=description,public_metrics" \
  -H "Authorization: Bearer $TOKEN"

रिस्पॉन्स:

{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "author_id": "2244994945"
  },
  "includes": {
    "users": [{
      "id": "2244994945",
      "name": "X Developers",
      "username": "xdevelopers",
      "description": "The voice of the X Developer Platform",
      "public_metrics": {
        "followers_count": 570842,
        "following_count": 2048
      }
    }]
  }
}

expansions के बारे में अधिक जानें →

---

​

सामान्य फ़ील्ड संयोजन

पोस्ट विश्लेषण

tweet.fields=created_at,public_metrics,possibly_sensitive

उपयोगकर्ता प्रोफ़ाइल

user.fields=created_at,description,location,public_metrics,verified

पोस्ट का पूरा संदर्भ

tweet.fields=created_at,author_id,conversation_id,in_reply_to_user_id,referenced_tweets
expansions=author_id,referenced_tweets.id
user.fields=username,name

मीडिया विवरण

tweet.fields=attachments
expansions=attachments.media_keys
media.fields=url,preview_image_url,alt_text,public_metrics

---

​

महत्वपूर्ण नोट्स

आप उप-फ़ील्ड्स का अनुरोध नहीं कर सकते। जब आप public_metrics का अनुरोध करते हैं, तो आपको सभी मेट्रिक्स (लाइक्स, रीपोस्ट्स, रिप्लाइज़, कोट्स) मिलते हैं। आप केवल public_metrics.like_count का अनुरोध नहीं कर सकते।

• रिस्पॉन्स में फ़ील्ड्स का क्रम अनुरोध के क्रम से अलग हो सकता है
• रिस्पॉन्स में कोई फ़ील्ड मौजूद न हो, तो उसका मान null या खाली होता है
• कुछ फ़ील्ड्स के लिए विशेष प्रमाणीकरण आवश्यक होता है (उदा., private metrics के लिए user context चाहिए)
• उपलब्ध फ़ील्ड्स के लिए हर endpoint का API संदर्भ देखें

---

​

अगले चरण

Expansions

रिस्पॉन्स में संबंधित ऑब्जेक्ट शामिल करें।

डेटा डिक्शनरी

सभी ऑब्जेक्ट के लिए संपूर्ण फ़ील्ड संदर्भ।