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.

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:

# 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
User	`user.fields`	User fields
Media	`media.fields`	Media fields
Poll	`poll.fields`	Poll fields
Place	`place.fields`	Place fields

Ejemplo: Campos de Post

Solicita campos específicos de post con tweet.fields:

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

Respuesta:

Ejemplo de 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,
      "bookmark_count": 3,
      "impression_count": 1500
    }
  }
}

Ejemplo: Campos de usuario

Solicita campos específicos de usuario 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:

Ejemplo de 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 un post), necesitas dos cosas:

Una expansion para incluir el objeto relacionado
El parámetro de fields para ese tipo de objeto

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

Ejemplo de 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
      }
    }]
  }
}

Aprende más sobre expansions →

Combinaciones comunes de fields

Analíticas de post
Perfiles de usuario
Contexto completo del post
Detalles de medios

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

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Fields

Cómo funcionan los fields

Parámetros de fields disponibles

Ejemplo: Campos de Post

Ejemplo: Campos de usuario

Campos para objetos relacionados

Combinaciones comunes de fields

Notas importantes

Próximos pasos

Expansions

Diccionario de datos

​Cómo funcionan los fields

​Parámetros de fields disponibles

​Ejemplo: Campos de Post

​Ejemplo: Campos de usuario

​Campos para objetos relacionados

​Combinaciones comunes de fields

​Notas importantes

​Próximos pasos

Expansions

Diccionario de datos

Cómo funcionan los fields

Parámetros de fields disponibles

Ejemplo: Campos de Post

Ejemplo: Campos de usuario

Campos para objetos relacionados

Combinaciones comunes de fields

Notas importantes

Próximos pasos