Tumblr API

Tumblr Scraper API for Blogs, Posts and Communities

Read public blogs, posts, liked-post collections, following lists and communities. Search keywords and tags, and retrieve replies, likes and reblogs for content and audience research.

WHAT YOU CAN BUILD / 10 ENDPOINTS

Put Tumblr data to work.

Find your use case, then explore the request and response.

Get a Tumblr blog

GET/v1/tumblr/blog

Build a blog research directory with Tumblr blog names, descriptions, avatars, themes and published tags.

Get a Tumblr blog’s posts

GET/v1/tumblr/posts

Build a blog content feed from published posts, tags, content blocks, media, publication times and engagement counts.

Get a Tumblr post

GET/v1/tumblr/post

Build a post research card from a Tumblr blog or community permalink, keeping content, media, public author details and reblog trails together.

Search Tumblr posts

GET/v1/tumblr/search

Build a topic research finder from keyword-matched Tumblr posts with blog identity, content, media and engagement.

Get Tumblr posts by tag

GET/v1/tumblr/tag

Build a tagged-content browser from Tumblr posts, their content blocks, media, authors and published engagement.

Get a Tumblr post’s notes

GET/v1/tumblr/post/notes

Build a post feedback report from Tumblr blog replies, likes and reblogs or community replies, with public blog identities, timestamps and engagement totals.

Get a Tumblr blog’s liked posts

GET/v1/tumblr/likes

Build a liked-post reading list from a public Tumblr blog’s selected posts, with content, media, tags, engagement and liked timestamps.

Get a Tumblr blog’s following list

GET/v1/tumblr/following

Build a public blog discovery map from a Tumblr following list, with followed blog names, titles, URLs, avatars and descriptions.

Get a Tumblr community

GET/v1/tumblr/community

Build a Tumblr community directory with published titles, descriptions, imagery, guidelines, tags and membership counts.

Get a Tumblr community’s posts

GET/v1/tumblr/community/posts

Build a community reading feed from Tumblr posts with content, media, author blogs, tags, reactions and engagement.

HOW IT WORKS

From API key to Tumblr data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 10 Tumblr endpoints and add its input, such as a public handle.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Tumblr data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

LIVE RESULTS

Try a sample request.

Try the Tumblr API right here. This sample uses the Get a Tumblr blog endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with staff, or change the handle field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Get a Tumblr blogNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "staff";
const url = new URL("/website/demo/tumblr",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/tumblr/blog

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Popular

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Save 6.3% compared with Starter

Scale

For high-volume data collection.

$249USD / one-time

200,000 credits

$1.25 per 1,000 successful requests

Save 34.5% compared with Starter

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Tumblr API

Frequently Asked Questions

Explore the API reference

Tumblr API and scraping

What public data can I retrieve with the Tumblr API?

Read blog profiles, posts, public liked-post collections, following lists and community details or posts. Search by keyword, browse tagged feeds, inspect post content and reblog trails, and retrieve replies, likes and reblogs with their blog identities and timestamps.

Can I retrieve a Tumblr blog’s public likes and following list?

Use Blog Likes with a blog handle to retrieve liked posts, their content, media, engagement and liked timestamps. Use Blog Following to retrieve the public blogs it follows, with blog identity, URLs, avatars and descriptions. Both collections return a cursor for another page.

How do I scrape posts from a public Tumblr blog?

Send a blog handle to Blog Posts to retrieve its published posts with content, tags, media and engagement. Use Post Details with a selected Tumblr permalink to inspect the post and its reblog trail in a dedicated research view.

Tumblr: post discovery, interactions and communities

Can I find Tumblr posts by keyword or tag?

Use Search Posts with a keyword query, or Tagged Posts with a tag, to retrieve matching content, media, blog details and engagement. Choose top or recent sorting, set the result limit, and pass the returned cursor with the same query or tag and sorting to request another page.

Can I retrieve Tumblr comments, likes and reblogs?

Use Post Notes with a blog post permalink to retrieve public replies, likes and reblogs. A community post permalink returns public replies and community details. Interactions include blog identities, timestamps, reply text and original-author indicators, with published engagement totals for your post feedback report.

Can I retrieve Tumblr community details and posts?

Use Community Details with a community slug to read its title, descriptions, imagery, guidelines, tags and published membership counts. Community Posts returns post content, media, author blogs, reactions and engagement. Pass its returned cursor with the same community slug to continue the feed.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?