Skip to content
scrapeatlas.Dashboard

Get a Tumblr post

Try in Playground

Retrieve a public Tumblr blog or community post by permalink with native content, media, tags, public author details, engagement and reblog trail. Community posts also include community metadata and reactions.

GET/v1/tumblr/postx-api-key
x-api-keystringrequiredheader

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

Query parameters
1
urlstringrequiredquery

Required HTTPS www.tumblr.com/<handle>/<post-id>, <handle>.tumblr.com/post/<post-id> or www.tumblr.com/communities/<slug>/post/<post-id> permalink, up to 1,024 characters. Blog-post URLs accept an optional title slug; community post URLs accept an optional trailing slash and tracking query.

max 1024 chars

Examplehttps://www.tumblr.com/communities/example-community/post/123456789012345678
Response fields
200
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

Public Tumblr blog-post or community-post details.

post.idstring

Post ID as a decimal string.

post.blogNamestring

Publishing blog handle.

Public Tumblr blog details.

post.blog.namestring

Blog handle.

post.blog.uuidstringnullable

Source blog UUID, or null.

post.blog.titlestringnullable

Published blog title, or null.

post.blog.urlstringnullable

Blog URL, or null.

post.blog.canonicalUrlstringnullable

Canonical Tumblr blog URL, or null.

post.blog.blogViewUrlstringnullable

Source blog-view URL, or null.

post.blog.descriptionstringnullable

Published plain-text description, or null.

post.blog.descriptionNpfobject[]nullable

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

post.blog.avatarobject[]nullable

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

post.blog.themeobjectnullable

Published theme settings, or null.

post.blog.tumblrmartAccessoriesobjectnullable

Published blog accessory metadata, or null.

post.blog.topTagsobject[]nullable

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

post.blog.createdintegernullable

Blog creation time in Unix seconds, or null.

0 – 9007199254740991

post.blog.updatedintegernullable

Blog update time in Unix seconds, or null.

0 – 9007199254740991

post.blog.postCountintegernullable

Published blog post count, or null.

0 – 9007199254740991

post.blog.totalPostsintegernullable

Published total post count, or null.

0 – 9007199254740991

post.blog.isAdultbooleannullable

Source adult-content flag, or null.

post.blog.isNsfwbooleannullable

Source sensitive-content flag, or null.

post.blog.isBrandSafebooleannullable

Source brand-safety flag, or null.

post.blog.isPasswordProtectedbooleannullable

Source password-protection flag, or null.

post.blog.shouldBlurbooleannullable

Source content-blur flag, or null.

post.blog.allowSearchIndexingbooleannullable

Source search-indexing setting, or null.

post.blog.isHiddenFromBlogNetworkbooleannullable

Source blog-network visibility flag, or null.

post.blog.shareFollowingbooleannullable

Published following-list visibility setting, or null.

post.blog.shareLikesbooleannullable

Published liked-post visibility setting, or null.

post.blog.shareRepliesbooleannullable

Published reply-sharing setting, or null.

post.blog.askbooleannullable

Whether asks are enabled, or null.

post.blog.askAnonbooleannullable

Whether anonymous asks are enabled, or null.

post.blog.asksAllowMediabooleannullable

Whether asks allow media, or null.

post.blog.askPageTitlestringnullable

Published ask-page title, or null.

post.blog.canMessagebooleannullable

Source messaging capability flag, or null.

post.blog.canSubscribebooleannullable

Source subscription capability flag, or null.

post.blog.canBeFollowedbooleannullable

Source follow capability flag, or null.

post.blog.canShowBadgesbooleannullable

Source badge-display flag, or null.

post.blog.replyConditionsstringnullable

Published reply policy, or null.

post.blog.linkedAccountsobject[]nullable

Published linked-account metadata, or null.

post.typestringnullable

Source post type, or null.

post.originalTypestringnullable

Source original post type, or null.

post.postUrlstringnullable

Canonical post permalink, or null.

post.parentPostUrlstringnullable

Parent post permalink, or null.

post.shortUrlstringnullable

Published short URL, or null.

post.embedUrlstringnullable

Published embed URL, or null.

post.slugstringnullable

Post URL slug, or null.

post.datestringnullable

Source publication date text, or null.

post.timestampintegernullable

Publication time in Unix seconds, or null.

0 – 9007199254740991

post.summarystringnullable

Published post summary, or null.

post.statestringnullable

Source publication state, or null.

post.tagsstring[]

Post tags in source order.

up to 200 items

post.tagsV2object[]nullable

Structured source tag metadata, or null.

post.noteCountintegernullable

Published total note count, or null.

0 – 9007199254740991

post.likeCountintegernullable

Published like count, or null.

0 – 9007199254740991

post.reblogCountintegernullable

Published reblog count, or null.

0 – 9007199254740991

post.replyCountintegernullable

Published reply count, or null.

0 – 9007199254740991

post.contentobject[]

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

up to 500 items

post.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

post.trail.contentobject[]

Native ancestor content blocks.

up to 500 items

post.trail.layoutobject[]

Native ancestor layout metadata.

up to 100 items

post.trail.postobjectnullable

Source ancestor-post metadata, or null.

Public Tumblr blog details.

post.trail.blog.namestring

Blog handle.

post.trail.blog.uuidstringnullable

Source blog UUID, or null.

post.trail.blog.titlestringnullable

Published blog title, or null.

post.trail.blog.urlstringnullable

Blog URL, or null.

post.trail.blog.canonicalUrlstringnullable

Canonical Tumblr blog URL, or null.

post.trail.blog.blogViewUrlstringnullable

Source blog-view URL, or null.

post.trail.blog.descriptionstringnullable

Published plain-text description, or null.

post.trail.blog.descriptionNpfobject[]nullable

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

post.trail.blog.avatarobject[]nullable

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

post.trail.blog.themeobjectnullable

Published theme settings, or null.

post.trail.blog.tumblrmartAccessoriesobjectnullable

Published blog accessory metadata, or null.

post.trail.blog.topTagsobject[]nullable

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

post.trail.blog.createdintegernullable

Blog creation time in Unix seconds, or null.

0 – 9007199254740991

post.trail.blog.updatedintegernullable

Blog update time in Unix seconds, or null.

0 – 9007199254740991

post.trail.blog.postCountintegernullable

Published blog post count, or null.

0 – 9007199254740991

post.trail.blog.totalPostsintegernullable

Published total post count, or null.

0 – 9007199254740991

post.trail.blog.isAdultbooleannullable

Source adult-content flag, or null.

post.trail.blog.isNsfwbooleannullable

Source sensitive-content flag, or null.

post.trail.blog.isBrandSafebooleannullable

Source brand-safety flag, or null.

post.trail.blog.isPasswordProtectedbooleannullable

Source password-protection flag, or null.

post.trail.blog.shouldBlurbooleannullable

Source content-blur flag, or null.

post.trail.blog.allowSearchIndexingbooleannullable

Source search-indexing setting, or null.

post.trail.blog.isHiddenFromBlogNetworkbooleannullable

Source blog-network visibility flag, or null.

post.trail.blog.shareFollowingbooleannullable

Published following-list visibility setting, or null.

post.trail.blog.shareLikesbooleannullable

Published liked-post visibility setting, or null.

post.trail.blog.shareRepliesbooleannullable

Published reply-sharing setting, or null.

post.trail.blog.askbooleannullable

Whether asks are enabled, or null.

post.trail.blog.askAnonbooleannullable

Whether anonymous asks are enabled, or null.

post.trail.blog.asksAllowMediabooleannullable

Whether asks allow media, or null.

post.trail.blog.askPageTitlestringnullable

Published ask-page title, or null.

post.trail.blog.canMessagebooleannullable

Source messaging capability flag, or null.

post.trail.blog.canSubscribebooleannullable

Source subscription capability flag, or null.

post.trail.blog.canBeFollowedbooleannullable

Source follow capability flag, or null.

post.trail.blog.canShowBadgesbooleannullable

Source badge-display flag, or null.

post.trail.blog.replyConditionsstringnullable

Published reply policy, or null.

post.trail.blog.linkedAccountsobject[]nullable

Published linked-account metadata, or null.

post.rebloggedFromIdstringnullable

Immediate parent post ID, or null.

post.rebloggedFromUrlstringnullable

Immediate parent post permalink, or null.

post.rebloggedFromNamestringnullable

Immediate parent blog handle, or null.

post.rebloggedFromTitlestringnullable

Immediate parent blog title, or null.

post.rebloggedFromUuidstringnullable

Immediate parent blog UUID, or null.

post.rebloggedRootIdstringnullable

Original root post ID, or null.

post.rebloggedRootUrlstringnullable

Original root post permalink, or null.

post.rebloggedRootNamestringnullable

Original root blog handle, or null.

post.rebloggedRootTitlestringnullable

Original root blog title, or null.

post.rebloggedRootUuidstringnullable

Original root blog UUID, or null.

post.isBlocksPostFormatbooleannullable

Whether the post uses Neue Post Format, or null.

post.isNsfwbooleannullable

Source sensitive-content flag, or null.

post.classificationstringnullable

Published source content classification, or null.

post.isCommercialbooleannullable

Source commercial-content flag, or null.

post.isBlazedbooleannullable

Source promoted-post flag, or null.

post.isBrandSafebooleannullable

Source brand-safety flag, or null.

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

post.communityLabels.hasCommunityLabelbooleannullable

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

post.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.

Public community metadata for a community post.

post.community.namestring

Community URL slug.

post.community.uuidstringnullable

Source community UUID, or null.

post.community.titlestringnullable

Published community title, or null.

post.community.descriptionstringnullable

Published community description, or null.

post.community.aboutstringnullable

Published community about text, or null.

post.community.guidelinesSummarystringnullable

Published guidelines summary, or null.

post.community.visibilitystringnullable

Published community visibility, or null.

post.community.joinTypestringnullable

Published community joining policy, or null.

post.community.languagestringnullable

Published community language, or null.

post.community.locationstringnullable

Published community location, or null.

post.community.mentionTagstringnullable

Published community mention tag, or null.

post.community.createdTsintegernullable

Community creation time in Unix seconds, or null.

0 – 9007199254740991

post.community.memberCountintegernullable

Published community member count, or null.

0 – 9007199254740991

post.community.membersOnlineCountintegernullable

Published online-member count, or null.

0 – 9007199254740991

post.community.postCountintegernullable

Published community post count, or null.

0 – 9007199254740991

post.community.populationCapintegernullable

Published community membership capacity, or null.

0 – 9007199254740991

post.community.canViewbooleannullable

Source community-viewing capability flag, or null.

post.community.canViewCommentsbooleannullable

Source community-comment viewing capability flag, or null.

post.community.hasContentLabelbooleannullable

Whether the community has a source content label, or null.

post.community.avatarImageobject[]nullable

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

post.community.headerImageobject[]nullable

Published community header-image variants with URLs and dimensions, or null.

post.community.guidelinesstring[]nullable

Published community guidelines in source order, or null.

post.community.tagsstring[]nullable

Published community tags in source order, or null.

Public Tumblr blog details.

post.authorBlog.namestring

Blog handle.

post.authorBlog.uuidstringnullable

Source blog UUID, or null.

post.authorBlog.titlestringnullable

Published blog title, or null.

post.authorBlog.urlstringnullable

Blog URL, or null.

post.authorBlog.canonicalUrlstringnullable

Canonical Tumblr blog URL, or null.

post.authorBlog.blogViewUrlstringnullable

Source blog-view URL, or null.

post.authorBlog.descriptionstringnullable

Published plain-text description, or null.

post.authorBlog.descriptionNpfobject[]nullable

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

post.authorBlog.avatarobject[]nullable

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

post.authorBlog.themeobjectnullable

Published theme settings, or null.

post.authorBlog.tumblrmartAccessoriesobjectnullable

Published blog accessory metadata, or null.

post.authorBlog.topTagsobject[]nullable

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

post.authorBlog.createdintegernullable

Blog creation time in Unix seconds, or null.

0 – 9007199254740991

post.authorBlog.updatedintegernullable

Blog update time in Unix seconds, or null.

0 – 9007199254740991

post.authorBlog.postCountintegernullable

Published blog post count, or null.

0 – 9007199254740991

post.authorBlog.totalPostsintegernullable

Published total post count, or null.

0 – 9007199254740991

post.authorBlog.isAdultbooleannullable

Source adult-content flag, or null.

post.authorBlog.isNsfwbooleannullable

Source sensitive-content flag, or null.

post.authorBlog.isBrandSafebooleannullable

Source brand-safety flag, or null.

post.authorBlog.isPasswordProtectedbooleannullable

Source password-protection flag, or null.

post.authorBlog.shouldBlurbooleannullable

Source content-blur flag, or null.

post.authorBlog.allowSearchIndexingbooleannullable

Source search-indexing setting, or null.

post.authorBlog.isHiddenFromBlogNetworkbooleannullable

Source blog-network visibility flag, or null.

post.authorBlog.shareFollowingbooleannullable

Published following-list visibility setting, or null.

post.authorBlog.shareLikesbooleannullable

Published liked-post visibility setting, or null.

post.authorBlog.shareRepliesbooleannullable

Published reply-sharing setting, or null.

post.authorBlog.askbooleannullable

Whether asks are enabled, or null.

post.authorBlog.askAnonbooleannullable

Whether anonymous asks are enabled, or null.

post.authorBlog.asksAllowMediabooleannullable

Whether asks allow media, or null.

post.authorBlog.askPageTitlestringnullable

Published ask-page title, or null.

post.authorBlog.canMessagebooleannullable

Source messaging capability flag, or null.

post.authorBlog.canSubscribebooleannullable

Source subscription capability flag, or null.

post.authorBlog.canBeFollowedbooleannullable

Source follow capability flag, or null.

post.authorBlog.canShowBadgesbooleannullable

Source badge-display flag, or null.

post.authorBlog.replyConditionsstringnullable

Published reply policy, or null.

post.authorBlog.linkedAccountsobject[]nullable

Published linked-account metadata, or null.

post.postAuthorstringnullableoptional

Published author blog handle, or null.

post.postAuthorAvatarobject[]nullableoptional

Published post-author avatar variants, or null.

post.isPinnedbooleannullableoptional

Whether the post is pinned in the community, or null.

post.selfReplyCountintegernullableoptional

Published self-reply count, or null.

0 – 9007199254740991

post.reactionsobject[]optional

Public reaction records with emoji metadata, counts and previews.

up to 100 items

post.facepileobject[]optional

Native public engagement-preview records in source order.

up to 100 items

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
13
HTTPfailure.codeMeaning
200partialUsable data with more_available, item_limit, non_post_items_omitted, unknown_note_type or field_limit coverage warnings.
400invalid_requestMissing, duplicate, malformed, unsafe or unsupported request parameters.
401unauthorizedMissing or invalid service API key.
404not_foundThe requested public blog, post or community was not found.
422restricted_pageThe requested primary object is access-restricted.
422unsupported_pageThe source layout or identity could not be mapped to the contract.
502upstream_challengedThe source challenged retrieval.
502upstream_rate_limitedThe source rate-limited retrieval.
502upstream_errorSource retrieval could not complete.
502response_too_large payload_too_complexSource data exceeded the byte or parsing limits.
502unsafe_redirect request_limitThe source redirect or request sequence exceeded the accepted contract.
503busyRequest capacity or queue wait was exceeded.
504timeoutThe total operation deadline expired.