Skip to main content
Os endpoints de Articles permitem que os desenvolvedores criem rascunhos de Articles e os publiquem no X de forma programática. Os Articles são publicações de formato longo que oferecem suporte a formatação de texto rico, publicações incorporadas, links e imagens. Esses endpoints exigem autenticação de usuário por meio de OAuth 1.0a ou OAuth 2.0 PKCE com os escopos tweet.read, tweet.write e users.read. Atualmente, a API oferece suporte a dois endpoints:

​
Criar um rascunho de Article

Os desenvolvedores podem criar um novo rascunho de Article usando o endpoint POST https://api.x.com/2/articles/draft. O corpo da requisição contém o título do artigo, o conteúdo do corpo como um estado de conteúdo DraftJS de blocos de texto e entidades, e, opcionalmente, uma mídia de capa enviada pelos endpoints de upload de mídia.

​
Publicar um Article

Quando o rascunho estiver pronto, os desenvolvedores podem torná-lo visível publicamente usando o endpoint POST https://api.x.com/2/articles/{article_id}/publish, em que article_id é o ID retornado quando o rascunho foi criado.

​
Primeiros passos

Para usar os endpoints, você precisa de um token de acesso de usuário. Para obter detalhes sobre como gerá-lo, consulte a documentação do fluxo de Authorization Code do OAuth 2.0 com PKCE. Depois de obter o token de acesso, você pode criar um rascunho de Article como mostrado abaixo: 
curl --request POST 'https://api.x.com/2/articles/draft' \
  --header 'Authorization: Bearer XXXXX' \
  --header 'Content-Type: application/json' \
  --data '{
    "title": "My first Article",
    "content_state": {
      "blocks": [
        {
          "text": "Hello from the Articles API!",
          "type": "unstyled"
        }
      ],
      "entities": []
    }
  }'
Se a requisição for bem-sucedida, você deverá ver a resposta JSON conforme mostrado abaixo: 
{
  "data": {
    "id": "1146654567674912769",
    "title": "My first Article"
  }
}
Em seguida, você pode publicar o rascunho usando o ID do Article retornado: 
curl --request POST 'https://api.x.com/2/articles/1146654567674912769/publish' \
  --header 'Authorization: Bearer XXXXX'
Se a requisição for bem-sucedida, a resposta conterá o ID da publicação criada para o Article publicado: 
{
  "data": {
    "post_id": "1346889436626259968"
  }
}