v1 a v2

Cronologías estándar v1.1 a cronologías de X API v2

Si has estado trabajando con los endpoints de cronologías v1.1 (statuses/user_timeline y statuses/mentions_timeline), el objetivo de esta guía es ayudarte a entender las similitudes y diferencias entre los endpoints de cronologías estándar y los de X API v2, de modo que puedas migrar tu integración actual a la nueva versión.

Similitudes:
- Autenticación:
  - OAuth 1.0a User Context (cronología de inicio en orden cronológico inverso, cronología de Publicaciones de usuario y cronología de menciones de usuario)
  - OAuth 2.0 App-Only (cronología de Publicaciones de usuario)
- Límite de acceso histórico: la cronología de usuario (cronología de Publicaciones de usuario) proporciona acceso a las 3200 Publicaciones más recientes; la cronología de menciones (cronología de menciones de usuario) proporciona acceso a las 800 menciones más recientes.
- Compatibilidad con historial de edición de la Publicación y metadatos
- Límites de tasa (cronología de Publicaciones de usuario)
- Sondeo de actualización: posibilidad de recuperar nuevos resultados desde el since_id
- Recorrido de cronologías por ID de Publicación
- Especificaciones de resultados:
  - Orden de resultados: resultados devueltos en orden cronológico inverso
  - Posibilidad de excluir respuestas (solo cronología de Publicaciones de usuario)
  - Posibilidad de excluir Retweets (solo cronología de Publicaciones de usuario)
Diferencias
- Nueva capacidad de autenticación:
  - OAuth 2.0 App-Only (cronología de menciones de usuario)
  - OAuth 2.0 Authorization Code Flow with PKCE (cronología de inicio en orden cronológico inverso, cronología de Publicaciones de usuario y cronología de menciones de usuario)
- Requisitos de acceso: requisitos de App y de proyecto de X API v2
- Límites de tasa (cronología de menciones de usuario y cronología de inicio en orden cronológico inverso)
- Método de paginación adicional
  - Diferente max_results (count) por respuesta
- Formato de datos de la respuesta
- Parámetros de la solicitud
  - Formato de datos personalizado según los parámetros de la solicitud, incluidos los campos v2 y expansions
  - Datos adicionales disponibles: métricas, anotaciones de Publicación, encuestas

Similitudes

Autenticación El endpoint v1.1 statuses/user_timeline y el endpoint de timeline de Publicaciones de usuario de X API v2 admiten tanto OAuth 1.0a User Context como OAuth 2.0 App-Only. Por lo tanto, puedes seguir usando el mismo método de autenticación y los mismos tokens de autorización si migras a la versión de X API v2. Acceso histórico Tanto v1.1 statuses/user_timeline como el endpoint de timeline de Publicaciones de usuario de X API v2 devolverán las 3200 Publicaciones más recientes, incluidos los Retweets. Los endpoints v1.1 statuses/mentions_timeline y el timeline de menciones de usuario de X API v2 pueden devolver las 800 Publicaciones más recientes. Compatibilidad con el historial de edición de Publicaciones y metadatos Ambas versiones proporcionan metadatos que describen cualquier historial de edición. Consulta las Referencias de la API de flujo filtrado y la página de fundamentos de edición de Publicaciones para obtener más detalles. Límites de tasa


Standard v1.1	X API v2
user_timeline: 900 solicitudes cada 15 minutos con OAuth 1.0a User Context 1500 solicitudes cada 15 minutos con OAuth 2.0 App-Only	Timeline de Publicaciones de usuario: 900 solicitudes por ventana de 15 minutos con OAuth 1.0a User Context 1500 solicitudes por ventana de 15 minutos con OAuth 2.0 App-Only

Actualización mediante sondeo usando since_id Ambas versiones permiten sondear en busca de resultados recientes usando since_id. Recorrido de timelines por ID de Publicación Ambos endpoints tienen la capacidad de recorrer timelines usando ‘timestamps’ de ID de Publicación basados en la forma en que se construyen las ID de Publicación. La funcionalidad es, en general, la misma, excepto por lo siguiente:


Standard timelines v1.1	timelines v2
since_id (exclusivo) max_id (inclusivo)	since_id (exclusivo) until_id (también exclusivo, frente a max_id, que era inclusivo)

Parámetros de filtrado de respuesta


Standard timelines v1.1	timelines v2
Parámetros de filtrado de respuesta: * include_rts * exclude_replies	Parámetros de filtrado de respuesta: * exclude=retweets,replies
Ejemplo https://api.x.com/1.1/statuses/user_timeline.json?user_id=2244994945&include_rts=0&&exclude_replies=1	Ejemplo: https://api.x.com/2/users/2244994945/tweets?max_results=100&exclude=retweets,replies
Notas: Para user_timeline: * Usar include_rts=0 no cambia el posible límite histórico de Publicaciones de las 3200 más recientes	Notas: Para el timeline de Publicaciones de usuario: * Usar exclude=retweets no cambia el posible límite histórico de Publicaciones de las 3200 más recientes * Usar exclude=replies reduce el posible límite histórico de Publicaciones a las 800 respuestas más recientes

Diferencias

Autenticación **El endpoint v1.1 statuses/mentions_timeline solo admite OAuth 1.0a User Context. El endpoint de timeline de menciones de usuario de X API v2 admite OAuth 1.0a User Context, OAuth 2.0 App-Only y OAuth 2.0 Authorization Code with PKCE ** Si deseas aprovechar la posibilidad de acceder a métricas privadas o promocionadas mediante el endpoint de timeline de Publicaciones de usuario de X API v2, deberás usar OAuth 1.0a User Context u OAuth 2.0 Authorization Code with PKCE y pasar los tokens de acceso de usuario relacionados con el usuario que publicó la Publicación para la cual deseas acceder a las métricas. URLs de los endpoints Ten en cuenta que los endpoints de timelines de X API v2 requieren un parámetro de ruta :id para el id de usuario.

Endpoints estándar v1.1:
Endpoint de X API v2:

Requisitos de App y Project Los endpoints de X API v2 requieren que uses credenciales de una developer App que esté asociada a un Project al autenticar tus solicitudes. Todos los endpoints de X API v1.1 pueden usar credenciales de Apps o de Apps asociadas con un Project. Límites de tasa


mentions_timeline: 75 solicitudes por 15 min con OAuth 1.0a User Context	user mention timeline: 180 solicitudes por ventana de 15 minutos con OAuth 1.0a User Context 450 solicitudes por ventana de 15 minutos con OAuth 2.0 Bearer Token
home_timelime: 15 solicitudes por 15 minutos Se pueden obtener hasta 800 Publicaciones en el home timeline	reverse chronological home timeline: 180 solicitudes por 15 minutos Puedes recuperar todas las Publicaciones creadas en un timeline durante los últimos 7 días, así como las 800 más recientes, independientemente de la fecha de creación.

Parámetros de la solicitud


Standard timelines v1.1	timelines v2
Obligatorio: user_id o screen_name	Obligatorio: se indica el ID de usuario específico en el parámetro de la ruta
Opcional: count - establece el número máximo de resultados devueltos por solicitud exclude_replies - elimina las respuestas de los resultados Include_rts - cuando se establece en 0 elimina los Retweets de los resultados trim_user - elimina los objetos de usuario rehidratados de los resultados tweet_mode - establece el formato de datos devuelto para los resultados; establézcalo en extended para Publicaciones de más de 140 caracteres since_id - establece el ID de Publicación más antiguo en el resultado (exclusivo) max_id - establece el ID de Publicación más reciente en el resultado (incluido)	Opcional: max_results - establece el número máximo de resultados devueltos por solicitud exclude=retweets,replies - elimina los Retweets o las respuestas de los resultados tweet.fields - establece los campos del objeto Publicación que se devolverán user.fields - establece los campos del objeto User que se devolverán place.fields - establece los campos del objeto place que se devolverán media.fields - establece los campos del objeto media que se devolverán poll.fields - establece los campos del objeto poll que se devolverán expansions - establece los campos y datos expandidos que se devolverán start_time - establece la marca de tiempo created_at más temprana para los resultados end_time - establece la marca de tiempo created_at más reciente para los resultados since_id - establece el ID de Publicación más antiguo para los resultados (exclusivo) until_id - establece el ID de Publicación más reciente en el resultado (exclusivo)

Formato de datos de la respuesta


Standard search v1.1	Search Posts v2
[ objeto Tweet, objeto Tweet ]	“data”: [id,text,id,text], “meta”: “oldest_id”: “1337085692623646724”, “newest_id”: “1334183616172019713”, “previous_token”: “77qpymm88g5h9vqkluldpw91lr0qzfz1sqydh841iz48k”, “result_count”: 10, “next_token”: “7140dibdnow9c7btw3w29gqolns6a1ipl3kzeae41vsxk”

Formato JSON de X API v2 X API v2 introduce nuevos diseños JSON para los objetos devueltos por las APIs, incluidos los objetos de Publicación y de usuario. Puede obtener más información sobre el formato de X API v2 y cómo usar campos y Expansions visitando nuestra guía y leyendo nuestro diccionario de datos más completo.

En el nivel raíz de JSON, los endpoints estándar devuelven objetos de Publicación en un array statuses, mientras que X API v2 devuelve un array data.
En lugar de hacer referencia a “statuses” Retweeted y Quoted, el JSON de X API v2 hace referencia a Tweets Retweeted y Quoted. Muchos campos heredados y obsoletos, como contributors y user.translator_type, se están eliminando.
En lugar de usar tanto favorites (en el objeto de Publicación) como favorites (en el objeto de usuario), X API v2 usa el término like.
X está adoptando la convención de que los valores JSON sin valor (por ejemplo, null) no se escriben en el payload. Los atributos de Publicación y de usuario solo se incluyen si tienen un valor distinto de null.

Una de las mayores diferencias entre las versiones de endpoints estándar v1.1 y X API v2 es cómo selecciona qué campos se devuelven en su payload. Para los endpoints estándar, hay varios parámetros que puede usar para identificar qué campos o conjuntos de campos se devolverían en el payload, mientras que la versión de X API v2 simplifica estos diferentes parámetros en campos y expansions.

fields: los endpoints de X API v2 permiten seleccionar qué campos se incluyen en tu payload. Por ejemplo, los objetos de Publicación, usuario, Media, Place y Poll tienen cada uno una lista de campos que se pueden devolver (o no).
expansions: se usan para expandir los objetos complementarios referenciados en los payloads JSON de Publicación. Por ejemplo, todos los Retweets y respuestas hacen referencia a otras Publicaciones. Al establecer expansions=referenced_tweets.id, estos otros objetos de Publicación se expanden de acuerdo con la configuración de tweet.fields. Otros objetos como usuarios, polls y media también se pueden expandir.
conversation_id
Dos nuevos campos de annotations, incluidos context y entities
Varios campos nuevos de metrics

Hemos preparado una guía de migración de formato de datos que puede ayudarte a mapear los campos estándar de v1.1 a los campos más nuevos de v2. Esta guía también te proporcionará el parámetro específico expansions y fields que deberás pasar con tu solicitud a v2 para devolver campos específicos.

Ejemplos de código

Cronología de Publicaciones de un usuario (v2)

cURL

curl "https://api.x.com/2/users/2244994945/tweets?max_results=100&tweet.fields=created_at,public_metrics&exclude=retweets,replies" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener la cronología de Publicaciones del usuario
for page in client.posts.get_user_posts(
    "2244994945",
    tweet_fields=["created_at", "public_metrics"],
    exclude=["retweets", "replies"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener la cronología de Publicaciones del usuario
const paginator = client.posts.getUserPosts("2244994945", {
  tweetFields: ["created_at", "public_metrics"],
  exclude: ["retweets", "replies"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.created_at}: ${post.text?.slice(0, 50)}...`);
  });
}

Cronología de menciones de usuario (v2)

cURL

curl "https://api.x.com/2/users/2244994945/mentions?max_results=100&tweet.fields=created_at,author_id" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener las menciones del usuario
for page in client.posts.get_user_mentions(
    "2244994945",
    tweet_fields=["created_at", "author_id"],
    max_results=100
):
    for post in page.data:
        print(f"Mencionado por {post.author_id}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener las menciones del usuario
const paginator = client.posts.getUserMentions("2244994945", {
  tweetFields: ["created_at", "author_id"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`Mencionado por ${post.author_id}: ${post.text?.slice(0, 50)}...`);
  });
}

Próximos pasos Consulta nuestra guía de inicio rápido para la consulta de Publicaciones con X API v2 Revisa la Referencia de la API para la consulta de Publicaciones en v2 Consulta nuestro código de ejemplo para los endpoints de cronologías

Getting Started

Fundamentals

Partners & Customers

Resources

v1 a v2

Cronologías estándar v1.1 a cronologías de X API v2

Similitudes

Diferencias

Ejemplos de código

Cronología de Publicaciones de un usuario (v2)

Cronología de menciones de usuario (v2)

​Cronologías estándar v1.1 a cronologías de X API v2

​Similitudes

​Diferencias

​Ejemplos de código

​Cronología de Publicaciones de un usuario (v2)

​Cronología de menciones de usuario (v2)

Cronologías estándar v1.1 a cronologías de X API v2

Similitudes

Diferencias

Ejemplos de código

Cronología de Publicaciones de un usuario (v2)

Cronología de menciones de usuario (v2)