Skip to content
A java library for the Tumblr API
Java CSS
Find file
Latest commit 11174cf @nsheridan Merge pull request #1 from tiefpunkt/master
Added the possibility to set the date of a post


tumblr-java is a java library for the Tumblr API.


  • xAuth is the only supported authentication.
  • The library uses a mix of the v1 and v2 Tumblr APIs. The v1 API is used for creating new posts. Everything else uses the v2 API. This is mainly because file uploads using the v2 API are problematic.
  • Creating a post returns the HTTP status of the request. Everything else returns a JSONObject.
  • Tumblr API docs: v1 API, v2 API.
  • Java Doc for tumblr-java


Example use:

TextPost post = new TextPost();
post.setCredentials("", "password");
post.setTitle("Hello World!");
int result = post.postToTumblr();

Tumblr tumblr = new Tumblr("oauth_consumer_key", "oauth_secret_key");
// Set user credentials for xauth
tumblr.setCredentials("", "password");
JSONObject json = tumblr.getDashboard();

tumblr-java is licensed under the Apache 2.0 license

Something went wrong with that request. Please try again.