Descripción general

Comparación de los endpoints de consulta de Publicaciones de la X API

Los endpoints de consulta de Publicaciones de la X API v2 sustituyen a los endpoints estándar de v1.1 GET statuses/lookup y GET statuses/show. Esta guía está dirigida a desarrolladores que migran desde estas versiones anteriores a la X API v2.

---

Tabla de comparación de endpoints

Descripción	Standard v1.1	X API v2
Métodos HTTP compatibles	GET	GET
Dominio del host	https://api.x.com	https://api.x.com
Ruta del endpoint	/1.1/statuses/show.json, /1.1/statuses/lookup.json	/2/tweets
Autenticación	Contexto de usuario OAuth 1.0a	Contexto de usuario OAuth 1.0a, OAuth 2.0 solo App, OAuth 2.0 con código de autorización y PKCE
Formato JSON de la Publicación	Formato estándar v1.1	Formato X API v2, determinado por los parámetros fields y expansions (no es compatible con versiones anteriores de v1.1)
Permite seleccionar campos específicos		✔
Admite los campos de annotations		✔
Admite los nuevos campos de metrics		✔
Admite el campo conversation_id		✔
Proporciona historial de edición de la Publicación	✔	✔
Requiere credenciales de una developer App asociada a un Project		✔

---

v1.1 estándar comparado con X API v2

Si has estado trabajando con los endpoints estándar v1.1 GET statuses/show y GET statuses/lookup, esta guía te ayudará a comprender las similitudes y diferencias entre los endpoints estándar y los endpoints de consulta de Publicaciones de X API v2.

También te puede interesar nuestra herramienta visual de migración de formatos de datos, que te ayuda a ver rápidamente las diferencias entre el formato de datos de X API v1.1 y el formato de X API v2.

• Similitudes

  • Contexto de usuario OAuth 1.0a
  • Límites de Publicaciones por solicitud
  • Compatibilidad con el historial de edición de la Publicación y sus metadatos

• Diferencias

  • URLs de los endpoints
  • Requisitos de la App y del Proyecto
  • Formato de datos de la respuesta
  • Parámetros de la solicitud

Similitudes

Método de autenticación para contexto de usuario con OAuth 1.0a

El endpoint estándar admite OAuth 1.0a User Context, mientras que el nuevo endpoint de consulta de Publicaciones de X API v2 admite tanto OAuth 1.0a User Context como OAuth 2.0 App-Only. Por lo tanto, si antes usabas uno de los endpoints estándar de consulta de Publicaciones de v1.1, puedes seguir usando el mismo método de autenticación si migras a la versión de X API v2.

La autenticación App-Only suele ser la forma más sencilla de comenzar. Para aprender a generar un App Access Token, consulta esta guía de OAuth 2.0 App-only.

Límites de Publicaciones por solicitud

El endpoint v1.1 GET statuses/lookup te permite especificar hasta 100 Publicaciones por solicitud. Esto también se aplica al endpoint GET /tweets. Para especificar las 100 Publicaciones, utiliza el parámetro ids como parámetro de consulta con una lista separada por comas de Post IDs.

Compatibilidad con el historial de edición y los metadatos de las Publicaciones

Ambas versiones proporcionan metadatos que describen cualquier historial de edición. Consulta las Referencias de la API de búsqueda de Publicaciones y la página de conceptos básicos sobre edición de Publicaciones para obtener más detalles.

Diferencias

URLs de endpoints

• Endpoints estándar de v1.1:

  • https://api.x.com/1.1/statuses/show
  • https://api.x.com/1.1/statuses/lookup

• Endpoint de X API v2:

  • https://api.x.com/2/tweets
  • https://api.x.com/2/tweets/:id

Requisitos de App y Proyecto

Los endpoints de X API v2 requieren credenciales de una App de desarrollador asociada a un Proyecto para la autenticación. Los endpoints de X API v1.1 pueden usar credenciales de Apps o de Apps asociadas con una App.

Formato de los datos de respuesta

Una diferencia significativa entre las versiones de endpoints de la v1.1 estándar y de X API v2 es cómo se seleccionan los campos en el payload.

En los endpoints estándar, muchos campos de la respuesta se incluyen de forma predeterminada, con la opción de usar parámetros para especificar campos adicionales.

X API v2, sin embargo, solo entrega de forma predeterminada los campos id y text de la Publicación. Los campos y objetos adicionales requieren el uso de los parámetros fields y expansions. Los campos expandidos se devuelven en un objeto includes dentro de la respuesta, que se puede asociar con el objeto de Publicación principal haciendo coincidir los IDs.

Para obtener más información sobre el uso de campos y expansions, consulta la guía sobre cómo usar fields y expansions. Una guía de migración de formato de datos también relaciona los campos de la v1.1 estándar con los campos más recientes de v2.

Además, X API v2 introduce nuevos diseños JSON para objetos, incluidos los objetos de Publicación y de user:

• Los endpoints estándar devuelven objetos de Publicación en un array statuses, mientras que X API v2 usa un array data.
• Los Tweets retuiteados y citados en X API v2 sustituyen la terminología “statuses”.
• Nueva terminología como like reemplaza términos como favorites y favourites.
• Los atributos sin valor (por ejemplo, null) no se incluyen en los payloads de X API v2.

El objeto de Publicación en X API v2 incluye nuevos campos como:

• conversation_id
• Dos nuevos campos de annotations (context y entities)
• Nuevos campos de metrics
• El campo reply_setting que muestra quién puede responder a una Publicación determinada

Parámetros de la solicitud

Los siguientes parámetros de solicitud estándar de v1.1 tienen equivalentes en X API v2:

Estándar	X API v2
id	ids

Algunos parámetros estándar de v1.1 no son compatibles con X API v2:

Estándar	Comentario
tweet_mode	Sustituido por la funcionalidad de campos y expansions.
trim_user	Sustituido por campos y expansions. Usa la expansión author_id y user.fields para datos de usuario.
include_my_retweet	Proporciona el id de la Publicación de origen para las Publicaciones retuiteadas por el usuario autenticado.
include_entities	Usa campos y expansions para controlar las entidades en la carga útil.
include_ext_alt_text	Agrega el campo ext_alt_text en la entidad de medios si hay texto alternativo.
include_card_uri	Agrega card_uri cuando se adjunta una tarjeta de anuncios.
map	Devuelve el id de la Publicación y el mensaje de error para Publicaciones no disponibles en X API v2, en lugar de campos anulados en v1.1.

Solicitudes cURL

Las siguientes solicitudes cURL muestran endpoints estándar de v1.1 y sus equivalentes en v2. Reemplaza ACCESS_TOKEN en el encabezado con el token de acceso de tu App. En los endpoints de v2, el token debe pertenecer a una developer App dentro de un Project.

Los payloads de respuesta de v1.1 diferirán de los de v2. Con v2, puedes solicitar distintos campos con los parámetros fields y expansions.

Endpoints estándar v1.1 GET statuses/lookup y v2 GET /tweets

curl --request GET \
  --url 'https://api.x.com/1.1/statuses/lookup.json?id=1460323737035677698%2C1460323743339741184' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

  curl --request GET \
  --url 'https://api.x.com/2/tweets?ids=1460323737035677698%2C1460323743339741184&tweet.fields=created_at&expansions=author_id&user.fields=created_at' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

Endpoints GET statuses/show/:id de Standard v1.1 y GET /tweets/:id de v2

curl --request GET \
  --url 'https://api.x.com/1.1/statuses/show.json?id=1460323737035677698' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'

curl --request GET \
  --url 'https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at&expansions=author_id&user.fields=created_at' \
  --header 'Authorization: Bearer $ACCESS_TOKEN'