Tumblr API

Read public Tumblr blogs, posts, tags and search results as JSON, without registering an OAuth app.

The API.SH Tumblr API returns public Tumblr content as structured JSON. Read a blog's profile and posts with tag, type and date filters, open one post with its notes, likes, reblogs and full reblog trail, search posts by top or recent, and list the posts under any tag with related tags.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Tumblr search

GET https://api.api.sh/tumblr/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Tumblr API

Blog archiving and backups

Page through a blog's posts with the cursor to save text, images, videos and tags, or narrow by type, tag and date.

/blog

Tag and fandom tracking

Follow what is posted under a tag, top or most recent, with note counts and the related tags Tumblr shows.

/tagged /search

Viral post analysis

Open a post to see its notes, likes, reblogs and replies, and trace the reblog chain back to the original post.

/post

Brand and topic monitoring

Search Tumblr for a brand or topic, filter by post type and recency, and see related communities and tags.

/search

Image and media collection

Collect image and video links from a blog or a tag for research datasets and mood boards.

/blog /tagged

Tumblr data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Tumblr API endpoints and prices

Every Tumblr endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Tumblr search

/tumblr/v1/search

$1 · $2 PAYG

1 credit

Posts and media3

Tumblr blog and latest posts /tumblr/v1/blog	$1 · $2 PAYG 1 credit
Tumblr post /tumblr/v1/post	$1 · $2 PAYG 1 credit
Tumblr tagged posts /tumblr/v1/tagged	$1 · $2 PAYG 1 credit

Call the Tumblr API

Tumblr search: GET https://api.api.sh/tumblr/v1/search

curl "https://api.api.sh/tumblr/v1/search?q=cats" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/tumblr/v1/search",
    params={"q": "cats"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/tumblr/v1/search");
url.searchParams.set("q", "cats");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/tumblr/v1/search", "q", "cats")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Tumblr" and "Tumblr search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Tumblr data

Public data only: no Tumblr login, cookies or account needed
One key and one response shape for Tumblr and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Tumblr API

Tumblr has an official API v2 that is free to use after you register an OAuth app for a consumer key, with hourly and daily rate limits per key. API.SH needs no app registration or OAuth and returns public blogs, posts, tags and search in the same JSON shape as the other platforms you use.

Skip maintaining a Tumblr scraper from GitHub, pytumblr setup or an Apify actor per task: one API.SH key covers blogs, posts, tags and search at a fixed price per call.

Tumblr API questions

What Tumblr data can I get?+

A blog's profile and posts (/tumblr/v1/blog), one post with notes, likes, reblogs and the reblog trail (/tumblr/v1/post), post search with related communities and tags (/tumblr/v1/search) and the posts under a tag (/tumblr/v1/tagged).

How much does the Tumblr API cost?+

Every Tumblr endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /tumblr/v1/blog at 1 credit each.

Is there an official Tumblr API?+

Yes. Tumblr's API v2 is free with a registered OAuth app and rate limits per consumer key. API.SH is an alternative when you do not want to register an app or handle OAuth, or want one key and one JSON format across many sites.

Do I need a Tumblr account or API key from Tumblr?+

No. API.SH reads public Tumblr pages only. No endpoint uses a login, cookies, a consumer key or anyone's account, and nothing is posted.

Can I use it from Python?+

Yes. Send a GET request with your API.SH key using requests or the API.SH Python SDK; there is no OAuth flow to set up as with pytumblr.

Can I get all posts from a Tumblr blog?+

/tumblr/v1/blog returns the latest posts and a next_cursor. Pass it back as cursor to keep reading older posts, page by page.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /tumblr/v1/blog with a blog name. Every parameter is in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.