Tumblr BulkPublish

API do Tumblr

Publique, agende e gerencie o Tumblr a partir do seu próprio código. Uma API REST e uma chave cobrem o Tumblr e todas as outras redes que você conectar, então você escreve a integração uma vez só.

Obter uma chave de API grátis Ler a referência da API

O que a API do Tumblr cobre

Tudo abaixo faz parte da API publicada e já funciona com o Tumblr.

Recurso	Endpoint
Criar, agendar, editar e publicar posts	`POST /api/posts`
Enviar imagens e vídeos	`POST /api/media`
Encontrar o próximo horário livre da sua fila	`GET /api/posts/queue-slot`
Criar agendamentos recorrentes	`POST /api/schedules`
Publicar novos itens de um feed RSS	`POST /api/rss-feeds`
Consultar blogs do Tumblr de um canal	`GET /api/channels/{id}/options`
Ler comentários de posts publicados	`GET /api/posts/{id}/engagement`
Verificar se a conexão está saudável	`GET /api/channels/{id}/health`
Consultar o uso do seu plano	`GET /api/quotas/usage`

Tipos de post que você pode publicar no Tumblr

Escolha o tipo com postTypeOverrides. Um tipo que o Tumblr não oferece é recusado antes de qualquer coisa entrar na fila.

Tipo de publicação	Mídia
`post` Post	Opcional, até 30 imagens ou vídeos

Agende um post do Tumblr com curl

Três requisições: encontre seu canal, envie o arquivo se o post tiver um e crie o post. Troque a chave por uma de Configurações, depois Chaves de API, e o 12 pelo id do seu próprio canal.

1. Liste seus canais e anote o id da sua conta do Tumblr.

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

2. Envie o arquivo. A resposta traz o id da mídia, usado como mediaFiles abaixo.

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

3. Crie o post.

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"
        ]
      }
    }
  }
}'

A resposta é o post criado, com seu id e status. Busque-o depois com GET /api/posts/{id} para ver como foi.

Opções do Tumblr

Envie estas opções dentro de platformSpecific, na chave do Tumblr.

No Tumblr, as opções são indexadas pelo id do seu canal, por exemplo "12", ou enviadas soltas para valer para todos os canais do Tumblr no post.

Opção	O que faz	Aceita
`blogName`	Em qual blog publicar	texto
`title`	Título	texto
`tags`	Tags	uma lista
`link`	Link de destino	texto
`sourceUrl`	Link de atribuição	texto

Para descobrir blogs válidos de um canal, chame GET /api/channels/{id}/options.

Análises do Tumblr pela API

Os números por post não estão disponíveis para o Tumblr, então não há nada para ler.

Comentários e mensagens

Pela API você pode ler comentários de posts publicados.

Ler comentários funciona em todos os planos. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business. Enquanto um recurso não estiver ativado na sua conta, a API responde 403 com um código que você pode verificar.

Acesso à API em todos os planos

Todos os planos incluem chaves de API, inclusive o Free. Veja o que cada um permite.

Plano	Chaves de API	Requisições por dia
Free	1	30
Pro	5	5.000
Business	10	50.000

Construir direto no Tumblr ou usar o BulkPublish

O BulkPublish cuida da conexão por você: renova os tokens, confere cada post com as regras do Tumblr antes de entrar na fila e informa no post qual destino falhou, então seu código faz uma única requisição.

Ler a documentação oficial

Prefere pedir a um assistente?

Claude, ChatGPT e Cursor fazem o mesmo pelo servidor MCP do Tumblr, com comandos em vez de código.

Ver o servidor MCP do Tumblr

Prefere um calendário a código?

A mesma conta do Tumblr pode ser agendada pelo app, com calendário de conteúdo e envio em massa.

Ver o agendador do Tumblr

Perguntas frequentes

Dúvidas comuns sobre a API do Tumblr.

Existe uma API do Tumblr que eu possa usar sem construir a integração sozinho?

Sim. O BulkPublish oferece o Tumblr por meio da sua API REST. Conecte sua conta do Tumblr uma vez e depois publique, agende e gerencie com uma chave. A mesma chave funciona em todas as outras redes que você conectar.

O que posso publicar no Tumblr pela API?

Os tipos de post são Post. Cada um é conferido com as regras de mídia do Tumblr antes de entrar na fila, então uma requisição que o Tumblr recusaria falha na hora, com um erro claro.

Posso agendar posts do Tumblr pela API?

Sim. Envie o status "scheduled" com um horário em scheduledAt e um timezone, ou peça antes o próximo horário livre da sua fila. Agendamentos recorrentes e feeds RSS também estão disponíveis.

Posso ler as análises do Tumblr pela API?

Números por post não. Eles não estão disponíveis para o Tumblr.

Posso ler e responder comentários ou mensagens do Tumblr pela API?

Sim. Você pode ler comentários de posts publicados. Responder comentários exige um plano pago, e a caixa de entrada faz parte do Pro e do Business.

A API do Tumblr custa algo a mais?

Não. O acesso à API está em todos os planos. O Free inclui 1 chave e 30 requisições por dia, o Pro 5 chaves e 5.000 por dia, o Business 10 chaves e 50.000 por dia.

Preciso de uma conta de desenvolvedor do Tumblr ou de uma revisão de app?

Não para usar o BulkPublish. Você conecta sua conta do Tumblr na página Canais e publica com uma chave do BulkPublish. Se preferir construir direto na API do Tumblr, a seção acima lista o que ela exige de você.

Um assistente de IA também consegue fazer isso?

Sim. A página do servidor MCP do Tumblr mostra como conectar Claude, ChatGPT ou Cursor e o que pedir.

A mesma chave e o mesmo formato de requisição funcionam em 15 redes.