API de Artículos de X: obtén el texto completo de un Artículo

#Qué es un Artículo de X y por qué su post solo contiene un enlace

Un Artículo de X es un post de formato largo con título, imagen de portada y un cuerpo con formato: encabezados, negritas y cursivas, listas, imágenes, video, GIF, enlaces y posts incrustados. X activó los Artículos para los suscriptores de Premium+ y las organizaciones verificadas el 7 de marzo de 2024 (se abre en una pestaña nueva).

Para leer o guardar un solo Artículo sin escribir código, pega su enlace en el Conversor de X a Markdown gratuito: devuelve el título, el autor, la fecha y el cuerpo como Markdown que puedes copiar o descargar. El resto de esta guía lee Artículos desde código, de uno en uno o por miles.

Escribir uno sigue siendo una función de pago. El Centro de ayuda de X (se abre en una pestaña nueva) menciona Premium y Premium+, los planes Plus, Premium, Super y Ultra de The X Subscription, y Premium Business y Organizaciones. Leer es abierto: cualquiera puede leer un Artículo público en x.com, donde aparece en la pestaña Artículos del autor, salvo que el autor lo haya reservado para sus suscriptores.

Cada Artículo tiene dos enlaces, y la diferencia decide si tu código funciona:

• El post. Al publicar se crea un post normal en x.com/<handle>/status/<ID del post>. Aparece en las cronologías, recibe respuestas y me gusta, y su texto es solo un enlace t.co.
• El Artículo. El cuerpo vive en x.com/i/article/<ID del Artículo>, bajo otro número. Las API buscan el Artículo a través del post, así que conserva el enlace del post.

#¿Puede la API oficial de X leer Artículos de X?

Sí: la API oficial de X devuelve el texto y las entidades de un Artículo cuando la consulta del post pide el campo article, como en GET /2/tweets?ids=<IDs de posts>&tweet.fields=article. Sin ese campo, el text del post contiene solo el enlace t.co.

Personal de X confirmó esta ruta en el foro de desarrolladores el 8 de septiembre de 2026 (se abre en una pestaña nueva): article para los Artículos y note_tweet para los posts largos de más de 280 caracteres, tanto en consultas de un ID como de varios. La referencia de X (se abre en una pestaña nueva) describe el objeto article sin nombrar sus subcampos, así que revisa una respuesta real antes de escribir un parser para él.

Cada Artículo se cobra como una lectura de post, $0.005, es decir $5.00 por 1,000 Artículos en la tarifa de pago por uso de X (se abre en una pestaña nueva). A partir del 22 de noviembre de 2026 también se cobran los objetos que llegan por expansiones (aviso de X del 23 de octubre (se abre en una pestaña nueva)): el perfil del autor suma $0.010 y una imagen de portada $0.005, de modo que un Artículo con su autor cuesta $15.00 por 1,000. Cada lectura requiere una cuenta de desarrollador, créditos prepagados y un bearer token, y el pago por uso se detiene en 3 millones de lecturas de posts al mes.

Escribir pasa por otros dos endpoints. POST /2/articles/draft (se abre en una pestaña nueva) crea un borrador a partir de un título y un cuerpo en DraftJS, y POST /2/articles/{article_id}/publish lo publica; ambos requieren el token de usuario OAuth del autor.

#Obtén el texto completo de un Artículo de X con Sorsa API

Para leer Artículos de X desde código, usa Sorsa API, una API y scraper de Twitter (X): POST /article recibe el enlace o el ID del post y devuelve en una sola solicitud el texto completo, la vista previa, la imagen de portada, la fecha de publicación, los me gusta, reposts, respuestas, citas, marcadores, vistas y el perfil completo del autor. Cada Artículo es una solicitud, desde $1.40 por 1,000, a 20 solicitudes por segundo en todos los planes, con una sola clave API y sin cuenta de desarrollador.

1. Consigue una clave. Crea una cuenta y copia la clave API de tu panel. Las 100 solicitudes gratis leen 100 Artículos, sin importar su extensión.

2. Copia el enlace del post. Toma x.com/<handle>/status/<ID> del post que comparte el Artículo, o solo el ID. ¿No sabes qué enlace tienes? Pégalo aquí:

   Pega un enlace de X o un ID

   Enlace de post Enlace de Artículo

   Enlace de post: envía este a POST /article.

   ID del post

   2112908047021486497

   Publicado, leído del ID

   oct 21, 2026, 14:05:09 UTC

   Cuerpo de la solicitud para POST /article Copiar curl

   {"tweet_link": "https://x.com/harbor_essays_weekly/status/2112908047021486497"}

   Los enlaces de post van a POST /article tal cual; un enlace x.com/i/article/ contiene el ID propio del Artículo, que el endpoint no admite.

3. Envía la solicitud. Haz POST del enlace del post o de su ID como tweet_link a POST /article (se abre en una pestaña nueva), con tu clave en el encabezado ApiKey.

   curl -X POST "https://api.sorsa.io/v3/article" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"tweet_link": "2112908047021486497"}'
   

4. Lee la respuesta. El cuerpo está en full_text, los contadores van a su lado y author es el mismo perfil completo que devuelven los endpoints de usuarios.

   {
     "full_text": "Seven years ago we met in a laundromat...",
     "preview_text": "Seven years ago we met in a laundromat",
     "cover_image_url": "https://pbs.twimg.com/media/HbX2k9WaYAAq3Lm.jpg",
     "published_at": "2026-10-21T14:05:09Z",
     "views_count": 88214,
     "likes_count": 3207,
     "retweet_count": 410,
     "reply_count": 96,
     "quote_count": 58,
     "bookmark_count": 1120,
     "author": {
       "id": "1116267827557806085",
       "username": "harbor_essays_weekly",
       "display_name": "Harbor Essays",
       "description": "Long reads about small clubs and libraries.",
       "followers_count": 48210,
       "followings_count": 312,
       "tweets_count": 2875,
       "created_at": "2019-04-11T09:12:44Z",
       "verified": true,
       "protected": false
     }
   }
   

   Ver respuesta completa

La misma llamada en Python y Node.js, lista para usarse en un ciclo sobre muchos enlaces:

import requests

API = "https://api.sorsa.io/v3"
HEADERS = {"ApiKey": "YOUR_API_KEY"}


def get_article(link):
    r = requests.post(f"{API}/article", headers=HEADERS,
                      json={"tweet_link": link}, timeout=30)
    if r.status_code == 404:
        return None  # the post doesn't share an Article
    r.raise_for_status()
    return r.json()


art = get_article(
    "https://x.com/harbor_essays_weekly/status/2112908047021486497")
words = len(art["full_text"].split())
print(art["author"]["username"], art["published_at"])
print(f"{words:,} words, {art['views_count']:,} views")

const API = "https://api.sorsa.io/v3";

async function getArticle(link) {
  const r = await fetch(`${API}/article`, {
    method: "POST",
    headers: {
      ApiKey: "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ tweet_link: link }),
  });
  if (r.status === 404) return null; // not an Article
  if (!r.ok) throw new Error(`HTTP ${r.status}`);
  return r.json();
}

const art = await getArticle(
  "https://x.com/harbor_essays_weekly/status/2112908047021486497");
console.log(art.author.username, art.views_count);

Un 404 suele significar que el post no comparte un Artículo: léelo con POST /tweet-info. Un 403 significa que la clave falta, es incorrecta o ya no tiene solicitudes, y un 429 significa que enviaste más de 20 solicitudes en un segundo, así que espera un segundo y vuelve a intentarlo. Las solicitudes fallidas nunca se cobran.

#Qué contiene la respuesta de /article

La respuesta de POST /article tiene once campos: el cuerpo dos veces (completo y solo su inicio), la portada, la hora de publicación, seis contadores y el autor. Cada uno de los campos de abajo viene de la referencia de la API en vivo.

• full_text

  Qué contiene

  El cuerpo completo como texto plano, sin importar su extensión

• preview_text

  Qué contiene

  Las primeras líneas que X muestra antes de "Leer más"

• cover_image_url

  Qué contiene

  Enlace a la imagen de portada, null si el autor no puso ninguna

• published_at

  Qué contiene

  Cuándo se publicó el Artículo, en ISO 8601

• views_count

  Qué contiene

  Visualizaciones (impresiones)

• likes_count, retweet_count, reply_count, quote_count, bookmark_count

  Qué contiene

  Me gusta, reposts, respuestas, citas y marcadores

• author

  Qué contiene

  El perfil completo del autor: ID, nombre de usuario, nombre, biografía, seguidores, seguidos, cantidad de posts, fecha de alta y verificación

Los contadores están al día en el momento de la solicitud, así que una segunda llamada una semana después muestra cómo siguió difundiéndose el Artículo. Para leer las respuestas bajo un Artículo, consulta cómo ver los comentarios en X: cuelgan del post que lo comparte, como las de cualquier otro post.

Para tener en cuenta

Las vistas llegan como views_count en un Artículo y como view_count en un tweet. Si los Artículos y los tweets terminan en una misma tabla, renombra esa clave al cargar los datos, o una de las dos columnas se quedará vacía.

#Encuentra todos los Artículos que publicó una cuenta

Para listar los Artículos de una cuenta, busca entre sus posts los enlaces a x.com/i/article con el operador url: de X y luego lee cada resultado con POST /article. La búsqueda es POST /search-tweets (se abre en una pestaña nueva): unos 20 posts por solicitud, y next_cursor apunta a la página siguiente hasta que llega vacío.

import requests

API = "https://api.sorsa.io/v3"
HEADERS = {"ApiKey": "YOUR_API_KEY"}


def article_posts(handle):
    query = f"from:{handle} url:x.com/i/article"
    body = {"query": query, "order": "latest"}
    while True:
        r = requests.post(f"{API}/search-tweets", headers=HEADERS,
                          json=body, timeout=30)
        r.raise_for_status()
        page = r.json()
        for tweet in page.get("tweets", []):
            yield tweet["id"]
        if not page.get("next_cursor"):
            break
        body["next_cursor"] = page["next_cursor"]


for post_id in article_posts("harbor_essays_weekly"):
    r = requests.post(f"{API}/article", headers=HEADERS,
                      json={"tweet_link": post_id}, timeout=30)
    if r.ok:
        print(post_id, r.json()["views_count"])

Agrega since:2026-01-01 o min_faves:100 a la consulta para quedarte solo con los Artículos recientes o populares; la lista completa está en nuestra guía de operadores de búsqueda de Twitter. Cambia from: por una palabra clave y la misma consulta encuentra Artículos de cualquiera sobre ese tema. Un resultado también puede ser la cuenta compartiendo el Artículo de otra persona: compara author.username en cada respuesta de POST /article con el nombre de usuario para quedarte solo con los propios.

#Guarda un Artículo de X como Markdown

Para un solo Artículo, el conversor enlazado al inicio de esta guía es la vía más rápida. Para un lote, escribe cada respuesta de POST /article en su propio archivo Markdown, con los datos importantes en un encabezado:

from pathlib import Path


def save_markdown(art, post_link, folder="articles"):
    a = art["author"]
    head = [
        f"# @{a['username']}, {art['published_at'][:10]}",
        "",
        f"Source: {post_link}",
        f"Author: {a['display_name']} ({a['followers_count']:,} followers)",
        f"Views: {art['views_count']:,}  Likes: {art['likes_count']:,}",
        "",
    ]
    if art.get("cover_image_url"):
        head += [f"![cover]({art['cover_image_url']})", ""]
    path = Path(folder) / f"{post_link.rstrip('/').split('/')[-1]}.md"
    path.parent.mkdir(exist_ok=True)
    path.write_text("\n".join(head) + art["full_text"] + "\n",
                    encoding="utf-8")
    return path

Markdown se abre en cualquier editor, se imprime limpio y pasa directo a ChatGPT, Claude o un índice de búsqueda, para resúmenes, notas de investigación o un dataset para un modelo de lenguaje. Las imágenes siguen siendo enlaces a los servidores de X, así que descarga la portada si necesitas una copia permanente.

Cada archivo lleva el ID del post como nombre, de modo que si vuelves a ejecutar el proceso se actualiza el archivo en lugar de crear una copia. El encabezado conserva el enlace de origen, el autor y los contadores junto al texto, que es lo que necesitas para citar un Artículo o comparar dos más adelante. Para imprimir un Artículo, abre su archivo en cualquier editor de Markdown e imprime desde ahí: el formato es simple y se lee bien en papel.

#Cuánto cuesta leer Artículos de X por cada 1,000

Sorsa API lee 1,000 Artículos de X desde $1.40 con el perfil del autor en la misma respuesta; la API oficial de X cobra $5.00 solo por los posts y $15.00 con los perfiles de los autores a partir del 22 de noviembre de 2026.

En Sorsa API un Artículo cuesta una solicitud sin importar su extensión, así que un ensayo de 6,000 palabras y una nota de 500 cuestan lo mismo. A 20 solicitudes por segundo con una sola clave, el tiempo crece en proporción a la cantidad:

• 1K

  Sorsa API, desde

  $1.40

  API oficial de X, solo posts

  $5.00

  API oficial de X, con autor (desde el 22 de nov de 2026)

  $15.00

  Tiempo en Sorsa API a 20 solicitudes por segundo

  cerca de 1 minuto

• 10K

  Sorsa API, desde

  $14

  API oficial de X, solo posts

  $50

  API oficial de X, con autor (desde el 22 de nov de 2026)

  $150

  Tiempo en Sorsa API a 20 solicitudes por segundo

  cerca de 8 minutos

• 100K

  Sorsa API, desde

  $140

  API oficial de X, solo posts

  $500

  API oficial de X, con autor (desde el 22 de nov de 2026)

  $1,500

  Tiempo en Sorsa API a 20 solicitudes por segundo

  cerca de 1.4 horas

• 1M

  Sorsa API, desde

  $1,400

  API oficial de X, solo posts

  $5,000

  API oficial de X, con autor (desde el 22 de nov de 2026)

  $15,000

  Tiempo en Sorsa API a 20 solicitudes por segundo

  cerca de 14 horas

Encontrar los Artículos suma solicitudes de búsqueda: una por página de unos 20 posts. Traer los Artículos de una cuenta una vez por semana cuesta unas pocas solicitudes por cuenta, y la analítica que los rodea se explica en la guía de la API de analítica de Twitter.

#Lee hoy tus primeros Artículos de X

Elige un Artículo, copia el enlace del post que lo comparte y envíalo a POST /article: el texto, los contadores y el autor llegan como un solo objeto JSON. Sorsa API lee Artículos de X desde $1.40 por 1,000 con el autor incluido, a 20 solicitudes por segundo, sin cuenta de desarrollador y sin riesgo para tu propia cuenta de X, y tus 100 solicitudes gratis cubren los primeros 100 Artículos.

#Preguntas frecuentes