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.

---

Cómo funcionan los campos

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:

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

---

Parámetros de campos disponibles

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
Usuario	user.fields	Campos de usuario
Medio	media.fields	Campos de medios
Encuesta	poll.fields	Campos de encuesta
Lugar	place.fields	Campos de lugar

---

Ejemplo: campos de Publicación

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

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

Respuesta:

{
  "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
    }
  }
}

---

Ejemplo: campos de usuario

Solicita campos de usuario específicos con user.fields:

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

Respuesta:

{
  "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 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

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

{
  "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 →

---

Combinaciones de campos comunes

Analíticas de Publicaciones

tweet.fields=created_at,public_metrics,possibly_sensitive

Perfiles de usuario

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

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

Detalles de contenido multimedia

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

---

Notas importantes

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.

• 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

---

Próximos pasos

Expansions

Incorpora objetos relacionados en las respuestas.

Diccionario de datos

Referencia completa de los campos de todos los objetos.