> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# फ़ील्ड्स

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

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

***

<div id="how-fields-work">
  ## फ़ील्ड्स कैसे काम करते हैं
</div>

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

```bash theme={null}
# डिफ़ॉल्ट रिस्पॉन्स - न्यूनतम फ़ील्ड्स
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"
```

***

<div id="available-field-parameters">
  ## उपलब्ध फ़ील्ड पैरामीटर
</div>

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

| ऑब्जेक्ट      | पैरामीटर       | दस्तावेज़                                                      |
| :------------ | :------------- | :------------------------------------------------------------- |
| पोस्ट (Tweet) | `tweet.fields` | [पोस्ट फ़ील्ड्स](/hi/x-api/fundamentals/data-dictionary#tweet) |
| उपयोगकर्ता    | `user.fields`  | [User फ़ील्ड्स](/hi/x-api/fundamentals/data-dictionary#user)   |
| Media         | `media.fields` | [Media फ़ील्ड्स](/hi/x-api/fundamentals/data-dictionary#media) |
| Poll          | `poll.fields`  | [Poll फ़ील्ड्स](/hi/x-api/fundamentals/data-dictionary#poll)   |
| Place         | `place.fields` | [Place फ़ील्ड्स](/hi/x-api/fundamentals/data-dictionary#place) |

***

<div id="example-post-fields">
  ## उदाहरण: पोस्ट फ़ील्ड्स
</div>

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

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

रिस्पॉन्स:

```json theme={null}
{
  "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
    }
  }
}
```

***

<div id="example-user-fields">
  ## उदाहरण: उपयोगकर्ता फ़ील्ड्स
</div>

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

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

रिस्पॉन्स:

```json theme={null}
{
  "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
    }
  }
}
```

***

<div id="fields-for-related-objects">
  ## संबंधित ऑब्जेक्ट्स के लिए फ़ील्ड्स
</div>

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

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

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

रिस्पॉन्स:

```json theme={null}
{
  "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` के बारे में अधिक जानें →](/hi/x-api/fundamentals/expansions)

***

<div id="common-field-combinations">
  ## सामान्य फ़ील्ड संयोजन
</div>

<Tabs>
  <Tab title="पोस्ट विश्लेषण">
    ```
    tweet.fields=created_at,public_metrics,possibly_sensitive
    ```
  </Tab>

  <Tab title="उपयोगकर्ता प्रोफ़ाइल">
    ```
    user.fields=created_at,description,location,public_metrics,verified
    ```
  </Tab>

  <Tab title="पोस्ट का पूरा संदर्भ">
    ```
    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
    ```
  </Tab>

  <Tab title="मीडिया विवरण">
    ```
    tweet.fields=attachments
    expansions=attachments.media_keys
    media.fields=url,preview_image_url,alt_text,public_metrics
    ```
  </Tab>
</Tabs>

***

<div id="important-notes">
  ## महत्वपूर्ण नोट्स
</div>

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

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

***

<div id="next-steps">
  ## अगले चरण
</div>

<CardGroup cols={2}>
  <Card title="Expansions" icon="expand" href="/hi/x-api/fundamentals/expansions">
    रिस्पॉन्स में संबंधित ऑब्जेक्ट शामिल करें।
  </Card>

  <Card title="डेटा डिक्शनरी" icon="book" href="/hi/x-api/fundamentals/data-dictionary">
    सभी ऑब्जेक्ट के लिए संपूर्ण फ़ील्ड संदर्भ।
  </Card>
</CardGroup>
