> ## 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.

# Campos

> Solicita campos de datos específicos en las respuestas de la X API

La X API v2 devuelve una cantidad mínima de datos de forma predeterminada. Usa los **parámetros de campos** para solicitar datos adicionales para cada tipo de objeto.

***

<div id="how-fields-work">
  ## Cómo funcionan los campos
</div>

De forma predeterminada, una consulta de publicaciones devuelve únicamente `id`, `text` y `edit_history_tweet_ids`. Para obtener más datos, añade parámetros de campos a tu solicitud:

```bash theme={null}
# Respuesta predeterminada - campos mínimos
curl "https://api.x.com/2/tweets/1234567890" \
  -H "Authorization: Bearer $TOKEN"

# With additional fields
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">
  ## Parámetros de campos disponibles
</div>

Cada tipo de objeto tiene su propio parámetro de campos:

| Objeto              | Parámetro      | Documentación                                                         |
| :------------------ | :------------- | :-------------------------------------------------------------------- |
| Publicación (Tweet) | `tweet.fields` | [Campos de publicación](/es/x-api/fundamentals/data-dictionary#tweet) |
| Usuario             | `user.fields`  | [Campos de usuario](/es/x-api/fundamentals/data-dictionary#user)      |
| Medio               | `media.fields` | [Campos de medios](/es/x-api/fundamentals/data-dictionary#media)      |
| Encuesta            | `poll.fields`  | [Campos de encuesta](/es/x-api/fundamentals/data-dictionary#poll)     |
| Lugar               | `place.fields` | [Campos de lugar](/es/x-api/fundamentals/data-dictionary#place)       |

***

<div id="example-post-fields">
  ## Ejemplo: campos de Publicación
</div>

Solicita campos específicos de una publicación usando `tweet.fields`:

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

Respuesta:

```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">
  ## Ejemplo: campos de usuario
</div>

Solicita campos de usuario específicos con `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"
```

Respuesta:

```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">
  ## Campos para objetos relacionados
</div>

Para obtener campos de objetos relacionados (como el autor de una publicación), necesitas dos cosas:

1. Una **expansión** para incluir el objeto relacionado
2. El **parámetro de campos** para ese tipo de objeto

```bash theme={null}
# Obtener publicación con detalles del autor
curl "https://api.x.com/2/tweets/1234567890?expansions=author_id&user.fields=description,public_metrics" \
  -H "Authorization: Bearer $TOKEN"
```

Respuesta:

```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
      }
    }]
  }
}
```

[Más información sobre expansions →](/es/x-api/fundamentals/expansions)

***

<div id="common-field-combinations">
  ## Combinaciones de campos comunes
</div>

<Tabs>
  <Tab title="Analíticas de Publicaciones">
    ```
    tweet.fields=created_at,public_metrics,possibly_sensitive
    ```
  </Tab>

  <Tab title="Perfiles de usuario">
    ```
    user.fields=created_at,description,location,public_metrics,verified
    ```
  </Tab>

  <Tab title="Contexto completo de la publicación">
    ```
    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="Detalles de contenido multimedia">
    ```
    tweet.fields=attachments
    expansions=attachments.media_keys
    media.fields=url,preview_image_url,alt_text,public_metrics
    ```
  </Tab>
</Tabs>

***

<div id="important-notes">
  ## Notas importantes
</div>

<Warning>
  **No puedes solicitar subcampos.** Cuando solicitas `public_metrics`, obtienes todas las métricas (Me gusta, republicaciones, respuestas, citas). No puedes solicitar solo `public_metrics.like_count`.
</Warning>

* El orden de los campos en las respuestas puede diferir del orden en la solicitud
* La ausencia de campos en las respuestas significa que el valor es `null` o está vacío
* Algunos campos requieren autenticación específica (por ejemplo, las métricas privadas necesitan contexto de usuario)
* Revisa la Referencia de la API de cada endpoint para ver los campos disponibles

***

<div id="next-steps">
  ## Próximos pasos
</div>

<CardGroup cols={2}>
  <Card title="Expansions" icon="expand" href="/es/x-api/fundamentals/expansions">
    Incorpora objetos relacionados en las respuestas.
  </Card>

  <Card title="Diccionario de datos" icon="book" href="/es/x-api/fundamentals/data-dictionary">
    Referencia completa de los campos de todos los objetos.
  </Card>
</CardGroup>
