Tumblr API

Social / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

The Tumblr API gives you access to Tumblr's creative blogging platform, letting you read posts, follow blogs, and publish content using OAuth authentication. It supports rich media posts including text, images, videos, and GIFs in Tumblr's signature reblog-based format. Developers can use it to build dashboards, content aggregators, or automate posting across Tumblr blogs.

💡

Beginner Tip

Register your app at tumblr.com/oauth/apps to get your API key; you can read public blog posts with just the API key and only need full OAuth for posting or following.

Available Data

Use case: Integrate read and write tumblr data data into web and mobile applications
Tumblr data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Tumblr",
    "description": "Read and write Tumblr Data",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

meta.status HTTP status code of the response, e.g. 200 for success.
response.blog.title The display title of the Tumblr blog.
response.posts Array of post objects returned for the blog.
response.posts[].type Post type such as "text", "photo", "video", or "quote".
response.posts[].body The HTML body content of a text post.
response.posts[].timestamp Unix timestamp of when the post was published.

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://www.tumblr.com/docs/en/api/v2";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized OAuth credentials are missing or the token has been revoked.
Re-authorize your app through the OAuth flow to obtain a fresh access token and secret.
404 Not Found The blog name in the URL does not exist or is private.
Verify the blog name is correct and publicly accessible before making the request.
429 Too Many Requests You have exceeded the API rate limit (300 requests per hour for OAuth, 1000 per day for API key).
Add delays between requests and cache responses to stay within rate limits.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Social
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →