Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A java library for the Tumblr API

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 .settings
Octocat-spinner-32 doc
Octocat-spinner-32 libs
Octocat-spinner-32 src
Octocat-spinner-32 .classpath
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .project
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.markdown

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.