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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Una 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.
- Envíe {"urls": ["https://x.com/USDOL/status/2119796255089947070"]} por POST a /v1/x/article.
- Consulte GET /v1/tasks/{task_id} hasta que el estado de la tarea sea succeeded.
- 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.
APIs relacionadas
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.
- 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
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API