Tumblr API reference
Get public Tumblr blogs, posts, reblog trails, polls, tag stats, search results and original-size images as clean JSON. Send a blog name, a post link or a tag. No Tumblr login.
The Tumblr API has 11 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Tumblr in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are username, url and post_id. Prices run from 0.25 credits to 0.5–2 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
tumblr.posts.list |
List a blog's public posts with summary, tags, notes, post time and link, page by page. | 0.5–2 credits |
tumblr.post.get |
Get one post from its link, or its blog and ID: the full content blocks, reblog trail, poll, tags and note count. | 0.25 credits |
tumblr.profile.get |
Get a public blog from its name or link: title, description and whether it is marked NSFW. | 0.5 credits |
tumblr.posts.search |
Search public Tumblr posts by keyword. | 0.5–2 credits |
tumblr.tag.get |
Get a tag's stats: followers, total posts, new posts and whether it is trending. | 0.25 credits |
tumblr.tag-posts.list |
List the recent public posts under a tag. | 0.5–2 credits |
tumblr.images.list |
Collect the original-size images from a blog's recent posts. | 0.5–2 credits |
tumblr.post-images.get |
Collect the original-size images from one post and its reblog trail. | 0.25 credits |
tumblr.raw-posts.list |
List a blog's posts as Tumblr's own records, for your own parsing. | 0.5–2 credits |
tumblr.raw-profile.get |
Get a blog's profile as Tumblr's own record, for your own parsing. | 0.5 credits |
tumblr.post-replies.list |
Read the public replies under a Tumblr post, from the blog name and post ID or the post link, with each reply's text and time. | 0.25 credits |
What to know
- Posts are content blocks A post comes as blocks of text, images and polls in order, so you can rebuild it or take only the text.
- Reblog trails included A reblogged post carries the posts it was reblogged from, so you see the whole chain.
- Notes as Tumblr counts them Note counts are Tumblr's own number at the moment of the call, counting likes, reblogs and replies together.
- Recent posts Search and tag timelines return the recent posts Tumblr shows, not every post ever made.
Something missing or unclear? Ask the team that builds the Tumblr endpoints.