Get Tumblr posts by tag

Try in Playground

Retrieve posts for a public Tumblr tag with top or recent sorting, tag header metadata, related tags, content blocks, media and engagement. Continue with the returned cursor.

GET/v1/tumblr/tagx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

tagstringrequiredquery

Required tag text, 1 to 200 characters after trimming.

min 1 chars · max 200 chars

Examplewatercolour

sortenumquery

Optional result sorting: top (default) or recent.

one of: top, recent

Examplerecent

limitstringquery

Optional number of returned posts, 1 to 100; default 20.

Example10

cursorstringquery

Opaque caller-carried continuation, up to 12,000 characters. Reuse with the same endpoint and inputs.

min 1 chars · max 12000 chars

Response fields

164

successboolean

True when usable data is returned; inspect status and coverage.

statusenum

success or partial for usable data; failed or challenged for a failure response.

one of: success, partial

requestIdstring

Request correlation UUID.

sourceUrlstring

Canonical public URL for the requested blog, post, search, tag or community.

fetchedAtstring

UTC retrieval timestamp.

Returned-result coverage and extraction warnings.

coverage.sourcestring

Public Tumblr web data.

coverage.completeboolean

Whether this returned result has no reported omissions.

coverage.warningsenum[]

Named extraction and pagination warnings.

coverage.orderstringoptional

Reported result ordering when available.

Source request attempts, decoded bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Number of upstream request attempts.

≥ 0

accounting.responseBytesinteger

Decoded source bytes read during this request.

≥ 0

accounting.durationMsinteger

Elapsed request time in milliseconds.

≥ 0

tagstring

Required tag text, 1 to 200 characters after trimming.

sortenum

Optional result sorting: top (default) or recent.

one of: top, recent

Public tag display metadata, featured blog and post identifiers, artwork, editorial text and published counts; null when absent.

header.hubNamestringnullable

Public name shown for the tag page, or null.

header.tagIdstringnullable

Source tag identifier, preserved as a string, or null.

header.backgroundColorstringnullable

Published tag header background colour, or null.

header.headerImagestringnullable

Public tag header image URL, or null.

header.headerImageWidthintegernullable

Published header image width in pixels, or null.

0 – 9007199254740991

header.headerImageHeightintegernullable

Published header image height in pixels, or null.

0 – 9007199254740991

header.headerLinkstringnullable

Public destination URL for the tag header artwork, or null.

header.postIdstringnullable

Identifier of the tag header’s featured post, preserved as a string, or null.

header.blogstringnullable

Featured blog reference supplied by the source, or null.

header.blogAvatarUrlstringnullable

Public avatar URL for the tag header’s featured blog, or null.

header.blogNamestringnullable

Featured blog name supplied by the source, or null.

header.isTrendingbooleannullable

Whether Tumblr marks the tag as trending; null when absent.

header.followersCountstringnullable

Published follower count label, preserving source formatting; null when absent.

header.followersCountIntintegernullable

Published number of followers of the tag, or null.

0 – 9007199254740991

header.showFollowersCountbooleannullable

Whether the public tag page displays its follower count; null when absent.

header.newPostsCountstringnullable

Published new-post count label, preserving source formatting; null when absent.

header.newPostsCountIntintegernullable

Published number of new posts for the tag, or null.

0 – 9007199254740991

header.showNewPostsCountbooleannullable

Whether the public tag page displays its new-post count; null when absent.

header.postCountIntintegernullable

Published number of posts for the tag, or null.

0 – 9007199254740991

header.allowIndexbooleannullable

Published tag-page indexing setting, or null.

Published tag metadata, or null.

header.tagV2.namestringnullable

Published tag name, or null.

header.editorialDescriptionstringnullable

Published editorial description markup, or null.

header.editorialDescriptionTextstringnullable

Published editorial description as plain text, or null.

header.showEditorialDescriptionbooleannullable

Whether the public tag page displays its editorial description; null when absent.

relatedTagsstring[]

Related tag names in source order.

up to 200 items

Public Tumblr post records in returned order.

up to 100 items

posts.idstring

Post ID as a decimal string.

posts.blogNamestring

Publishing blog handle.

Public Tumblr blog details.

posts.blog.namestring

Blog handle.

posts.blog.uuidstringnullable

Source blog UUID, or null.

posts.blog.titlestringnullable

Published blog title, or null.

posts.blog.urlstringnullable

Blog URL, or null.

posts.blog.canonicalUrlstringnullable

Canonical Tumblr blog URL, or null.

posts.blog.blogViewUrlstringnullable

Source blog-view URL, or null.

posts.blog.descriptionstringnullable

Published plain-text description, or null.

posts.blog.descriptionNpfobject[]nullable

Description content blocks in Tumblr Neue Post Format, or null.

posts.blog.avatarobject[]nullable

Published avatar variants with source URLs and dimensions, or null.

posts.blog.themeobjectnullable

Published theme settings, or null.

posts.blog.tumblrmartAccessoriesobjectnullable

Published blog accessory metadata, or null.

posts.blog.topTagsobject[]nullable

Published top-tag records in source order, or null.

posts.blog.createdintegernullable

Blog creation time in Unix seconds, or null.

0 – 9007199254740991

posts.blog.updatedintegernullable

Blog update time in Unix seconds, or null.

0 – 9007199254740991

posts.blog.postCountintegernullable

Published blog post count, or null.

0 – 9007199254740991

posts.blog.totalPostsintegernullable

Published total post count, or null.

0 – 9007199254740991

posts.blog.isAdultbooleannullable

Source adult-content flag, or null.

posts.blog.isNsfwbooleannullable

Source sensitive-content flag, or null.

posts.blog.isBrandSafebooleannullable

Source brand-safety flag, or null.

posts.blog.isPasswordProtectedbooleannullable

Source password-protection flag, or null.

posts.blog.shouldBlurbooleannullable

Source content-blur flag, or null.

posts.blog.allowSearchIndexingbooleannullable

Source search-indexing setting, or null.

posts.blog.isHiddenFromBlogNetworkbooleannullable

Source blog-network visibility flag, or null.

posts.blog.shareFollowingbooleannullable

Published following-list visibility setting, or null.

posts.blog.shareLikesbooleannullable

Published liked-post visibility setting, or null.

posts.blog.shareRepliesbooleannullable

Published reply-sharing setting, or null.

posts.blog.askbooleannullable

Whether asks are enabled, or null.

posts.blog.askAnonbooleannullable

Whether anonymous asks are enabled, or null.

posts.blog.asksAllowMediabooleannullable

Whether asks allow media, or null.

posts.blog.askPageTitlestringnullable

Published ask-page title, or null.

posts.blog.canMessagebooleannullable

Source messaging capability flag, or null.

posts.blog.canSubscribebooleannullable

Source subscription capability flag, or null.

posts.blog.canBeFollowedbooleannullable

Source follow capability flag, or null.

posts.blog.canShowBadgesbooleannullable

Source badge-display flag, or null.

posts.blog.replyConditionsstringnullable

Published reply policy, or null.

posts.blog.linkedAccountsobject[]nullable

Published linked-account metadata, or null.

posts.typestringnullable

Source post type, or null.

posts.originalTypestringnullable

Source original post type, or null.

posts.postUrlstringnullable

Canonical post permalink, or null.

posts.parentPostUrlstringnullable

Parent post permalink, or null.

posts.shortUrlstringnullable

Published short URL, or null.

posts.embedUrlstringnullable

Published embed URL, or null.

posts.slugstringnullable

Post URL slug, or null.

posts.datestringnullable

Source publication date text, or null.

posts.timestampintegernullable

Publication time in Unix seconds, or null.

0 – 9007199254740991

posts.summarystringnullable

Published post summary, or null.

posts.statestringnullable

Source publication state, or null.

posts.tagsstring[]

Post tags in source order.

up to 200 items

posts.tagsV2object[]nullable

Structured source tag metadata, or null.

posts.noteCountintegernullable

Published total note count, or null.

0 – 9007199254740991

posts.likeCountintegernullable

Published like count, or null.

0 – 9007199254740991

posts.reblogCountintegernullable

Published reblog count, or null.

0 – 9007199254740991

posts.replyCountintegernullable

Published reply count, or null.

0 – 9007199254740991

posts.contentobject[]

Native Neue Post Format content blocks, including text, formatting, media references and source metadata.

up to 500 items

posts.layoutobject[]

Native post layout metadata in source order.

up to 100 items

Reblog trail with native content, layout, ancestor post metadata and blog details.

up to 100 items

posts.trail.contentobject[]

Native ancestor content blocks.

up to 500 items

posts.trail.layoutobject[]

Native ancestor layout metadata.

up to 100 items

posts.trail.postobjectnullable

Source ancestor-post metadata, or null.

Public Tumblr blog details.

posts.trail.blog.namestring

Blog handle.

posts.trail.blog.uuidstringnullable

Source blog UUID, or null.

posts.trail.blog.titlestringnullable

Published blog title, or null.

posts.trail.blog.urlstringnullable

Blog URL, or null.

posts.trail.blog.canonicalUrlstringnullable

Canonical Tumblr blog URL, or null.

posts.trail.blog.blogViewUrlstringnullable

Source blog-view URL, or null.

posts.trail.blog.descriptionstringnullable

Published plain-text description, or null.

posts.trail.blog.descriptionNpfobject[]nullable

Description content blocks in Tumblr Neue Post Format, or null.

posts.trail.blog.avatarobject[]nullable

Published avatar variants with source URLs and dimensions, or null.

posts.trail.blog.themeobjectnullable

Published theme settings, or null.

posts.trail.blog.tumblrmartAccessoriesobjectnullable

Published blog accessory metadata, or null.

posts.trail.blog.topTagsobject[]nullable

Published top-tag records in source order, or null.

posts.trail.blog.createdintegernullable

Blog creation time in Unix seconds, or null.

0 – 9007199254740991

posts.trail.blog.updatedintegernullable

Blog update time in Unix seconds, or null.

0 – 9007199254740991

posts.trail.blog.postCountintegernullable

Published blog post count, or null.

0 – 9007199254740991

posts.trail.blog.totalPostsintegernullable

Published total post count, or null.

0 – 9007199254740991

posts.trail.blog.isAdultbooleannullable

Source adult-content flag, or null.

posts.trail.blog.isNsfwbooleannullable

Source sensitive-content flag, or null.

posts.trail.blog.isBrandSafebooleannullable

Source brand-safety flag, or null.

posts.trail.blog.isPasswordProtectedbooleannullable

Source password-protection flag, or null.

posts.trail.blog.shouldBlurbooleannullable

Source content-blur flag, or null.

posts.trail.blog.allowSearchIndexingbooleannullable

Source search-indexing setting, or null.

posts.trail.blog.isHiddenFromBlogNetworkbooleannullable

Source blog-network visibility flag, or null.

posts.trail.blog.shareFollowingbooleannullable

Published following-list visibility setting, or null.

posts.trail.blog.shareLikesbooleannullable

Published liked-post visibility setting, or null.

posts.trail.blog.shareRepliesbooleannullable

Published reply-sharing setting, or null.

posts.trail.blog.askbooleannullable

Whether asks are enabled, or null.

posts.trail.blog.askAnonbooleannullable

Whether anonymous asks are enabled, or null.

posts.trail.blog.asksAllowMediabooleannullable

Whether asks allow media, or null.

posts.trail.blog.askPageTitlestringnullable

Published ask-page title, or null.

posts.trail.blog.canMessagebooleannullable

Source messaging capability flag, or null.

posts.trail.blog.canSubscribebooleannullable

Source subscription capability flag, or null.

posts.trail.blog.canBeFollowedbooleannullable

Source follow capability flag, or null.

posts.trail.blog.canShowBadgesbooleannullable

Source badge-display flag, or null.

posts.trail.blog.replyConditionsstringnullable

Published reply policy, or null.

posts.trail.blog.linkedAccountsobject[]nullable

Published linked-account metadata, or null.

posts.rebloggedFromIdstringnullable

Immediate parent post ID, or null.

posts.rebloggedFromUrlstringnullable

Immediate parent post permalink, or null.

posts.rebloggedFromNamestringnullable

Immediate parent blog handle, or null.

posts.rebloggedFromTitlestringnullable

Immediate parent blog title, or null.

posts.rebloggedFromUuidstringnullable

Immediate parent blog UUID, or null.

posts.rebloggedRootIdstringnullable

Original root post ID, or null.

posts.rebloggedRootUrlstringnullable

Original root post permalink, or null.

posts.rebloggedRootNamestringnullable

Original root blog handle, or null.

posts.rebloggedRootTitlestringnullable

Original root blog title, or null.

posts.rebloggedRootUuidstringnullable

Original root blog UUID, or null.

posts.isBlocksPostFormatbooleannullable

Whether the post uses Neue Post Format, or null.

posts.isNsfwbooleannullable

Source sensitive-content flag, or null.

posts.classificationstringnullable

Published source content classification, or null.

posts.isCommercialbooleannullable

Source commercial-content flag, or null.

posts.isBlazedbooleannullable

Source promoted-post flag, or null.

posts.isBrandSafebooleannullable

Source brand-safety flag, or null.

Published community-label status and categories as an object or array of objects, or null when absent.

posts.communityLabels.hasCommunityLabelbooleannullable

Whether the source marks the post with a community label; null when absent.

posts.communityLabels.categoriesJSON[]nullable

Published community-label categories, up to 100 items; an empty array means the source provides no categories, and null means the field is absent.

nextCursorstringnullable

Opaque continuation for another page, or null.

hasMoreboolean

Whether a source continuation is available.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
200	`partial`	Usable data with more_available, item_limit, non_post_items_omitted, unknown_note_type or field_limit coverage warnings.
400	`invalid_request`	Missing, duplicate, malformed, unsafe or unsupported request parameters.
401	`unauthorized`	Missing or invalid service API key.
404	`not_found`	The requested public blog, post or community was not found.
422	`restricted_page`	The requested primary object is access-restricted.
422	`unsupported_page`	The source layout or identity could not be mapped to the contract.
502	`upstream_challenged`	The source challenged retrieval.
502	`upstream_rate_limited`	The source rate-limited retrieval.
502	`upstream_error`	Source retrieval could not complete.
502	`response_too_large` `payload_too_complex`	Source data exceeded the byte or parsing limits.
502	`unsafe_redirect` `request_limit`	The source redirect or request sequence exceeded the accepted contract.
503	`busy`	Request capacity or queue wait was exceeded.
504	`timeout`	The total operation deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/tumblr/tag?tag=watercolour&sort=recent&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/tumblr/tag?tag=watercolour&sort=recent&limit=10",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/tumblr/tag?tag=watercolour&sort=recent&limit=10",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Tumblr request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/tumblr/tag",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "tag": "watercolour",
        "sort": "recent",
        "limit": "10"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/tumblr/tag?tag=watercolour&sort=recent&limit=10", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/tumblr/tag?tag=watercolour&sort=recent&limit=10"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.tumblr.com/tagged/watercolour?sort=recent",
  "fetchedAt": "2026-10-06T00:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1500,
    "durationMs": 300
  },
  "tag": "watercolour",
  "sort": "recent",
  "header": {
    "hubName": "watercolour",
    "tagId": "example-watercolour-tag",
    "backgroundColor": "#36465d",
    "headerImage": "https://64.media.tumblr.com/example-tag-header.jpg",
    "headerLink": "https://www.tumblr.com/example-blog/123456789012345678",
    "postId": "123456789012345678",
    "blog": "example-blog.tumblr.com",
    "blogAvatarUrl": "https://64.media.tumblr.com/example-avatar.png",
    "blogName": "Example Blog",
    "followersCount": "1.2K",
    "newPostsCount": "8",
    "editorialDescription": "<p>Synthetic watercolour tag description.</p>",
    "editorialDescriptionText": "Synthetic watercolour tag description.",
    "headerImageWidth": 1200,
    "headerImageHeight": 600,
    "followersCountInt": 1200,
    "newPostsCountInt": 8,
    "postCountInt": 100,
    "isTrending": false,
    "showFollowersCount": true,
    "showNewPostsCount": true,
    "allowIndex": true,
    "showEditorialDescription": true,
    "tagV2": {
      "name": "watercolour"
    }
  },
  "relatedTags": [
    "art"
  ],
  "posts": [
    {
      "id": "123456789012345678",
      "blogName": "exampleblog",
      "blog": {
        "name": "exampleblog",
        "uuid": "t:synthetic-blog",
        "title": "Example blog",
        "url": "https://exampleblog.tumblr.com/",
        "canonicalUrl": "https://www.tumblr.com/exampleblog",
        "blogViewUrl": null,
        "description": "Synthetic art and photography blog.",
        "descriptionNpf": [
          {
            "type": "text",
            "text": "Synthetic art and photography blog."
          }
        ],
        "avatar": [
          {
            "width": 64,
            "height": 64,
            "url": "https://64.media.tumblr.com/synthetic-avatar.png"
          }
        ],
        "theme": {
          "titleColor": "#36465D",
          "backgroundColor": "#FFFFFF"
        },
        "tumblrmartAccessories": null,
        "topTags": [
          {
            "tag": "photography",
            "count": 3
          }
        ],
        "created": null,
        "updated": null,
        "postCount": null,
        "totalPosts": null,
        "isAdult": false,
        "isNsfw": null,
        "isBrandSafe": null,
        "isPasswordProtected": false,
        "shouldBlur": null,
        "allowSearchIndexing": null,
        "isHiddenFromBlogNetwork": null,
        "shareFollowing": null,
        "shareLikes": null,
        "shareReplies": null,
        "ask": null,
        "askAnon": null,
        "asksAllowMedia": null,
        "askPageTitle": null,
        "canMessage": null,
        "canSubscribe": null,
        "canBeFollowed": null,
        "canShowBadges": null,
        "replyConditions": null,
        "linkedAccounts": null
      },
      "type": "blocks",
      "originalType": "regular",
      "postUrl": "https://www.tumblr.com/exampleblog/123456789012345678",
      "parentPostUrl": null,
      "shortUrl": null,
      "embedUrl": null,
      "slug": "synthetic-art-post",
      "date": "2026-10-06 00:00:00 GMT",
      "timestamp": 1791244800,
      "summary": "Synthetic art post.",
      "state": "published",
      "tags": [
        "photography",
        "art"
      ],
      "tagsV2": null,
      "noteCount": 12,
      "likeCount": 8,
      "reblogCount": 2,
      "replyCount": 2,
      "content": [
        {
          "type": "text",
          "text": "Synthetic art post."
        },
        {
          "type": "image",
          "media": [
            {
              "url": "https://64.media.tumblr.com/synthetic-image.jpg",
              "width": 800,
              "height": 600,
              "type": "image/jpeg"
            }
          ]
        }
      ],
      "layout": [],
      "trail": [],
      "rebloggedFromId": null,
      "rebloggedFromUrl": null,
      "rebloggedFromName": null,
      "rebloggedFromTitle": null,
      "rebloggedFromUuid": null,
      "rebloggedRootId": null,
      "rebloggedRootUrl": null,
      "rebloggedRootName": null,
      "rebloggedRootTitle": null,
      "rebloggedRootUuid": null,
      "isBlocksPostFormat": true,
      "isNsfw": false,
      "classification": null,
      "isCommercial": null,
      "isBlazed": null,
      "isBrandSafe": null,
      "communityLabels": null
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

Missing, duplicate, malformed, unsafe or unsupported request parameters.

{
  "success": false,
  "status": "failed",
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}