> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Fields
> La X API v2 devuelve datos mínimos por defecto. Usa los parámetros de fields para solicitar datos adicionales para cada tipo de objeto. Por defecto, una búsqueda de post devuelve solo.
La X API v2 devuelve datos mínimos por defecto. Usa los **parámetros de fields** para solicitar datos adicionales para cada tipo de objeto.
***
## Cómo funcionan los fields
Por defecto, una búsqueda de post solo devuelve `id`, `text` y `edit_history_tweet_ids`. Para obtener más datos, añade parámetros de field a tu solicitud:
```bash theme={null}
# Default response - minimal fields
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"
```
***
## Parámetros de fields disponibles
Cada tipo de objeto tiene su propio parámetro de fields:
| Objeto | Parámetro | Documentación |
| :----------- | :------------- | :------------------------------------------------------------------ |
| Post (Tweet) | `tweet.fields` | [Post fields](/x-api/fundamentals/data-dictionary/reference#tweet) |
| User | `user.fields` | [User fields](/x-api/fundamentals/data-dictionary/reference#user) |
| Media | `media.fields` | [Media fields](/x-api/fundamentals/data-dictionary/reference#media) |
| Poll | `poll.fields` | [Poll fields](/x-api/fundamentals/data-dictionary/reference#poll) |
| Place | `place.fields` | [Place fields](/x-api/fundamentals/data-dictionary/reference#place) |
***
## Ejemplo: Campos de Post
Solicita campos específicos de post con `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 title="Ejemplo de respuesta" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" 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,
"bookmark_count": 3,
"impression_count": 1500
}
}
}
```
***
## Ejemplo: Campos de usuario
Solicita campos específicos de usuario 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 title="Ejemplo de respuesta" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" 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
}
}
}
```
***
## Campos para objetos relacionados
Para obtener campos de objetos relacionados (como el autor de un post), necesitas dos cosas:
1. Una **expansion** para incluir el objeto relacionado
2. El **parámetro de fields** para ese tipo de objeto
```bash theme={null}
# Get post with author details
curl "https://api.x.com/2/tweets/1234567890?expansions=author_id&user.fields=description,public_metrics" \
-H "Authorization: Bearer $TOKEN"
```
Respuesta:
```json title="Ejemplo de respuesta" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" 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
}
}]
}
}
```
[Aprende más sobre expansions →](/x-api/fundamentals/expansions)
***
## Combinaciones comunes de fields
```
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
```
***
## Notas importantes
**No puedes solicitar subcampos.** Al solicitar `public_metrics`, obtienes todas las métricas (likes, reposts, replies, quotes, bookmarks, impressions). No puedes solicitar únicamente `public_metrics.like_count`.
* El orden de los fields en las respuestas puede diferir del orden en la solicitud
* Los campos faltantes en las respuestas significan que el valor es `null` o vacío
* Algunos campos requieren autenticación específica (p. ej., las métricas privadas necesitan contexto de usuario)
* Consulta la referencia de la API de cada endpoint para los fields disponibles
***
## Próximos pasos
Incluye objetos relacionados en las respuestas.
Referencia completa de campos para todos los objetos.