Inicio rápido

Esta guía te guía en la recuperación de Posts desde el timeline de una List.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
El Bearer Token de tu App

Encuentra un ID de List

Puedes encontrar un ID de List en la URL al ver una List en x.com:

https://x.com/i/lists/84839422
                      └── Este es el ID de la List

Solicita el timeline de la List

cURL

curl "https://api.x.com/2/lists/84839422/tweets?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener Posts de una List con paginación
for page in client.lists.get_tweets(
    "84839422",
    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]}... - Likes: {post.public_metrics.like_count}")

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

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

// Obtener Posts de una List con paginación
const paginator = client.lists.getTweets("84839422", {
  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)}... - Likes: ${post.public_metrics?.like_count}`);
  });
}

Revisa la respuesta

{
  "data": [
    {
      "id": "1458172421115101189",
      "text": "Check out our latest announcement...",
      "author_id": "4172587277",
      "created_at": "2024-01-15T10:30:00.000Z",
      "public_metrics": {
        "retweet_count": 42,
        "reply_count": 5,
        "like_count": 156,
        "quote_count": 3
      },
      "edit_history_tweet_ids": ["1458172421115101189"]
    }
  ],
  "includes": {
    "users": [
      {
        "id": "4172587277",
        "username": "TechNews",
        "verified": true
      }
    ]
  },
  "meta": {
    "result_count": 1,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}

Pagina los resultados

Los SDKs gestionan la paginación automáticamente. Para cURL, usa el next_token de la respuesta para obtener más Posts:

curl "https://api.x.com/2/lists/84839422/tweets?\
max_results=10&\
pagination_token=7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Este endpoint devuelve hasta 800 de los Posts más recientes de la List.

Próximos pasos

List lookup

Obtén detalles de una List

List members

Obtén los miembros de una List

Guía de integración

Conceptos clave y mejores prácticas

Referencia de la API

Documentación completa del endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Inicio rápido

Próximos pasos

List lookup

List members

Guía de integración

Referencia de la API

​Próximos pasos

List lookup

List members

Guía de integración

Referencia de la API

Próximos pasos