Tumblr BulkPublish

API de Tumblr

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

Consigue una clave de API gratis Lee la referencia de la API

Qué cubre la API de Tumblr

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

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`
Consultar los blogs de Tumblr de un canal	`GET /api/channels/{id}/options`
Leer los comentarios de las publicaciones	`GET /api/posts/{id}/engagement`
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 Tumblr

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

Tipo de publicación	Multimedia
`post` Post	Opcional, hasta 30 imágenes o vídeos

Programa una publicación de Tumblr 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 Tumblr.

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

2. Sube el archivo. La respuesta te da el id del archivo, que se usa como mediaFiles más abajo.

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@photo.jpg"

3. 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": "A look at this week in the studio",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "platformSpecific": {
    "tumblr": {
      "12": {
        "title": "Studio notes",
        "tags": [
          "process",
          "studio"
        ]
      }
    }
  }
}'

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 Tumblr

Envía estas opciones dentro de platformSpecific, bajo la clave de Tumblr.

En Tumblr las opciones se indican por el id de tu canal, por ejemplo "12", o se envían sin anidar para aplicarlas a todos los canales de Tumblr de la publicación.

Opción	Qué hace	Admite
`blogName`	Blog donde se publica	texto
`title`	Título	texto
`tags`	Etiquetas	una lista
`link`	Enlace de destino	texto
`sourceUrl`	Enlace de atribución	texto

Para ver los blogs válidos de un canal, llama a GET /api/channels/{id}/options.

Analíticas de Tumblr con la API

En Tumblr no hay cifras por publicación, así que no hay nada que leer.

Comentarios y mensajes

Con la API puedes leer los comentarios de las publicaciones.

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 Tumblr directamente o usa BulkPublish

BulkPublish mantiene la conexión por ti: renueva los tokens, comprueba cada publicación con las reglas de Tumblr 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.

Lee la documentación oficial

¿Prefieres pedírselo a un asistente?

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

Ver el servidor MCP de Tumblr

¿Prefieres un calendario a código?

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

Ver el programador de Tumblr

Preguntas frecuentes

Dudas habituales sobre la API de Tumblr.

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

Sí. BulkPublish ofrece Tumblr a través de su API REST. Conecta tu cuenta de Tumblr 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 Tumblr con la API?

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

¿Puedo programar publicaciones de Tumblr 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 Tumblr con la API?

No las cifras por publicación. No están disponibles para Tumblr.

¿Puedo leer y responder comentarios o mensajes de Tumblr con la API?

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

¿La API de Tumblr 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 Tumblr o una revisión de la app?

No para usar BulkPublish. Conectas tu cuenta de Tumblr en la página Canales y publicas con una clave de BulkPublish. Si prefieres integrar directamente con la API de Tumblr, 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 Tumblr explica cómo conectar Claude, ChatGPT o Cursor y qué pedirles.

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