List posts
Posts on a blog or under a tag, newest first.
GET https://cotlet.dev/api/v1/tumblr/posts
read
Lists published posts of one blog, newest first. Set tag to read posts under a tag instead, from any public blog, and set private to read your private posts. Pages hold up to 20 posts; pass next_cursor back as cursor for the next page. Each item has the post text, tags, note count and the reblog key that reblog_post needs.
Parameters
| Name | Type | Description |
|---|---|---|
| blog string required | string | Blog name, e.g. 'studio-notes' for studio-notes.tumblr.com. Names come from list_blogs. |
| tag string | string | Read posts under this tag instead of the blog own posts. |
| visibility enum | enum | published or private. Default: published. |
| limit integer | integer | 1 to 20. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/tumblr/posts?blog=studio-notes" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("tumblr", "list_posts", {"blog":"studio-notes"})const result = await cotlet.call('tumblr', 'list_posts', {"blog":"studio-notes"});cotlet call tumblr list_posts --data '{"blog":"studio-notes"}'Example response
{
"posts": [
{
"post_id": "7712345600123",
"blog": "pixel-lab",
"type": "image",
"summary": "Harbor town sprite sheet",
"tags": [
"pixel art",
"sprites"
],
"note_count": 842,
"published_at": "2026-10-16T18:40:00Z"
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
}