Tumblr API

Tumblr API for Blog Info, Blog Posts, Post Details, and Tag Timelines

Scrappa's Tumblr API returns structured JSON from Tumblr, the microblogging and social network platform. Read public blog info with name, title, uuid and total post count, list a blog's posts in NPF with note counts and tags, open any post for its note, like, reblog and reply counts, and page through tag timelines. Scrappa is an independent service and is not affiliated with or endorsed by Tumblr.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
4
Endpoints
NPF
Post format
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/tumblr/blog?blog=aphractal2" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "endpoint": "blog",
  "name": "aphractal2",
  "title": "Aphractal Sketches",
  "uuid": "t:QX-_Qv5T-24DH_pA19LJow",
  "total_posts": 591,
  "url": "https://www.tumblr.com/aphractal2",
  "ask": true
}

What you can build

Structured data for real applications. Here are some ideas.

Blog Profile Lookups

Resolve any public tumblelog to its name, title, uuid, total post count, url and ask flag in one request.

Blog Post Feeds

Page a blog's posts in NPF with note counts, tags and content blocks, following the opaque next_cursor.

Post Engagement Counts

Open any post by numeric id for its note, like, reblog and reply counts plus tags and NPF content.

Tag Timeline Monitoring

Track the posts Tumblr serves for any tag with cursor pagination for change detection.

Tumblr scraper API

Tumblr API for blog info, posts, post details and tag timelines

The Tumblr API is built for social analytics, content tools and blog monitoring. Blog info returns name, title, uuid, total post count, url and ask flag. Blog posts and tag timelines return NPF posts with note counts, tags and content blocks plus opaque cursor pagination. Post detail returns note, like, reblog and reply counts for one numeric post id.

Read public blog info with name, title, uuid, total post count, url and ask flag.

List a blog's posts in NPF with note counts, tags and content blocks.

Open any post for note, like, reblog and reply counts.

Page tag timelines with opaque cursors; a valid empty result is a successful response.

Choose the right Tumblr API endpoint

Use Blog Info for profile resolution

Resolve a tumblelog name to its public profile with name, title, uuid, total post count, url and ask flag in one lookup.

Open Tumblr Blog API docs

Use Blog Posts for feeds

Page a blog's posts in NPF with note counts, tags and content blocks, following next_cursor until has_more is false.

Open Tumblr Blog Posts API docs

Use Post Detail for engagement counts

Open any post by numeric id to read its note, like, reblog and reply counts with tags and NPF content blocks.

Open Tumblr Post API docs

Use Tag Timeline for tag monitoring

Request a tag timeline and page it with the opaque cursor to collect the posts Tumblr serves for any tag.

Open Tumblr Tag Timeline API docs

Available endpoints

Everything you need in one API.

GET

Blog Info

/api/tumblr/blog

Get public blog info for one tumblelog: name, title, uuid, total post count, url and ask flag

Scrappa vs SerpAPI / ScraperAPI

See how Scrappa compares to the official API.

Tumblr blog and post data as JSON
Scrappa:
SerpAPI / ScraperAPI: Build your own parser
NPF post format
Scrappa: Native
SerpAPI / ScraperAPI: Parse it yourself
Post engagement counts
Scrappa: note, like, reblog, reply
SerpAPI / ScraperAPI: Not offered
Price per 1k requests
Scrappa: From $0.20
SerpAPI / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
SerpAPI / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
SerpAPI / ScraperAPI: Trial credits

Key features

Public blog info with name, title, uuid, total post count, url and ask flag
Blog posts in NPF with note counts, tags and content blocks
Post detail with note, like, reblog and reply counts
Tag timelines with opaque cursor pagination
Failed requests are never charged; valid empty results are billable

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Tumblr. The Tumblr API returns structured JSON from public Tumblr pages through a Scrappa API key.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.

Blog posts and tag timelines are cursor-paginated. Pass the next_cursor value from a previous response back as the cursor parameter. has_more is true while more pages exist and next_cursor is null on the last page. A valid empty result is a successful response.

Posts are returned in Tumblr's NPF (New Post Format) with type blocks: content is an array of blocks, and note, like, reblog and reply counts are integers on the post object.

Start using the Tumblr API

Sign up and get 500 free credits. No credit card required.