Skip to main content
Los endpoints de Articles permiten a los desarrolladores crear borradores de Articles y publicarlos en X de forma programática. Los Articles son publicaciones de formato largo que admiten formato de texto enriquecido, publicaciones incrustadas, enlaces e imágenes. Estos endpoints requieren autenticación de usuario mediante OAuth 1.0a u OAuth 2.0 PKCE con los scopes tweet.read, tweet.write y users.read. Actualmente, la API admite dos endpoints:

​
Crear un borrador de Article

Los desarrolladores pueden crear un nuevo borrador de Article usando el endpoint POST https://api.x.com/2/articles/draft. El cuerpo de la solicitud contiene el título del artículo, el contenido del cuerpo como un estado de contenido DraftJS de bloques de texto y entidades, y, opcionalmente, una imagen de portada cargada mediante los endpoints de subida de medios.

​
Publicar un Article

Una vez que el borrador esté listo, los desarrolladores pueden hacerlo visible públicamente usando el endpoint POST https://api.x.com/2/articles/{article_id}/publish, donde article_id es el ID devuelto cuando se creó el borrador.

​
Primeros pasos

Para usar los endpoints, necesitas un token de acceso de usuario. Para obtener más detalles sobre cómo generarlo, consulta la documentación del flujo de código de autorización OAuth 2.0 con PKCE. Una vez que tengas el token de acceso, puedes crear un borrador de Article como se muestra a continuación: 
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": []
    }
  }'
Si la solicitud se realiza correctamente, deberías ver la respuesta JSON que se muestra a continuación: 
{
  "data": {
    "id": "1146654567674912769",
    "title": "My first Article"
  }
}
Después puedes publicar el borrador usando el ID de Article devuelto: 
curl --request POST 'https://api.x.com/2/articles/1146654567674912769/publish' \
  --header 'Authorization: Bearer XXXXX'
Si la solicitud se realiza correctamente, la respuesta contiene el ID de la publicación creada para el Article publicado: 
{
  "data": {
    "post_id": "1346889436626259968"
  }
}