Inicio rápido de la cronología de inicio

Esta guía te explica cómo hacer tu primera solicitud al endpoint de la cronología de inicio en orden cronológico inverso.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Tokens de acceso de usuario (este endpoint requiere autenticación de usuario)

Paso 1: Obtener el ID de usuario

Necesitas el ID de usuario de la cuenta cuya timeline de inicio quieres recuperar. Puedes obtenerlo usando el endpoint de consulta por nombre de usuario:

cURL

curl "https://api.x.com/2/users/by/username/XDevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

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

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

const response = await client.users.getByUsername("XDevelopers");
console.log(`User ID: ${response.data?.id}`);

La respuesta incluye el ID de usuario:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers"
  }
}

Paso 2: Solicitar el timeline de inicio

Realiza una solicitud GET con el ID de usuario y el token de acceso de usuario (User Access Token):

cURL

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtener el timeline de inicio con paginación
for page in client.posts.get_home_timeline("2244994945"):
    for post in page.data:
        print(post.text)

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obtener el timeline de inicio con paginación
const paginator = client.posts.getHomeTimeline("2244994945");

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

Paso 3: Revisar la respuesta

{
  "data": [
    {
      "id": "1524796546306478083",
      "text": "Today marks the launch of Devs in the Details...",
      "edit_history_tweet_ids": ["1524796546306478083"]
    },
    {
      "id": "1524468552404668416",
      "text": "Join us tomorrow for a discussion about bots...",
      "edit_history_tweet_ids": ["1524468552404668416"]
    }
  ],
  "meta": {
    "result_count": 2,
    "newest_id": "1524796546306478083",
    "oldest_id": "1524468552404668416",
    "next_token": "7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4"
  }
}

Paso 4: Añade campos y expansions

Solicita datos adicionales mediante parámetros de consulta:

cURL

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Obtén el timeline de inicio con campos y expansions
for page in client.posts.get_home_timeline(
    "2244994945",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Me gusta: {post.public_metrics.like_count}")

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

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

// Obtén el timeline de inicio con campos y expansions
const paginator = client.posts.getHomeTimeline("2244994945", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
  maxResults: 10,
});

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

Paso 5: Paginar los resultados

Los SDK se encargan de la paginación automáticamente. Para cURL, utiliza el next_token de la respuesta para obtener más resultados:

curl "https://api.x.com/2/users/2244994945/timelines/reverse_chronological?\
max_results=10&\
pagination_token=7140dibdnow9c7btw421dyz6jism75z99gyxd8egarsc4" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

Parámetros comunes

Parámetro	Descripción	Valor predeterminado
`max_results`	Resultados por página (1-100)	10
`start_time`	Marca de tiempo de la Publicación más antigua (ISO 8601)	—
`end_time`	Marca de tiempo de la Publicación más reciente (ISO 8601)	—
`since_id`	Devuelve Publicaciones posteriores a este ID	—
`until_id`	Devuelve Publicaciones anteriores a este ID	—
`exclude`	Excluye `retweets`, `replies` o ambos	—

Próximos pasos

Menciones de usuario

Obtén Publicaciones que mencionan a un usuario

Guía de integración

Conceptos clave y mejores prácticas

Referencia de la API

Documentación completa del endpoint

Guía de paginación

Navega por conjuntos de resultados de gran tamaño

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Inicio rápido de la cronología de inicio

Paso 1: Obtener el ID de usuario

Paso 2: Solicitar el timeline de inicio

Paso 3: Revisar la respuesta

Paso 4: Añade campos y expansions

Paso 5: Paginar los resultados

Parámetros comunes

Próximos pasos

Menciones de usuario

Guía de integración

Referencia de la API

Guía de paginación