Tumblr
BulkPublish
API Tumblr
Publiez, programmez et gérez Tumblr depuis votre propre code. Une seule API REST et une seule clé couvrent Tumblr et tous les autres réseaux que vous connectez : vous écrivez l’intégration une seule fois.
Ce que couvre l’API Tumblr
Tout ce qui suit fait partie de l’API publiée et fonctionne dès aujourd’hui avec Tumblr.
| Fonction | Endpoint |
|---|---|
| Créer, programmer, modifier et publier des publications | POST /api/posts |
| Importer des images et des vidéos | POST /api/media |
| Trouver le prochain créneau libre de votre file | GET /api/posts/queue-slot |
| Créer des programmations récurrentes | POST /api/schedules |
| Publier les nouveaux éléments d’un flux RSS | POST /api/rss-feeds |
| Consulter les blogs Tumblr d’un canal | GET /api/channels/{id}/options |
| Lire les commentaires des publications | GET /api/posts/{id}/engagement |
| Vérifier que la connexion fonctionne bien | GET /api/channels/{id}/health |
| Consulter l’utilisation de votre offre | GET /api/quotas/usage |
Types de publication pour Tumblr
Choisissez le type avec postTypeOverrides. Un type que Tumblr ne propose pas est refusé avant toute mise en file.
| Type de publication | Médias |
|---|---|
post Post | Facultatif, jusqu’à 30 images ou vidéos |
Programmer une publication Tumblr avec curl
Trois requêtes : trouver votre canal, importer le fichier si la publication en a un, puis créer la publication. Remplacez la clé par une clé de Paramètres, puis Clés d’API, et 12 par l’identifiant de votre propre canal.
1. Listez vos canaux et notez l’identifiant de votre compte Tumblr.
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. Importez le fichier. La réponse donne l’identifiant du média, utilisé comme mediaFiles ci-dessous.
curl -X POST https://app.bulkpublish.com/api/media \
-H "Authorization: Bearer bp_your_key_here" \
-F "file=@photo.jpg" 3. Créez la publication.
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 réponse est la publication créée, avec son identifiant et son statut. Récupérez-la plus tard avec GET /api/posts/{id} pour voir comment cela s’est passé.
Options Tumblr
Envoyez-les dans platformSpecific, sous la clé de Tumblr.
Pour Tumblr, les options sont indexées par l’identifiant de votre canal, par exemple « 12 », ou envoyées à plat pour s’appliquer à tous les canaux Tumblr de la publication.
| Option | Ce qu’elle fait | Accepte |
|---|---|---|
blogName | Blog où publier | du texte |
title | Titre | du texte |
tags | Tags | une liste |
link | Lien de destination | du texte |
sourceUrl | Lien de source | du texte |
Pour trouver les blogs valides d’un canal, appelez GET /api/channels/{id}/options.
Statistiques Tumblr via l’API
Les chiffres par publication ne sont pas disponibles pour Tumblr : il n’y a donc rien à récupérer.
Commentaires et messages
Via l’API, vous pouvez lire les commentaires des publications.
La lecture des commentaires fonctionne sur toutes les offres. Y répondre demande une offre payante, et la boîte de réception fait partie de Pro et Business. Tant qu’une fonction n’est pas activée sur votre compte, l’API répond 403 avec un code que vous pouvez tester.
Accès API sur toutes les offres
Chaque offre inclut des clés d’API, l’offre Free comprise. Voici ce que permet chacune.
| Offre | Clés d’API | Requêtes par jour |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5 000 |
| Business | 10 | 50 000 |
Construire directement sur Tumblr, ou passer par BulkPublish
BulkPublish garde la connexion pour vous : il renouvelle les jetons, vérifie chaque publication selon les règles de Tumblr avant la mise en file et signale sur la publication une destination en échec, si bien que votre code n’envoie qu’une requête.
Lire la documentation officielle
Vous préférez demander à un assistant ?
Claude, ChatGPT et Cursor peuvent faire la même chose via le serveur MCP Tumblr, avec des demandes au lieu de code.
Vous préférez un calendrier au code ?
Le même compte Tumblr peut être programmé depuis l’app, avec un calendrier de contenu et l’import en masse.
Questions fréquentes
Questions courantes sur l’API Tumblr.
Existe-t-il une API Tumblr utilisable sans construire l’intégration moi-même ?
Oui. BulkPublish expose Tumblr via son API REST. Connectez votre compte Tumblr une fois, puis publiez, programmez et gérez-le avec une clé. La même clé fonctionne pour tous les autres réseaux que vous connectez.
Que puis-je publier sur Tumblr via l’API ?
Les types de publication sont Post. Chacun est vérifié selon les règles média de Tumblr avant toute mise en file : une requête que Tumblr refuserait échoue donc immédiatement, avec une erreur claire.
Puis-je programmer des publications Tumblr via l’API ?
Oui. Envoyez le statut "scheduled" avec une heure scheduledAt et un timezone, ou demandez d’abord le prochain créneau libre de votre file. Les programmations récurrentes et les flux RSS sont aussi disponibles.
Puis-je lire les statistiques Tumblr via l’API ?
Pas les chiffres par publication. Ils ne sont pas disponibles pour Tumblr.
Puis-je lire les commentaires ou messages Tumblr et y répondre via l’API ?
Oui. Vous pouvez lire les commentaires des publications. Répondre aux commentaires demande une offre payante, et la boîte de réception fait partie de Pro et Business.
L’API Tumblr coûte-t-elle un supplément ?
Non. L’accès API est inclus dans toutes les offres. Free comprend 1 clé et 30 requêtes par jour, Pro 5 clés et 5 000 par jour, Business 10 clés et 50 000 par jour.
Me faut-il un compte développeur Tumblr ou une validation d’application ?
Pas pour utiliser BulkPublish. Vous connectez votre compte Tumblr sur la page Canaux et publiez avec une clé BulkPublish. Si vous construisez plutôt sur l’API propre de Tumblr, la section ci-dessus liste ce qu’elle exige de vous.
Un assistant IA peut-il le faire aussi ?
Oui. La page du serveur MCP Tumblr explique comment connecter Claude, ChatGPT ou Cursor et quoi demander.
Autres réseaux
La même clé et la même forme de requête fonctionnent pour 15 réseaux.
Voir toutes les API de réseaux
Publiez sur Tumblr depuis votre code
Créez un compte gratuit, connectez Tumblr et générez une clé. Aucune carte requise.