Skip to content

Mastodon API: List recent posts

Lists a Mastodon account's latest public posts, newest first. Replies and boosts are optional. Private and unlisted posts are left out.

mastodon.social (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Mastodon.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Account, requiredaccount

Full account handle including server, or a profile link, such as Gargron@mastodon.social.

Gargron@mastodon.social

Max Results optionalmax_results

Maximum number of posts to return, for example 20.

20 (default)

Whole number from 1 to 100.

Include Boosts optionalinclude_boosts

Include boosts, for example true.

false (default)

True or false.

Include Replies optionalinclude_replies

Include replies, for example true.

false (default)

True or false.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "posts": [    {      "text": "RE: https://mastodon.social/@Mastodon/117411420916699261\n30% sold out as of now. Shipping should begin in early November!",      "boosts": 28,      "post_id": "117461922421805136",      "replies": 1,      "is_boost": false,      "post_link": "https://mastodon.social/@Gargron/117461922421805136",      "posted_at": "2026-10-18T12:31:37Z",      "favourites": 46,      "image_links": [],      "content_warning": null,      "original_author": null    },    {      "text": "It’s been a million years since i posted a picture of myself. Taken by @Ameboid.",      "boosts": 51,      "post_id": "117457641525342383",      "replies": 31,      "is_boost": false,      "post_link": "https://mastodon.social/@Gargron/117457641525342383",      "posted_at": "2026-10-17T18:22:55Z",      "favourites": 431,      "image_links": [        "https://files.mastodon.social/media_attachments/files/117/457/624/371/113/321/original/fbe3b78d73917a55.jpeg"      ],      "content_warning": null,      "original_author": null    },    {      "text": "Heh. I misremembered the date--thought it was today, but looks like it was October 5. On that day, 10 years ago, I posted a link to Mastodon on Hacker News, with the title \"Show HN: A new decentralized microblogging platform\". That it made it to the front page ended up bringing the first 5,000 users…",      "boosts": 461,      "post_id": "117452591132778433",      "replies": 21,      "is_boost": false,      "post_link": "https://mastodon.social/@Gargron/117452591132778433",      "posted_at": "2026-10-16T20:58:32Z",      "favourites": 1011,      "image_links": [        "https://files.mastodon.social/media_attachments/files/117/452/536/172/003/130/original/2c6272a37c8b41c4.png"      ],      "content_warning": null,      "original_author": null    }  ]}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
mastodon.social/list_recent_posts
Returns
text, content warning, date, counts, boost info, images, link, id

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method mastodon.social/list_recent_posts with the inputs above.

Ask your agent

  • Show me the latest 15 public posts from Gargron@mastodon.social, including boosts
  • What has the account @jack@mastodon.social posted recently? Include their replies too, up to 30 posts.
  • I want to see the newest 10 toots from a Mastodon user, no replies or reblogs, just their original posts
  • Pull up the last 50 public posts from https://mastodon.social/@Mastodon with replies and boosts included
  • Get recent posts from the account eugen@mastodon.social, limited to 5, newest first
  • Lists the latest public posts for a hashtag on a Mastodon server, newest first. Some servers require login for public timelines.

    mastodon.social/list_hashtag_posts
  • Gets a public Mastodon profile by handle or profile link, with its bio, counts, dates and profile fields. Major servers are read directly. Other servers are looked up through mastodon.social, and their home-server account ID is not available.

    mastodon.social/get_profile
  • Lists an account's latest public Bluesky posts, newest first. Replies and reposts are left out unless requested; a repost's time is when the account reposted it.

    bsky.app/list_recent_posts
  • Lists an account's latest public Threads posts, newest first, with text, engagement counts, thumbnails and links. Only posts shown without logging in are returned.

    threads.com/list_recent_posts
  • Lists the latest publicly embeddable posts and reels from an Instagram account, newest first. Without login Instagram may show fewer posts than requested. View counts that are not available are null.

    instagram.com/list_recent_posts
  • Lists the latest public articles by a Medium writer or publication (by username, publication name or Medium link), with dates, reading times, claps, member-only labels and tags.

    medium.com/list_author_articles
  • Lists recent public posts of a Tumblr blog, optionally only those with a given tag. Private or login-only blogs cannot be read.

    tumblr.com/list_blog_posts
  • Lists the latest posts from a public Telegram channel preview, with text, posting time, approximate views, edit flag, forwarded source, thumbnails and post links.

    t.me/list_channel_posts