Tumblr

About Tumblr

The Tumblr API is a REST-based interface (base URL https://api.tumblr.com) for interacting with Tumblr blogs and user accounts programmatically. It supports authentication via OAuth1 and OAuth2, and requires application registration to obtain an API key. Requests accept body parameters as application/json, application/x-www-form-urlencoded, or multipart/form-data, and every application must send a consistent User-Agent header to avoid suspension.

The API exposes methods for managing blogs (retrieving info, avatars, followers, likes, blocks, posts, queued/draft/submission posts, notifications, pages) and user accounts (dashboard, likes, following, follow/unfollow, liking posts, tag and content filtering). It supports creating, editing, reblogging, and deleting posts, including a Neue Post Format for structured post content, as well as tag-based post retrieval. A separate set of Communities methods allows listing and managing communities, invitations, memberships, moderation, reactions, and community timelines. Tumblr also provides an oEmbed endpoint at https://www.tumblr.com/oembed for retrieving embeddable post content from post URLs.

This API is intended for developers and engineers building applications, integrations, or tools that read from or write to Tumblr, such as posting content, retrieving blog or user data, or embedding Tumblr posts elsewhere. It includes rate limits and a developer console for testing calls against live examples.

Key features

• REST API for creating, editing, reblogging, and deleting blog posts
• OAuth1 and OAuth2 authentication for third-party applications
• Blog methods for retrieving posts, queue, drafts, submissions, and notifications
• User methods for dashboard, likes, following, and content/tag filtering
• Communities API for managing membership, invitations, moderation, and reactions
• oEmbed endpoint for embedding Tumblr post URLs

Frequently asked questions