Get a Tumblr post
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.
/v1/tumblr/postx-api-keyHeaders
Get your API keyYour ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.
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
https://www.tumblr.com/communities/example-community/post/123456789012345678True when usable data is returned; inspect status and coverage.
success or partial for usable data; failed or challenged for a failure response.
one of: success, partial
Request correlation UUID.
Canonical public URL for the requested blog, post, search, tag or community.
UTC retrieval timestamp.
Returned-result coverage and extraction warnings.
Public Tumblr web data.
Whether this returned result has no reported omissions.
Named extraction and pagination warnings.
Reported result ordering when available.
Source request attempts, decoded bytes and elapsed milliseconds.
Number of upstream request attempts.
≥ 0
Decoded source bytes read during this request.
≥ 0
Elapsed request time in milliseconds.
≥ 0
Public Tumblr blog-post or community-post details.
Post ID as a decimal string.
Publishing blog handle.
Public Tumblr blog details.
Blog handle.
Source blog UUID, or null.
Published blog title, or null.
Blog URL, or null.
Canonical Tumblr blog URL, or null.
Source blog-view URL, or null.
Published plain-text description, or null.
Description content blocks in Tumblr Neue Post Format, or null.
Published avatar variants with source URLs and dimensions, or null.
Published theme settings, or null.
Published blog accessory metadata, or null.
Published top-tag records in source order, or null.
Blog creation time in Unix seconds, or null.
0 – 9007199254740991
Blog update time in Unix seconds, or null.
0 – 9007199254740991
Published blog post count, or null.
0 – 9007199254740991
Published total post count, or null.
0 – 9007199254740991
Source adult-content flag, or null.
Source sensitive-content flag, or null.
Source brand-safety flag, or null.
Source password-protection flag, or null.
Source content-blur flag, or null.
Source search-indexing setting, or null.
Source blog-network visibility flag, or null.
Published following-list visibility setting, or null.
Published liked-post visibility setting, or null.
Published reply-sharing setting, or null.
Whether asks are enabled, or null.
Whether anonymous asks are enabled, or null.
Whether asks allow media, or null.
Published ask-page title, or null.
Source messaging capability flag, or null.
Source subscription capability flag, or null.
Source follow capability flag, or null.
Source badge-display flag, or null.
Published reply policy, or null.
Published linked-account metadata, or null.
Source post type, or null.
Source original post type, or null.
Canonical post permalink, or null.
Parent post permalink, or null.
Published short URL, or null.
Published embed URL, or null.
Post URL slug, or null.
Source publication date text, or null.
Publication time in Unix seconds, or null.
0 – 9007199254740991
Published post summary, or null.
Source publication state, or null.
Post tags in source order.
up to 200 items
Structured source tag metadata, or null.
Published total note count, or null.
0 – 9007199254740991
Published like count, or null.
0 – 9007199254740991
Published reblog count, or null.
0 – 9007199254740991
Published reply count, or null.
0 – 9007199254740991
Native Neue Post Format content blocks, including text, formatting, media references and source metadata.
up to 500 items
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
Native ancestor content blocks.
up to 500 items
Native ancestor layout metadata.
up to 100 items
Source ancestor-post metadata, or null.
Public Tumblr blog details.
Blog handle.
Source blog UUID, or null.
Published blog title, or null.
Blog URL, or null.
Canonical Tumblr blog URL, or null.
Source blog-view URL, or null.
Published plain-text description, or null.
Description content blocks in Tumblr Neue Post Format, or null.
Published avatar variants with source URLs and dimensions, or null.
Published theme settings, or null.
Published blog accessory metadata, or null.
Published top-tag records in source order, or null.
Blog creation time in Unix seconds, or null.
0 – 9007199254740991
Blog update time in Unix seconds, or null.
0 – 9007199254740991
Published blog post count, or null.
0 – 9007199254740991
Published total post count, or null.
0 – 9007199254740991
Source adult-content flag, or null.
Source sensitive-content flag, or null.
Source brand-safety flag, or null.
Source password-protection flag, or null.
Source content-blur flag, or null.
Source search-indexing setting, or null.
Source blog-network visibility flag, or null.
Published following-list visibility setting, or null.
Published liked-post visibility setting, or null.
Published reply-sharing setting, or null.
Whether asks are enabled, or null.
Whether anonymous asks are enabled, or null.
Whether asks allow media, or null.
Published ask-page title, or null.
Source messaging capability flag, or null.
Source subscription capability flag, or null.
Source follow capability flag, or null.
Source badge-display flag, or null.
Published reply policy, or null.
Published linked-account metadata, or null.
Immediate parent post ID, or null.
Immediate parent post permalink, or null.
Immediate parent blog handle, or null.
Immediate parent blog title, or null.
Immediate parent blog UUID, or null.
Original root post ID, or null.
Original root post permalink, or null.
Original root blog handle, or null.
Original root blog title, or null.
Original root blog UUID, or null.
Whether the post uses Neue Post Format, or null.
Source sensitive-content flag, or null.
Published source content classification, or null.
Source commercial-content flag, or null.
Source promoted-post flag, or null.
Source brand-safety flag, or null.
Published community-label status and categories as an object or array of objects, or null when absent.
Whether the source marks the post with a community label; null when absent.
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.
Community URL slug.
Source community UUID, or null.
Published community title, or null.
Published community description, or null.
Published community about text, or null.
Published guidelines summary, or null.
Published community visibility, or null.
Published community joining policy, or null.
Published community language, or null.
Published community location, or null.
Published community mention tag, or null.
Community creation time in Unix seconds, or null.
0 – 9007199254740991
Published community member count, or null.
0 – 9007199254740991
Published online-member count, or null.
0 – 9007199254740991
Published community post count, or null.
0 – 9007199254740991
Published community membership capacity, or null.
0 – 9007199254740991
Source community-viewing capability flag, or null.
Source community-comment viewing capability flag, or null.
Whether the community has a source content label, or null.
Published community avatar variants with URLs and dimensions, or null.
Published community header-image variants with URLs and dimensions, or null.
Published community guidelines in source order, or null.
Published community tags in source order, or null.
Public Tumblr blog details.
Blog handle.
Source blog UUID, or null.
Published blog title, or null.
Blog URL, or null.
Canonical Tumblr blog URL, or null.
Source blog-view URL, or null.
Published plain-text description, or null.
Description content blocks in Tumblr Neue Post Format, or null.
Published avatar variants with source URLs and dimensions, or null.
Published theme settings, or null.
Published blog accessory metadata, or null.
Published top-tag records in source order, or null.
Blog creation time in Unix seconds, or null.
0 – 9007199254740991
Blog update time in Unix seconds, or null.
0 – 9007199254740991
Published blog post count, or null.
0 – 9007199254740991
Published total post count, or null.
0 – 9007199254740991
Source adult-content flag, or null.
Source sensitive-content flag, or null.
Source brand-safety flag, or null.
Source password-protection flag, or null.
Source content-blur flag, or null.
Source search-indexing setting, or null.
Source blog-network visibility flag, or null.
Published following-list visibility setting, or null.
Published liked-post visibility setting, or null.
Published reply-sharing setting, or null.
Whether asks are enabled, or null.
Whether anonymous asks are enabled, or null.
Whether asks allow media, or null.
Published ask-page title, or null.
Source messaging capability flag, or null.
Source subscription capability flag, or null.
Source follow capability flag, or null.
Source badge-display flag, or null.
Published reply policy, or null.
Published linked-account metadata, or null.
Published author blog handle, or null.
Published post-author avatar variants, or null.
Whether the post is pinned in the community, or null.
Published self-reply count, or null.
0 – 9007199254740991
Public reaction records with emoji metadata, counts and previews.
up to 100 items
Native public engagement-preview records in source order.
up to 100 items
No fields match.
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.
| 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. |