X / Twitter BulkPublish

API de X / Twitter

Publica, programa y gestiona X / Twitter desde tu propio código. Una API REST y una clave cubren X / Twitter y cualquier otra red que conectes, así que la integración se escribe una sola vez.

Integración de X / Twitter con BulkPublish

Qué cubre la API de X / Twitter

Todo lo que aparece abajo forma parte de la API publicada y funciona hoy con X / Twitter.

FunciónEndpoint
Crear, programar, actualizar y publicar publicaciones POST /api/posts
Subir imágenes y vídeo POST /api/media
Encontrar el siguiente hueco libre de tu cola GET /api/posts/queue-slot
Crear programaciones recurrentes POST /api/schedules
Publicar las novedades de un feed RSS POST /api/rss-feeds
Publicar un primer comentario automáticamente platformSpecific._firstComment
Publicar hilos de varias partes postFormat: "thread"
Leer las métricas de cada publicación GET /api/posts/{id}/metrics
Leer y responder los comentarios de las publicaciones GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply
Leer y responder mensajes directos GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages
Comprobar que la conexión funciona bien GET /api/channels/{id}/health
Consultar el uso de tu plan GET /api/quotas/usage

Tipos de publicación que puedes enviar a X / Twitter

Elige el tipo con postTypeOverrides. Un tipo que X / Twitter no ofrece se rechaza antes de poner nada en cola.

Tipo de publicaciónMultimedia
tweet Tweet Opcional, hasta 4 imágenes o vídeos

Programa una publicación de X / Twitter con curl

Tres solicitudes: busca tu canal, sube el archivo si la publicación lo lleva y crea la publicación. Sustituye la clave por una de Ajustes, luego Claves de API, y 12 por el id de tu propio canal.

1. Lista tus canales y anota el id de tu cuenta de X / Twitter.

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. Crea la publicación.

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Shipping a new release today",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "platformSpecific": {
    "x": {
      "replySettings": "following"
    }
  }
}'

La respuesta es la publicación creada, con su id y su estado. Consúltala más tarde con GET /api/posts/{id} para ver cómo fue.

Opciones de X / Twitter

Envía estas opciones dentro de platformSpecific, bajo la clave de X / Twitter.

OpciónQué haceAdmite
replySettings Quién puede responder everyonefollowingverifiedsubscribersmentionedUsers

Analíticas de X / Twitter con la API

Estas métricas se devuelven para cada publicación de X / Twitter en GET /api/posts/{id}/metrics, con instantáneas a lo largo del tiempo.

  • Impresiones
  • Me gusta
  • Comentarios
  • Compartidos
  • Guardados
  • Tasa de interacción

Comentarios y mensajes

Con la API puedes leer y responder los comentarios de las publicaciones y leer y responder mensajes directos.

Leer comentarios funciona en todos los planes. Responder a comentarios requiere un plan de pago, y la bandeja de entrada forma parte de Pro y Business. Mientras una función no esté activada en tu cuenta, la API responde 403 con un código que puedes comprobar.

Acceso a la API en todos los planes

Todos los planes incluyen claves de API, también el plan Free. Esto es lo que permite cada uno.

PlanClaves de APISolicitudes al día
Free 1 30
Pro 5 5000
Business 10 50.000

Integra X / Twitter directamente o usa BulkPublish

Ir directo es una opción razonable, sobre todo si necesitas algo que BulkPublish no ofrece. Esto es lo que te pide X API, según su documentación consultada en octubre de 2026.

  • Antes de publicar tienes que registrar una app de desarrollador en X / Twitter.
  • El uso se factura por solicitud.
  • Los tokens de acceso duran poco, así que el paso de renovación lo programas tú.
  • Los vídeos grandes se suben por partes, y esa subida la tienes que implementar tú.

BulkPublish mantiene la conexión por ti: renueva los tokens, comprueba cada publicación con las reglas de X / Twitter antes de ponerla en cola e informa de un destino fallido en la propia publicación, así que tu código hace una sola solicitud.

¿Prefieres pedírselo a un asistente?

Claude, ChatGPT y Cursor pueden hacer lo mismo con el servidor MCP de X / Twitter, con instrucciones en lugar de código.

¿Prefieres un calendario a código?

La misma cuenta de X / Twitter se puede programar desde la app, con un calendario de contenido y subida en masa.

Preguntas frecuentes

Dudas habituales sobre la API de X / Twitter.

¿Hay una API de X / Twitter que pueda usar sin construir yo la integración?

Sí. BulkPublish ofrece X / Twitter a través de su API REST. Conecta tu cuenta de X / Twitter una vez y luego publica, programa y gestiónala con una clave. La misma clave sirve para cualquier otra red que conectes.

¿Qué puedo publicar en X / Twitter con la API?

Los tipos de publicación son Tweet. Cada uno se comprueba con las reglas de archivos de X / Twitter antes de ponerlo en cola, así que una solicitud que X / Twitter rechazaría falla al instante con un error claro.

¿Puedo programar publicaciones de X / Twitter con la API?

Sí. Envía el estado "scheduled" con una hora en scheduledAt y un timezone, o pide antes el siguiente hueco libre de tu cola. También hay programaciones recurrentes y feeds RSS.

¿Puedo leer las analíticas de X / Twitter con la API?

Sí. Las métricas por publicación incluyen Impresiones, Me gusta, Comentarios, Compartidos, Guardados y Tasa de interacción, con instantáneas a lo largo del tiempo.

¿Puedo leer y responder comentarios o mensajes de X / Twitter con la API?

Sí. Puedes leer y responder los comentarios de las publicaciones y leer y responder mensajes directos. Responder a comentarios requiere un plan de pago, y la bandeja de entrada forma parte de Pro y Business.

¿La API de X / Twitter cuesta algo extra?

No. El acceso a la API está en todos los planes. Free incluye 1 clave y 30 solicitudes al día, Pro 5 claves y 5000 al día, Business 10 claves y 50.000 al día.

¿Necesito una cuenta de desarrollador de X / Twitter o una revisión de la app?

No para usar BulkPublish. Conectas tu cuenta de X / Twitter en la página Canales y publicas con una clave de BulkPublish. Si prefieres integrar directamente con la API de X / Twitter, la sección anterior enumera lo que te pide.

¿Un asistente de IA también puede hacerlo?

Sí. La página del servidor MCP de X / Twitter explica cómo conectar Claude, ChatGPT o Cursor y qué pedirles.

La misma clave y el mismo formato de solicitud sirven para 15 redes.

Empieza a publicar en X / Twitter desde código

Crea una cuenta gratis, conecta X / Twitter y genera una clave. Sin tarjeta.