Get post notes

Likes, reblogs and replies on one post.

GET https://cotlet.dev/api/v1/tumblr/posts/{post_id}/notes

read

Returns the notes on one post, newest first, with the totals. Set mode to likes, reblogs_with_tags, conversation or rollup to narrow them; all is the default. Use it for a report of what a post earned.

Parameters

Parameters: get_post_notes
NameTypeDescription
blog string required string Blog name, e.g. 'studio-notes' for studio-notes.tumblr.com. Names come from list_blogs.
post_id string required string Post ID from list_posts, list_queue or list_drafts.
mode enum enum all, likes, conversation, rollup or reblogs_with_tags. Default: all.

Request

cURL
curl "https://cotlet.dev/api/v1/tumblr/posts/post_8c41d2/notes?blog=studio-notes" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("tumblr", "get_post_notes", {"blog":"studio-notes","post_id":"post_8c41d2"})
Node.js
const result = await cotlet.call('tumblr', 'get_post_notes', {"blog":"studio-notes","post_id":"post_8c41d2"});
CLI
cotlet call tumblr get_post_notes --data '{"blog":"studio-notes","post_id":"post_8c41d2"}'

Example response

JSON

{
  "total_notes": 842,
  "total_likes": 610,
  "total_reblogs": 232,
  "notes": [
    {
      "type": "reblog",
      "blog": "tiny-pixels",
      "tags": [
        "pixel art"
      ],
      "at": "2026-10-17T06:55:00Z"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.