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.fieldsCampos de publicación Usuario user.fieldsCampos de usuario Medio media.fieldsCampos de medios Encuesta poll.fieldsCampos de encuesta Lugar place.fieldsCampos 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 } } }
Para obtener campos de objetos relacionados (como el autor de una publicación), necesitas dos cosas:
Una expansión para incluir el objeto relacionado
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
Perfiles de usuario
Contexto completo de la publicación
Detalles de contenido multimedia
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
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
Expansions Incorpora objetos relacionados en las respuestas.
Diccionario de datos Referencia completa de los campos de todos los objetos.
