Tumblr BulkPublish

Tumblr API

Veröffentliche, plane und verwalte Tumblr aus deinem eigenen Code. Eine REST-API und ein Schlüssel decken Tumblr und jedes andere verbundene Netzwerk ab, du schreibst die Integration also nur einmal.

Kostenlosen API-Schlüssel holen API-Referenz lesen

Was die Tumblr API abdeckt

Alles unten gehört zur veröffentlichten API und funktioniert heute mit Tumblr.

Funktion	Endpunkt
Beiträge erstellen, planen, bearbeiten und veröffentlichen	`POST /api/posts`
Bilder und Videos hochladen	`POST /api/media`
Den nächsten freien Slot in deiner Warteschlange finden	`GET /api/posts/queue-slot`
Wiederkehrende Pläne anlegen	`POST /api/schedules`
Neue Einträge aus einem RSS-Feed veröffentlichen	`POST /api/rss-feeds`
Tumblr Blogs für einen Kanal abrufen	`GET /api/channels/{id}/options`
Kommentare unter veröffentlichten Beiträgen lesen	`GET /api/posts/{id}/engagement`
Prüfen, ob die Verbindung in Ordnung ist	`GET /api/channels/{id}/health`
Die Nutzung deines Tarifs prüfen	`GET /api/quotas/usage`

Beitragstypen, die du auf Tumblr veröffentlichen kannst

Wähle den Typ mit postTypeOverrides. Ein Typ, den Tumblr nicht anbietet, wird abgelehnt, bevor etwas eingereiht wird.

Beitragstyp	Medien
`post` Post	Optional, bis zu 30 Bilder oder Videos

Einen Tumblr-Beitrag mit curl planen

Drei Anfragen: Kanal finden, die Datei hochladen, falls der Beitrag eine hat, dann den Beitrag erstellen. Ersetze den Schlüssel durch einen aus Einstellungen, dann API-Schlüssel, und 12 durch deine eigene Kanal-ID.

1. Liste deine Kanäle auf und notiere die ID deines Tumblr-Kontos.

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

2. Lade die Datei hoch. Die Antwort enthält die Medien-ID, die unten als mediaFiles verwendet wird.

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

3. Erstelle den Beitrag.

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

Die Antwort ist der erstellte Beitrag mit ID und Status. Rufe ihn später mit GET /api/posts/{id} ab, um zu sehen, wie es lief.

Tumblr-Optionen

Sende diese innerhalb von platformSpecific, unter dem Schlüssel für Tumblr.

Bei Tumblr sind die Optionen nach deiner Kanal-ID abgelegt, zum Beispiel "12", oder werden flach gesendet und gelten dann für jeden Tumblr-Kanal des Beitrags.

Option	Was sie bewirkt	Akzeptiert
`blogName`	Auf welchem Blog veröffentlicht wird	Text
`title`	Titel	Text
`tags`	Tags	eine Liste
`link`	Ziellink	Text
`sourceUrl`	Quellenlink	Text

Die gültigen Blogs für einen Kanal findest du mit GET /api/channels/{id}/options.

Tumblr-Analysen über die API

Zahlen pro Beitrag gibt es für Tumblr nicht, also gibt es dazu nichts zurückzulesen.

Kommentare und Nachrichten

Über die API kannst du Kommentare unter veröffentlichten Beiträgen lesen.

Kommentare lesen geht in jedem Tarif. Kommentare beantworten braucht einen bezahlten Tarif, und die Inbox gehört zu Pro und Business. Solange eine Funktion für dein Konto nicht freigeschaltet ist, antwortet die API mit 403 und einem Code, den du abfragen kannst.

API-Zugriff in jedem Tarif

Jeder Tarif enthält API-Schlüssel, auch der Free-Tarif. Das erlaubt jeder Stufe.

Tarif	API-Schlüssel	Anfragen pro Tag
Free	1	30
Pro	5	5.000
Business	10	50.000

Direkt auf Tumblr aufbauen oder BulkPublish nutzen

BulkPublish hält die Verbindung für dich aufrecht: Es erneuert Tokens, prüft jeden Beitrag vor dem Einreihen gegen die Regeln von Tumblr und meldet ein fehlgeschlagenes Ziel am Beitrag, sodass dein Code nur eine Anfrage stellt.

Offizielle Dokumentation lesen

Lieber einen Assistenten fragen?

Claude, ChatGPT und Cursor können dasselbe über den Tumblr-MCP-Server, mit Prompts statt Code.

Den Tumblr-MCP-Server ansehen

Lieber einen Kalender als Code?

Dasselbe Tumblr-Konto lässt sich auch in der App planen, mit Content-Kalender und Massen-Upload.

Den Tumblr-Planer ansehen

Häufige Fragen

Häufige Fragen zur Tumblr API.

Gibt es eine Tumblr API, die ich nutzen kann, ohne die Integration selbst zu bauen?

Ja. BulkPublish stellt Tumblr über seine REST-API bereit. Verbinde dein Tumblr-Konto einmal, dann kannst du es mit einem Schlüssel veröffentlichen, planen und verwalten. Derselbe Schlüssel funktioniert für jedes andere verbundene Netzwerk.

Was kann ich über die API auf Tumblr veröffentlichen?

Die Beitragstypen sind Post. Jeder wird vor dem Einreihen gegen die Medienregeln von Tumblr geprüft, eine Anfrage, die Tumblr ablehnen würde, scheitert also sofort mit einer klaren Fehlermeldung.

Kann ich Tumblr-Beiträge über die API planen?

Ja. Sende den Status "scheduled" mit einer scheduledAt-Zeit und einer timezone, oder frage zuerst nach dem nächsten freien Slot in deiner Warteschlange. Wiederkehrende Pläne und RSS-Feeds gibt es ebenfalls.

Kann ich Tumblr-Analysen über die API lesen?

Keine Zahlen pro Beitrag. Sie sind für Tumblr nicht verfügbar.

Kann ich Tumblr-Kommentare oder -Nachrichten über die API lesen und beantworten?

Ja. Du kannst Kommentare unter veröffentlichten Beiträgen lesen. Kommentare beantworten braucht einen bezahlten Tarif, und die Inbox gehört zu Pro und Business.

Kostet die Tumblr API extra?

Nein. Der API-Zugriff ist in jedem Tarif enthalten. Free umfasst 1 Schlüssel und 30 Anfragen am Tag, Pro 5 Schlüssel und 5.000 am Tag, Business 10 Schlüssel und 50.000 am Tag.

Brauche ich ein Tumblr-Entwicklerkonto oder eine App-Prüfung?

Nicht, um BulkPublish zu nutzen. Du verbindest dein Tumblr-Konto auf der Seite Kanäle und veröffentlichst mit einem BulkPublish-Schlüssel. Wenn du stattdessen auf der eigenen API von Tumblr aufbaust, steht im Abschnitt oben, was sie von dir verlangt.

Kann das auch ein KI-Assistent erledigen?

Ja. Die Seite zum Tumblr-MCP-Server zeigt, wie du Claude, ChatGPT oder Cursor verbindest und was du anfragen kannst.

Derselbe Schlüssel und dieselbe Anfrageform funktionieren für 15 Netzwerke.