# Mastodon API: List hashtag posts > Lists the latest public posts for a hashtag on a Mastodon server, newest first. Some servers require login for public timelines. Unofficial. Not affiliated with or endorsed by Mastodon. - Page: https://fous.com/methods/mastodon.social/list-hashtag-posts - Method: `mastodon.social/list_hashtag_posts`, version 1 - Website: mastodon.social - Returns: posts with author, text, time, boost, favourite and reply counts, image links and post link - 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 | |---|---|---|---|---| | `server` | string | no | `"mastodon.social"` | Mastodon server to read, such as fosstodon.org. Defaults to mastodon.social. Default "mastodon.social". | | `hashtag` | string | yes | `"photography"` | Hashtag, with or without #, such as climate. | | `max_results` | integer | no | `55` | Maximum posts to return, such as 20; at most 100. Default 20. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "server": "mastodon.social", "hashtag": "photography", "max_results": 55 } ``` Its output: ```json { "posts": [ { "text": "Old San Juan, Puerto Rico\n#People #photography #StreetPhotography #urbanPhotography #SanJuan #PuertoRico", "boosts": 0, "post_id": "117489511436858646", "replies": 0, "post_link": "https://mstdn.social/@alexf24/117489511341283936", "posted_at": "2026-10-23T09:27:50Z", "favourites": 0, "image_links": [ "https://files.mastodon.social/cache/media_attachments/files/117/489/511/396/699/020/original/82322ba822b3421e.jpg" ], "author_handle": "@alexf24@mstdn.social", "author_display_name": "Alexf24" }, { "text": "📷 A photograph of a Formosan Blue Magpie carrying a coathanger is a finalist in the Wildlife Photographer of the Year competition\nThe photographer, Mary Bell, spent three years observing the birds to capture the image\nhttps://www.nhm.ac.uk/wpy/wpy/gallery/2026-urban-architect?tags=ed.current\n#Taiwa…", "boosts": 0, "post_id": "117489503438295612", "replies": 1, "post_link": "https://mstdn.social/@davidonformosa/117489503380659682", "posted_at": "2026-10-23T09:25:49Z", "favourites": 0, "image_links": [], "author_handle": "@davidonformosa@mstdn.social", "author_display_name": "David on Formosa" }, { "text": "#nature #photography #darktable", "boosts": 0, "post_id": "117489485711046508", "replies": 0, "post_link": "https://pixelfed.social/p/noname98571/1019175918547577846", "posted_at": "2026-10-23T09:21:14Z", "favourites": 0, "image_links": [ "https://files.mastodon.social/cache/media_attachments/files/117/489/485/603/350/942/original/b72fe501671f35cd.jpg" ], "author_handle": "@noname98571@pixelfed.social", "author_display_name": "noname98571" } ] } ``` ## 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_hashtag_posts","input":{"server":"mastodon.social","hashtag":"photography","max_results":55}}' ``` 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 tagged #sourdough on mastodon.social, newest first, with boost and favourite counts. - What are people posting right now under the hashtag #retrogaming? Give me 25 recent posts with author and post link. - Pull up the newest posts about #birdwatching from fosstodon.org, including any image links. - I want to see the last 10 toots tagged with #linuxmint along with how many replies each got. - Can you list up to 50 recent posts for the hashtag climate, showing text, time posted and the link to each post? ## Input schema ```json { "type": "object", "required": [ "hashtag" ], "properties": { "server": { "type": "string", "default": "mastodon.social", "description": "Mastodon server to read, such as fosstodon.org. Defaults to mastodon.social." }, "hashtag": { "type": "string", "minLength": 1, "description": "Hashtag, with or without #, such as climate." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum posts to return, such as 20; at most 100." } } } ``` ## Output schema ```json { "type": "object", "required": [ "posts" ], "properties": { "posts": { "type": "array", "items": { "type": "object", "required": [ "author_handle", "author_display_name", "text", "posted_at", "boosts", "favourites", "replies", "image_links", "post_id" ], "properties": { "text": { "type": "string", "description": "Post text without markup." }, "boosts": { "type": "integer", "description": "Number of boosts." }, "post_id": { "type": "string", "description": "Post ID on the selected server." }, "replies": { "type": "integer", "description": "Number of replies." }, "post_link": { "type": "string", "description": "Page link for this post." }, "posted_at": { "type": "string", "format": "date-time", "description": "Post time in UTC." }, "favourites": { "type": "integer", "description": "Number of favourites." }, "image_links": { "type": "array", "items": { "type": "string" }, "description": "Links to attached images." }, "author_handle": { "type": "string", "description": "Author handle including server." }, "author_display_name": { "type": "string", "description": "Author display name." } } }, "description": "Latest public posts for the hashtag, newest first." } } } ``` ## See more - [Mastodon API: List recent posts](https://fous.com/methods/mastodon.social/list-recent-posts.md): Lists a Mastodon account's latest public posts, newest first. Replies and boosts are optional. Private and unlisted posts are left out. - [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. - [TikTok API: List trending hashtags](https://fous.com/methods/ads.tiktok.com/list-trending-hashtags.md): Lists publicly visible TikTok Creative Center trending hashtags by country, time period and industry. Anonymous visitors see at most three rows; rank change and new-entry status are not public and come back null. - [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. - [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. - [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. - [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. - [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. - [All Mastodon methods](https://fous.com/methods/mastodon.social.md)