x/
list-posts

Recopile los posts y reposts más recientes de las líneas de tiempo de listas públicas de X a partir de la URL de cada lista, con texto, autor, Me gusta, vistas, archivos multimedia y un indicador de repost en cada elemento, del más reciente al más antiguo.

X List Tweets API

URL de la lista
Reposts identificados
Posts más recientes primero
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioURL 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_limitOpcionalPosts 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.

  1. Envíe {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100} por POST a /v1/x/list-posts.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

X List Tweets API — FAQ

X List Tweets API es una interfaz programática para recopilar la línea de tiempo de listas públicas de X a partir de sus URL /i/lists. Devuelve cada post o repost con su texto, autor, Me gusta, comentarios, veces compartido, vistas, archivos multimedia, hashtags, menciones y origen del repost.

Abra la lista en x.com, copie su URL (tiene la forma https://x.com/i/lists/1940592907737845989) y envíela en urls. Los posts vuelven del más reciente al más antiguo, en el mismo orden que la propia línea de tiempo de la lista.

Es el número que aparece después de /i/lists/ en la URL de la lista. Al enviar la solicitud, ponga la URL completa en urls.

Sí. Los reposts de los miembros de la lista se devuelven marcados con is_repost, con el ID del post original en reposted_post_id y su creador en reposted_author. Filtre por is_repost cuando quiera solo posts originales.

Una URL que apunta a una lista inexistente devuelve un resultado vacío; la tarea termina con éxito y no se cobra nada. Compruebe que el número después de /i/lists/ esté completo.

Sí. Agregue la URL de cada lista a urls. results_limit se cuenta por lista, así que tres listas con un límite de 100 pueden devolver hasta 300 posts.