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.
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ón | Endpoint |
|---|---|
| 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ón | Multimedia |
|---|---|
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ón | Qué hace | Admite |
|---|---|---|
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.
| Plan | Claves de API | Solicitudes 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.
Ver el servidor MCP de X / Twitter
¿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.
Ver el programador de X / Twitter
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.
Otras redes
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.