Get a Tumblr post’s notes

Try in Playground

Retrieve public blog-post replies, likes and reblogs, or community-post replies, with blog identities, avatars, timestamps and published engagement totals. Community replies also include their community metadata. Continue with the returned cursor.

GET/v1/tumblr/post/notesx-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

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

modeenumquery

Optional note view. Blog posts offer all (default), conversation, likes, reblogs_with_tags or rollup. Community replies use conversation (default).

one of: all, conversation, likes, reblogs_with_tags, rollup

Exampleconversation

limitstringquery

Optional number of returned interactions, 1 to 50; default 50.

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

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

postIdstring

Requested post ID as a decimal string.

blogNamestring

Publishing blog handle.

Public community metadata for a community post, or null for a blog post.

community.namestring

Community URL slug.

community.uuidstringnullable

Source community UUID, or null.

community.titlestringnullable

Published community title, or null.

community.descriptionstringnullable

Published community description, or null.

community.aboutstringnullable

Published community about text, or null.

community.guidelinesSummarystringnullable

Published guidelines summary, or null.

community.visibilitystringnullable

Published community visibility, or null.

community.joinTypestringnullable

Published community joining policy, or null.

community.languagestringnullable

Published community language, or null.

community.locationstringnullable

Published community location, or null.

community.mentionTagstringnullable

Published community mention tag, or null.

community.createdTsintegernullable

Community creation time in Unix seconds, or null.

0 – 9007199254740991

community.memberCountintegernullable

Published community member count, or null.

0 – 9007199254740991

community.membersOnlineCountintegernullable

Published online-member count, or null.

0 – 9007199254740991

community.postCountintegernullable

Published community post count, or null.

0 – 9007199254740991

community.populationCapintegernullable

Published community membership capacity, or null.

0 – 9007199254740991

community.canViewbooleannullable

Source community-viewing capability flag, or null.

community.canViewCommentsbooleannullable

Source community-comment viewing capability flag, or null.

community.hasContentLabelbooleannullable

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

community.avatarImageobject[]nullable

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

community.headerImageobject[]nullable

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

community.guidelinesstring[]nullable

Published community guidelines in source order, or null.

community.tagsstring[]nullable

Published community tags in source order, or null.

modeenum

Optional note view. Blog posts offer all (default), conversation, likes, reblogs_with_tags or rollup. Community replies use conversation (default).

one of: all, conversation, likes, reblogs_with_tags, rollup

Public post interactions in source order.

up to 50 items

notes.typestring

Source interaction type, such as reply, like or reblog.

notes.timestampintegernullable

Interaction time in Unix seconds, or null.

0 – 9007199254740991

notes.blogNamestringnullable

Interacting blog handle, or null.

notes.blogUuidstringnullable

Interacting blog UUID, or null.

notes.blogUrlstringnullable

Interacting blog URL, or null.

notes.blogTitlestringnullable

Interacting blog title, or null.

notes.avatarShapestringnullable

Source avatar shape, or null.

notes.avatarUrlobjectnullable

Published avatar-size URL map, or null.

notes.blogIsAdultbooleannullable

Source blog adult-content flag, or null.

notes.shouldBlurbooleannullable

Source content-blur flag, or null.

notes.postIdstringnullable

Associated interaction post ID, or null.

notes.reblogParentBlogNamestringnullable

Reblog parent blog handle, or null.

notes.replyTextstringnullable

Written reply text, or null.

notes.reblogCommentstringnullable

Reblog comment text, or null.

notes.formattingobject[]nullable

Native reply formatting metadata, or null.

notes.isOriginalPosterbooleannullable

Whether the interacting blog is the original post author, or null.

notes.tagsstring[]nullable

Tags attached to the interaction, or null.

Public grouped post interactions in source order.

up to 50 items

Public note records within this interaction group.

up to 50 items

rollupNotes.notes.typestring

Source interaction type, such as reply, like or reblog.

rollupNotes.notes.timestampintegernullable

Interaction time in Unix seconds, or null.

0 – 9007199254740991

rollupNotes.notes.blogNamestringnullable

Interacting blog handle, or null.

rollupNotes.notes.blogUuidstringnullable

Interacting blog UUID, or null.

rollupNotes.notes.blogUrlstringnullable

Interacting blog URL, or null.

rollupNotes.notes.blogTitlestringnullable

Interacting blog title, or null.

rollupNotes.notes.avatarShapestringnullable

Source avatar shape, or null.

rollupNotes.notes.avatarUrlobjectnullable

Published avatar-size URL map, or null.

rollupNotes.notes.blogIsAdultbooleannullable

Source blog adult-content flag, or null.

rollupNotes.notes.shouldBlurbooleannullable

Source content-blur flag, or null.

rollupNotes.notes.postIdstringnullable

Associated interaction post ID, or null.

rollupNotes.notes.reblogParentBlogNamestringnullable

Reblog parent blog handle, or null.

rollupNotes.notes.replyTextstringnullable

Written reply text, or null.

rollupNotes.notes.reblogCommentstringnullable

Reblog comment text, or null.

rollupNotes.notes.formattingobject[]nullable

Native reply formatting metadata, or null.

rollupNotes.notes.isOriginalPosterbooleannullable

Whether the interacting blog is the original post author, or null.

rollupNotes.notes.tagsstring[]nullable

Tags attached to the interaction, or null.

rollupNotes.totalNotesintegernullable

Published total note count for the group, or null.

0 – 9007199254740991

rollupNotes.totalLikesintegernullable

Published total like count for the group, or null.

0 – 9007199254740991

rollupNotes.totalReblogsintegernullable

Published total reblog count for the group, or null.

0 – 9007199254740991

rollupNotes.totalRepliesintegernullable

Published total reply count for the group, or null.

0 – 9007199254740991

rollupNotes.selfRepliesintegernullable

Published self-reply count for the group, or null.

0 – 9007199254740991

totalNotesintegernullable

Published total note count, or null.

0 – 9007199254740991

totalLikesintegernullable

Published total like count, or null.

0 – 9007199254740991

totalReblogsintegernullable

Published total reblog count, or null.

0 – 9007199254740991

totalRepliesintegernullable

Published total reply count, or null.

0 – 9007199254740991

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/post/notes?url=https%3A%2F%2Fwww.tumblr.com%2Fcommunities%2Fexample-community%2Fpost%2F123456789012345678&mode=conversation&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/tumblr/post/notes?url=https%3A%2F%2Fwww.tumblr.com%2Fcommunities%2Fexample-community%2Fpost%2F123456789012345678&mode=conversation&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/post/notes?url=https%3A%2F%2Fwww.tumblr.com%2Fcommunities%2Fexample-community%2Fpost%2F123456789012345678&mode=conversation&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/post/notes",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "url": "https://www.tumblr.com/communities/example-community/post/123456789012345678",
        "mode": "conversation",
        "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/post/notes?url=https%3A%2F%2Fwww.tumblr.com%2Fcommunities%2Fexample-community%2Fpost%2F123456789012345678&mode=conversation&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/post/notes?url=https%3A%2F%2Fwww.tumblr.com%2Fcommunities%2Fexample-community%2Fpost%2F123456789012345678&mode=conversation&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/communities/example-community/post/123456789012345678",
  "fetchedAt": "2026-10-06T00:00:00.000Z",
  "coverage": {
    "source": "public_web",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 1500,
    "durationMs": 300
  },
  "postId": "123456789012345678",
  "blogName": "exampleblog",
  "mode": "conversation",
  "notes": [
    {
      "type": "reply",
      "timestamp": 1791244860,
      "blogName": "example-reader",
      "blogUuid": "t:synthetic-reader",
      "blogUrl": "https://example-reader.tumblr.com/",
      "blogTitle": "Example reader",
      "avatarShape": "circle",
      "avatarUrl": {
        "64": "https://64.media.tumblr.com/synthetic-reader.png"
      },
      "blogIsAdult": false,
      "shouldBlur": false,
      "postId": null,
      "reblogParentBlogName": null,
      "replyText": "Synthetic response.",
      "reblogComment": null,
      "formatting": [],
      "tags": null,
      "isOriginalPoster": false
    }
  ],
  "rollupNotes": [
    {
      "notes": [
        {
          "type": "reply",
          "timestamp": 1791244860,
          "blogName": "example-reader",
          "blogUuid": "t:synthetic-reader",
          "blogUrl": "https://example-reader.tumblr.com/",
          "blogTitle": "Example reader",
          "avatarShape": "circle",
          "avatarUrl": {
            "64": "https://64.media.tumblr.com/synthetic-reader.png"
          },
          "blogIsAdult": false,
          "shouldBlur": false,
          "postId": null,
          "reblogParentBlogName": null,
          "replyText": "Synthetic response.",
          "reblogComment": null,
          "formatting": [],
          "tags": null,
          "isOriginalPoster": false
        }
      ],
      "totalNotes": 1,
      "totalLikes": 0,
      "totalReblogs": 0,
      "totalReplies": 1,
      "selfReplies": null
    }
  ],
  "totalNotes": 12,
  "totalLikes": 8,
  "totalReblogs": 2,
  "totalReplies": 2,
  "nextCursor": null,
  "hasMore": false,
  "community": {
    "name": "example-community",
    "uuid": "c:synthetic-community",
    "title": "Example community",
    "description": "Synthetic art discussion community.",
    "about": "Synthetic community about text.",
    "guidelinesSummary": null,
    "visibility": "public",
    "joinType": null,
    "language": null,
    "location": null,
    "mentionTag": null,
    "createdTs": 1791244800,
    "memberCount": 12,
    "membersOnlineCount": null,
    "postCount": 3,
    "populationCap": null,
    "canView": true,
    "canViewComments": true,
    "hasContentLabel": null,
    "avatarImage": [
      {
        "url": "https://64.media.tumblr.com/synthetic-community-avatar.png",
        "width": 64,
        "height": 64
      }
    ],
    "headerImage": null,
    "guidelines": [
      "Keep discussion relevant."
    ],
    "tags": [
      "art"
    ]
  }
}

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."
  }
}