# 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. Unofficial. Not affiliated with or endorsed by Mastodon. - Page: https://fous.com/methods/mastodon.social/list-recent-posts - Method: `mastodon.social/list_recent_posts`, version 1 - Website: mastodon.social - Returns: text, content warning, date, counts, boost info, images, link, id - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `account` | string | yes | `"Gargron@mastodon.social"` | Full account handle including server, or a profile link, such as Gargron@mastodon.social. | | `max_results` | integer | no | | Maximum number of posts to return, for example 20. Default 20. | | `include_boosts` | boolean | no | | Include boosts, for example true. Default false. | | `include_replies` | boolean | no | | Include replies, for example true. Default false. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "account": "Gargron@mastodon.social" } ``` Its output: ```json { "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 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"mastodon.social/list_recent_posts","input":{"account":"Gargron@mastodon.social"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "type": "object", "required": [ "account" ], "properties": { "account": { "type": "string", "description": "Full account handle including server, or a profile link, such as Gargron@mastodon.social." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of posts to return, for example 20." }, "include_boosts": { "type": "boolean", "default": false, "description": "Include boosts, for example true." }, "include_replies": { "type": "boolean", "default": false, "description": "Include replies, for example true." } } } ``` ## Output schema ```json { "type": "object", "required": [ "posts" ], "properties": { "posts": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "boosts": { "type": "integer" }, "post_id": { "type": "string" }, "replies": { "type": "integer" }, "is_boost": { "type": "boolean" }, "post_link": { "type": "string" }, "posted_at": { "type": "string" }, "favourites": { "type": "integer" }, "image_links": { "type": "array", "items": { "type": "string" } }, "content_warning": { "type": [ "string", "null" ] }, "original_author": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [Mastodon API: List hashtag posts](https://fous.com/methods/mastodon.social/list-hashtag-posts.md): Lists the latest public posts for a hashtag on a Mastodon server, newest first. Some servers require login for public timelines. - [Mastodon API: Get profile](https://fous.com/methods/mastodon.social/get-profile.md): 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. - [Bluesky API: List recent posts](https://fous.com/methods/bsky.app/list-recent-posts.md): 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. - [Threads API: List recent posts](https://fous.com/methods/threads.com/list-recent-posts.md): 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. - [Instagram API: List recent posts](https://fous.com/methods/instagram.com/list-recent-posts.md): 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. - [Medium API: List a writer's or publication's latest articles](https://fous.com/methods/medium.com/list-author-articles.md): 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. - [Tumblr API: List blog posts](https://fous.com/methods/tumblr.com/list-blog-posts.md): Lists recent public posts of a Tumblr blog, optionally only those with a given tag. Private or login-only blogs cannot be read. - [Telegram API: List channel posts](https://fous.com/methods/t.me/list-channel-posts.md): Lists the latest posts from a public Telegram channel preview, with text, posting time, approximate views, edit flag, forwarded source, thumbnails and post links. - [All Mastodon methods](https://fous.com/methods/mastodon.social.md)