X List Tweets
La línea de tiempo de una lista de X reúne los tweets y retweets de las cuentas que alguien agrupó en esa lista, cada uno con su texto, autor, Me gusta, comentarios, reposts, vistas, imágenes o videos adjuntos, hashtags y menciones. Leídos en conjunto, estos posts permiten seguir lo que comenta un grupo seleccionado de periodistas, fundadores o competidores, ver qué miembros generan más interacción con sus posts y descubrir de quién es el contenido que el grupo comparte una y otra vez.
Funcionalidades de la X List Tweets API
- La línea de tiempo de cualquier lista pública por URLEnvíe uno o más enlaces x.com/i/lists/<id> y la línea de tiempo de cada lista vuelve del post más reciente al más antiguo, con hasta 2,000 tweets por lista.
- Reposts identificados y autor original por separadois_repost marca cada repost; author sigue siendo el miembro de la lista que lo compartió, mientras que reposted_author y reposted_post_id apuntan al creador y al post originales.
- Interacción y archivos multimedia en cada postmetrics contiene Me gusta, comentarios, veces compartido y vistas, y media enumera cada imagen o video con su URL, miniatura, ancho y alto.
- Hashtags y menciones en listas separadashashtags y mentions llegan como listas propias, de modo que los temas que trata una lista y las cuentas a las que se dirigen sus miembros pueden contarse directamente desde los campos.
Parámetros de la X List Tweets API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | URL de listas públicas de X con el formato https://x.com/i/lists/<numeric id>. La línea de tiempo de cada lista se recopila por separado. |
results_limit | Opcional | Posts que se recopilan de cada lista, en múltiplos de 20 de 20 a 2,000. El valor predeterminado es 100. |
Cómo usar la X List Tweets API
Envíe las URL de las listas, espere a que termine la tarea y luego lea la línea de tiempo página por página.
- Envíe {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} por POST a /v1/x/list-posts.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los posts en results.items, del más reciente al más antiguo, y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'
# Reposts arrive with is_repost set to true and the original creator in reposted_author.Casos de uso de la X List Tweets API
- Seguir un tema a través de una lista seleccionada: Obtenga cada mañana la línea de tiempo de una lista de periodistas o analistas y lea text, author y published_at para ver qué cubrió el grupo desde la última ejecución.
- Clasificar los posts que mueven a un nicho: Conserve los posts originales (is_repost en false) y ordénelos por views_count y likes_count para encontrar qué actualizaciones de los miembros atrajeron más atención.
- Medir a quién amplifica un grupo: Cuente reposted_author.username en los reposts para ver qué cuentas externas y qué otros miembros difunde una lista con más frecuencia.
- Reunir los anuncios de la competencia en una sola línea de tiempo: Agregue las cuentas de las marcas rivales a una lista y recopile su línea de tiempo para capturar juntos sus posts de lanzamiento, enlaces y archivos multimedia adjuntos.
- Crear un conjunto de datos temático de una comunidad: Agrupe los hashtags y las menciones de los posts de una lista por published_at para graficar qué temas y cuentas comenta la comunidad a lo largo del tiempo.
Consejos de expertos para la X List Tweets API
- Filtre por is_repost antes de clasificar a los miembros por interacción, porque un repost lleva los Me gusta y las vistas del post original.
- Cuando varios miembros hacen repost del mismo post, deduplique por reposted_post_id para contar cada original una sola vez.
- Suba results_limit cuando necesite muchos posts originales de una lista muy activa, ya que los reposts pueden ocupar la mayor parte de su línea de tiempo.
- El texto de un repost empieza con “RT @user:” y sus menciones incluyen a ese usuario, así que descarte los reposts o quite el prefijo antes de contar palabras clave y menciones.
- En las ejecuciones programadas, conserve solo los elementos cuyo id sea nuevo en su almacenamiento, porque una línea de tiempo ordenada del más reciente al más antiguo se superpone con la ejecución anterior.
- Para ver todas las cuentas que alimentan la línea de tiempo, incluidos los miembros que publican poco, recopile la misma lista con Twitter List Members API.
APIs relacionadas
Además de la X List Tweets API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- X Post Quotes API — Recolecta posts públicos con cita de URLs de estado conocidas, con comentario, autores, interacción, contenido multimedia, marcas de tiempo y contexto del post de origen.
- X Post Replies API — Recolecta respuestas públicas de URLs de posts de X con orden seleccionable, texto de la respuesta, autores, interacción visible, contenido multimedia y contexto del post principal.
- Twitter Mentions API — Recolecta posts públicos que mencionan a una cuenta indicada.
- Twitter List Members API — Exporta las cuentas de una lista como perfiles completos con biografía, ubicación y contadores.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API