API de Artigos do X: obtenha o texto completo de um Artigo

#O que é um Artigo do X e por que o post dele guarda só um link

Um Artigo do X (X Articles) é um post longo no X, com título, imagem de capa e um corpo formatado: títulos, negrito e itálico, listas, imagens, vídeo, GIFs, links e posts incorporados. O X liberou os Artigos para assinantes do Premium+ e organizações verificadas em 7 de março de 2024 (abre em uma nova aba).

Para ler ou guardar um Artigo sem escrever código, cole o link dele no Conversor de X para Markdown gratuito: ele devolve título, autor, data e corpo em Markdown, que você pode copiar ou baixar. O restante deste guia lê Artigos via código, um por vez ou aos milhares.

Escrever um Artigo continua sendo um recurso pago. A Central de Ajuda do X (abre em uma nova aba) lista Premium e Premium+, os planos Plus, Premium, Super e Ultra do The X Subscription, e Premium Business e Organizations. Ler é aberto: qualquer pessoa pode ler um Artigo público no x.com, onde ele fica na aba Artigos do autor, a menos que o autor o tenha reservado a assinantes.

Todo Artigo tem dois links, e a diferença entre eles decide se o seu código funciona:

• O post. Ao publicar, o X cria um post comum em x.com/<handle>/status/<post ID>. Ele aparece nas timelines, recebe respostas e curtidas, e o texto dele é apenas um link t.co.
• O Artigo. O corpo fica em x.com/i/article/<Article ID>, com outro número. As APIs consultam o Artigo por meio do post, então guarde o link do post.

#A API oficial do X consegue ler Artigos do X?

Sim: a API oficial do X retorna o texto e as entidades de um Artigo quando a consulta de post pede o campo article, como em GET /2/tweets?ids=<post IDs>&tweet.fields=article. Sem esse campo, o text do post guarda apenas o link t.co.

A equipe do X confirmou o caminho no fórum de desenvolvedores em 8 de setembro de 2026 (abre em uma nova aba): article para Artigos e note_tweet para posts longos de mais de 280 caracteres, tanto em consultas de um ID quanto de vários. A referência do próprio X (abre em uma nova aba) tipa o objeto article sem nomear os subcampos, então confira uma resposta real antes de escrever um parser para ele.

Cada Artigo é cobrado como leitura de post, US$ 0,005, ou seja, US$ 5,00 por 1.000 Artigos na tabela de preços de pagamento por uso do X (abre em uma nova aba). A partir de 22 de novembro de 2026, os objetos que voltam por expansions também são cobrados (aviso do X de 23 de outubro (abre em uma nova aba)): o perfil do autor soma US$ 0,010 e uma imagem de capa, US$ 0,005, então um Artigo com seu autor custa US$ 15,00 por 1.000. Toda leitura exige uma conta de desenvolvedor, créditos pré-pagos e um bearer token, e o pagamento por uso para em 3 milhões de leituras de posts por mês.

Escrever passa por outros dois endpoints. O POST /2/articles/draft (abre em uma nova aba) cria um rascunho a partir de um título e de um corpo em DraftJS, e o POST /2/articles/{article_id}/publish o publica; os dois exigem o token de usuário OAuth do autor.

#Obtenha o texto completo de um Artigo do X com a Sorsa API

Para ler Artigos do X via código, use a Sorsa API, uma API e scraper do Twitter (X): o POST /article recebe o link ou o ID do post e retorna o texto completo, a prévia, a imagem de capa, a data de publicação, curtidas, reposts, respostas, quotes, itens salvos, visualizações e o perfil completo do autor em uma requisição. Cada Artigo é uma requisição, a partir de US$ 1,40 por 1.000, a 20 requisições por segundo em todos os planos, com uma chave de API e sem conta de desenvolvedor.

1. Obtenha uma chave. Cadastre-se e copie a chave de API no seu painel. As 100 requisições grátis leem 100 Artigos, seja qual for o tamanho deles.

2. Copie o link do post. Pegue o x.com/<handle>/status/<ID> do post que compartilha o Artigo, ou só o ID. Não sabe qual link você tem? Cole aqui:

   Cole um link do X ou um ID

   Link de post Link de Article

   Link de post: envie este para o POST /article.

   ID do post

   2112908047021486497

   Postado, lido a partir do ID

   Oct 21, 2026, 14:05:09 UTC

   Corpo da requisição para POST /article Copiar curl

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

   Links de post vão para o POST /article como estão; um link x.com/i/article/ contém o ID do próprio Article, que o endpoint não aceita.

3. Envie a requisição. Faça um POST com o link do post ou o ID dele como tweet_link para o POST /article (abre em uma nova aba), com a sua chave no header 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. Leia a resposta. O corpo está em full_text, os contadores ficam ao lado dele, e author é o mesmo perfil completo que os endpoints de usuários retornam.

   {
     "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 resposta completa

A mesma chamada em Python e Node.js, pronta para um loop sobre vários links:

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);

Um 404 costuma indicar que o post não compartilha um Artigo: leia-o com o POST /tweet-info. Um 403 significa que a chave está ausente, errada ou sem requisições, e um 429 indica mais de 20 requisições em um segundo, então espere um segundo e tente de novo. Requisições com falha nunca são cobradas.

#O que a resposta de /article contém

A resposta do POST /article tem onze campos: o corpo duas vezes (inteiro e só o início), a capa, o horário de publicação, seis contadores e o autor. Cada um abaixo vem da referência ao vivo da API.

• full_text

  O que ele guarda

  O corpo inteiro em texto simples, não importa o tamanho

• preview_text

  O que ele guarda

  As primeiras linhas que o X mostra antes de "Ler mais"

• cover_image_url

  O que ele guarda

  Link da imagem de capa, nulo quando o autor não definiu nenhuma

• published_at

  O que ele guarda

  Quando o Artigo foi ao ar, em ISO 8601

• views_count

  O que ele guarda

  Visualizações (impressões)

• likes_count, retweet_count, reply_count, quote_count, bookmark_count

  O que ele guarda

  Curtidas, reposts, respostas, quotes e itens salvos

• author

  O que ele guarda

  O perfil completo do autor: ID, handle, nome, bio, seguidores, seguindo, número de posts, data de entrada, verificação

Os contadores refletem o momento da requisição, então uma segunda chamada uma semana depois mostra como o Artigo continuou se espalhando. Para ler as respostas de um Artigo, veja como ver comentários no X: elas ficam no post que o compartilha, como em qualquer outro.

Bom saber

As visualizações voltam como views_count em um Artigo e como view_count em um tweet. Se Artigos e tweets forem para a mesma tabela, renomeie essa chave ao carregar os dados, ou uma das duas colunas ficará vazia.

#Encontre todos os Artigos que uma conta publicou

Para listar os Artigos de uma conta, busque nos posts dela links para x.com/i/article com o operador url: do X e depois leia cada resultado com o POST /article. A busca é o POST /search-tweets (abre em uma nova aba): cerca de 20 posts por requisição, e o next_cursor aponta para a página seguinte até voltar vazio.

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"])

Acrescente since:2026-01-01 ou min_faves:100 à busca para manter só Artigos recentes ou populares; a lista completa está no nosso guia de operadores de busca do Twitter. Troque o from: por uma palavra-chave e a mesma busca encontra Artigos de qualquer pessoa sobre aquele assunto. Um resultado também pode ser a conta compartilhando o Artigo de outra pessoa: compare o author.username de cada resposta do POST /article com o handle para ficar só com os Artigos dela.

#Salve um Artigo do X em Markdown

Para um único Artigo, o conversor linkado no início deste guia é o caminho mais rápido. Para um lote, grave cada resposta do POST /article em um arquivo Markdown próprio, com os dados que importam em um cabeçalho:

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

O Markdown abre em qualquer editor, imprime com limpeza e vai direto para o ChatGPT, o Claude ou um índice de busca, para resumos, notas de pesquisa ou um dataset para um modelo de linguagem. As imagens continuam como links para os servidores do X, então baixe a capa se precisar de uma cópia permanente.

Cada arquivo leva o ID do post no nome, então rodar o job de novo atualiza o arquivo em vez de criar uma cópia. O cabeçalho mantém o link da fonte, o autor e os contadores junto do texto, que é o que você precisa para citar um Artigo ou comparar dois deles depois. Para imprimir um Artigo, abra o arquivo em qualquer editor de Markdown e imprima de lá: o layout continua simples e legível no papel.

#Quanto custa ler Artigos do X por 1.000

A Sorsa API lê 1.000 Artigos do X a partir de US$ 1,40 com o perfil do autor na mesma resposta; a API oficial do X cobra US$ 5,00 só pelos posts e US$ 15,00 com os perfis dos autores a partir de 22 de novembro de 2026.

Na Sorsa API, um Artigo custa uma requisição, seja qual for o tamanho dele, então um ensaio de 6.000 palavras e uma nota de 500 palavras custam o mesmo. A 20 requisições por segundo em uma chave, o tempo cresce na mesma proporção da quantidade:

• 1 mil

  Sorsa API, a partir de

  US$ 1,40

  API oficial do X, só posts

  US$ 5,00

  API oficial do X, com autor (a partir de 22 de nov. de 2026)

  US$ 15,00

  Tempo na Sorsa API a 20 requisições por segundo

  cerca de 1 minuto

• 10 mil

  Sorsa API, a partir de

  US$ 14

  API oficial do X, só posts

  US$ 50

  API oficial do X, com autor (a partir de 22 de nov. de 2026)

  US$ 150

  Tempo na Sorsa API a 20 requisições por segundo

  cerca de 8 minutos

• 100 mil

  Sorsa API, a partir de

  US$ 140

  API oficial do X, só posts

  US$ 500

  API oficial do X, com autor (a partir de 22 de nov. de 2026)

  US$ 1.500

  Tempo na Sorsa API a 20 requisições por segundo

  cerca de 1,4 hora

• 1 milhão

  Sorsa API, a partir de

  US$ 1.400

  API oficial do X, só posts

  US$ 5.000

  API oficial do X, com autor (a partir de 22 de nov. de 2026)

  US$ 15.000

  Tempo na Sorsa API a 20 requisições por segundo

  cerca de 14 horas

Encontrar os Artigos soma requisições de busca: uma por página de cerca de 20 posts. Puxar os Artigos de uma conta uma vez por semana custa poucas requisições por conta, e as análises em torno deles estão no guia da API de analytics do Twitter.

#Leia seus primeiros Artigos do X hoje

Escolha um Artigo, copie o link do post que o compartilha e envie ao POST /article: o texto, os contadores e o autor voltam como um único objeto JSON. A Sorsa API lê Artigos do X a partir de US$ 1,40 por 1.000 com o autor incluído, a 20 requisições por segundo, sem conta de desenvolvedor e sem risco para a sua própria conta do X, e as suas 100 requisições grátis cobrem os primeiros 100 Artigos.

#FAQ