---
title: "Get a Mastodon feed"
method: GET
path: "/v1/social/mastodon/feed"
tags: ["social"]
---

# Get a Mastodon feed

`GET /v1/social/mastodon/feed`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/social/mastodon/feed`
- Auth: none required

Get the recent public posts from a Mastodon account. Pass the instance and user query parameters to identify the account. No API key or connected account is required, because the posts are public. HTML formatting in the post text is removed before the response is returned.

**Notes.**
- Feed envelope: `stale` (and `staleSince`) beside `data`. Answers are cached at the edge for a few minutes.
- A public account's posts; no connected account is needed.

## Query parameters

- `dt` string, required
- `instance` string, required
- `user` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `posts` object[], required: Up to 12 posts with text.
      - `text` string, required
      - `author` string, required
      - `avatar` string, nullable, required
      - `favourites` integer, required
      - `reblogs` integer, required
      - `createdAt` string, nullable, required: ISO-8601 timestamp (UTC).
      - `image` string, nullable, required
  - `stale` boolean, required: True when the provider failed and this is the last good answer.
  - `staleSince` string: When the stale copy was fetched (only when `stale`).

## Other responses

- `400`: `bad_account`, or `blocked_instance` (not a public server address).
- `401`: Missing, expired or revoked bearer token.
- `404`: The `dt` token is missing or expired.
- `502`: The provider failed and there is no recent copy to serve.
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)