x/
article

Obtenga el texto completo de los Artículos de X a partir de las URL de los posts que los publican, con título, vista previa de la línea de tiempo, imagen de portada, autor e interacción, conservando los saltos de párrafo.

X Articles API

URL del post
Cuerpo completo del Artículo
Título, vista previa y portada
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 Articles

Los Artículos de X, que muchos todavía llaman artículos de Twitter, son posts de formato largo que los suscriptores de Premium publican con un título, una imagen de portada y un cuerpo con formato; en las líneas de tiempo aparecen como una vista previa breve y reúnen Me gusta, respuestas, citas y vistas como cualquier otro post. Tener el título, la vista previa y el cuerpo completo como texto junto a esos conteos permite archivar los textos largos, resumirlos o clasificarlos y comparar el rendimiento de los Artículos con el de los posts habituales de un autor.

Funcionalidades de la X Articles API

  • Posts de Artículos por URLEnvíe uno o más enlaces a los tweets que publican Artículos, con el formato x.com/{username}/status/{post_id}, y cada Artículo devuelve una fila cuyo id y cuya url corresponden a ese post.
  • El cuerpo completo como texto planotext contiene el Artículo entero con una línea en blanco entre párrafos, listo para dividirse en párrafos o pasarse a un lector, a un índice de búsqueda o a un modelo de lenguaje.
  • Título, línea de vista previa e imagen de portadatitle, summary (la vista previa que X muestra en las líneas de tiempo) y cover_url describen el Artículo tal como lo encuentran por primera vez los lectores en su línea de tiempo.
  • Autor e interacciónauthor indica el usuario, el nombre visible, el avatar y el indicador de verificación; metrics indica Me gusta, respuestas, citas y vistas; y published_at registra cuándo se publicó el Artículo.

Parámetros de la X Articles API

ParámetrosObligatorioDescripción
urlsObligatorioUna o más URL de posts de X con el formato /{username}/status/{post_id}, cada una apuntando al post que publica un Artículo.

Cómo usar la X Articles API

Envíe los enlaces de los posts que contienen los Artículos y luego lea una fila por Artículo.

  1. Envíe {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} por POST a /v1/x/article.
  2. Consulte GET /v1/tasks/{task_id} hasta que el estado de la tarea sea succeeded.
  3. Lea los Artículos en results.items; mientras has_more sea true, envíe results.next_cursor para obtener la página siguiente.
curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/USDOL/status/2119796255089947070"]}'

# text holds the whole Article, with a blank line between paragraphs.

Casos de uso de la X Articles API

  • Archivar los textos largos de un autor: Guarde title, text, cover_url, published_at y url de cada Artículo para conservar una copia consultable de lo que una cuenta ha publicado en formato largo.
  • Resumir Artículos con un modelo de lenguaje: Divida text en sus líneas en blanco y entregue los párrafos a una herramienta de resumen o a un modelo de lenguaje, con title como contexto, para convertir Artículos largos en resúmenes breves.
  • Comparar los Artículos con los posts habituales de un autor: Ponga views_count, likes_count y quotes_count de los Artículos de un autor junto a los mismos conteos de sus posts habituales para ver qué formato lee y comparte más su audiencia.
  • Seguir un Artículo después de su publicación: Solicite la misma URL a intervalos y registre cómo se acumulan las vistas, las respuestas y las citas en los días posteriores a published_at.
  • Citar anuncios palabra por palabra: Cuando una agencia, una empresa o un fundador publica un anuncio como Artículo, tome pasajes exactos de text y cítelos con url y published_at.

Consejos de expertos para la X Articles API

  • Si duda de qué posts son Artículos, envíelos en un solo lote: solo los Artículos devuelven filas y se cobran, y un lote formado únicamente por posts comunes falla con reembolso completo.
  • Muestre summary en vistas previas y tarjetas y text en la vista de lectura; summary repite las primeras líneas del cuerpo, así que unir ambos imprime ese pasaje dos veces.
  • Guarde cada Artículo bajo id, el ID del post que lo publica, para que al recopilar de nuevo el mismo Artículo se actualicen sus métricas guardadas.
  • Presente metrics.comments_count como la cantidad de respuestas al post del Artículo cuando incluya la interacción de los Artículos en un panel.

Además de la X Articles 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 Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
  • 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.

Explorar otras plataformas

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

X Articles API — FAQ

X Articles API es una interfaz programática para leer los Artículos de X, los posts de formato largo con título e imagen de portada, a partir de las URL de los posts que los publican. Devuelve el título, la vista previa de la línea de tiempo, el texto completo del cuerpo, la URL de la imagen de portada, el autor y los conteos de Me gusta, respuestas, citas y vistas.

Los Artículos de X son posts de formato largo que los suscriptores de Premium pueden publicar en X, con un título, una imagen de portada y un cuerpo con formato. Aparecen en las líneas de tiempo como un post con una vista previa breve, y los lectores los abren para ver el texto completo.

Use el enlace del post que publica el Artículo, con el formato x.com/{username}/status/{post_id}. Puede poner varios enlaces a la vez en urls, y cada Artículo vuelve como una fila propia.

Ese post no devuelve ninguna fila y no tiene costo, mientras que los Artículos de la misma solicitud se devuelven igual. Si ninguna de las URL es un Artículo, la tarea falla y se reembolsa por completo.

La imagen de portada se devuelve en cover_url. Las imágenes colocadas dentro del cuerpo no se incluyen; text contiene solo el contenido escrito.

Sí. text contiene todo el cuerpo como texto plano con una línea en blanco entre párrafos, que puede guardarse como archivo .txt o usarse como párrafos de Markdown, con title agregado arriba como encabezado.