API Documentation

Mentions

Endpoints for the authenticated user’s mentions, all together or split by network, and for mentions held back by moderation. Every endpoint needs an app token with the read scope and allows cross-origin requests. Requests without a token return 401 with the text Token required.

Note: Items have the same shape as GET /posts/all. _microblog.is_mention is false for Micro.blog posts and true for replies that arrived by Webmention, Mastodon, or Bluesky. Each request reads the 40 most recent mentions, or the 40 before before_id, so a page can hold fewer than count items after filtering.

BASE URL


                  https://micro.blog

GET


                          /posts/mentions

Returns posts that mention the authenticated user from every network, newest first, in JSON Feed format. Checks Mastodon and Bluesky for new mentions before answering. Page backwards with before_id.

Example Request

curl -X GET "https://micro.blog/posts/mentions?count=20" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Query Parameters

Name	Type	Required	Description
`count`	integer	Optional	Maximum number of posts to return. Example: `20`
`since_id`	integer	Optional	Only return posts published after this post. Example: `77479242`
`before_id`	integer	Optional	Only return posts published before this post. Use the last `id` from the previous page to load older mentions. Example: `77494371`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed object.

Example Response

{
  "version": "https://jsonfeed.org/version/1",
  "title": "Micro.blog - Mentions",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions",
  "_microblog": {
    "about": "https://micro.blog/about/api"
  },
  "items": [
    {
      "id": "77494371",
      "content_html": "<p><a href=\"https://micro.blog/vincent\">@vincent</a> Thanks, that fixed it for me.</p>",
      "url": "https://www.manton.org/2026/04/26/thanks-that-fixed.html",
      "date_published": "2026-04-26T12:00:00+00:00",
      "author": {
        "name": "Manton Reece",
        "url": "https://manton.org",
        "avatar": "https://avatars.micro.blog/avatars/2026/22/3.jpg",
        "_microblog": {
          "username": "manton"
        }
      },
      "_microblog": {
        "date_relative": "12:00",
        "date_timestamp": 1777204800,
        "is_favorite": false,
        "is_bookmark": false,
        "is_deletable": false,
        "is_conversation": true,
        "is_linkpost": false,
        "is_mention": false
      }
    }
  ]
}

GET


                          /posts/mentions/mb

Returns mentions from Micro.blog users only, in JSON Feed format. Takes the same parameters as GET /posts/mentions.

Note: The Micro.blog filter only applies to the first page. A request with before_id returns mentions from every network.

Example Request

curl -X GET "https://micro.blog/posts/mentions/mb" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Query Parameters

Name	Type	Required	Description
`count`	integer	Optional	Maximum number of posts to return. Example: `20`
`since_id`	integer	Optional	Only return posts published after this post. Example: `77479242`
`before_id`	integer	Optional	Only return posts published before this post. Example: `77494371`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed object. Items have the same shape as GET /posts/mentions.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Micro.blog mentions",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions/mb",
  "_microblog": {
    "about": "https://micro.blog/about/api"
  },
  "items": []
}

GET


                          /posts/mentions/mastodon

Returns mentions from Mastodon and other fediverse accounts only, in JSON Feed format. Takes the same parameters as GET /posts/mentions. Unlike that endpoint, it does not check Mastodon for new mentions first.

Example Request

curl -X GET "https://micro.blog/posts/mentions/mastodon" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Query Parameters

Name	Type	Required	Description
`count`	integer	Optional	Maximum number of posts to return. Example: `20`
`since_id`	integer	Optional	Only return posts published after this post. Example: `77479242`
`before_id`	integer	Optional	Only return posts published before this post. Example: `77494371`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed object. Items have the same shape as GET /posts/mentions.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Mastodon mentions",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions/mastodon",
  "_microblog": {
    "about": "https://micro.blog/about/api"
  },
  "items": []
}

GET


                          /posts/mentions/bluesky

Returns mentions from Bluesky only, in JSON Feed format. Takes the same parameters as GET /posts/mentions. Unlike that endpoint, it does not check Bluesky for new mentions first.

Example Request

curl -X GET "https://micro.blog/posts/mentions/bluesky" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Query Parameters

Name	Type	Required	Description
`count`	integer	Optional	Maximum number of posts to return. Example: `20`
`since_id`	integer	Optional	Only return posts published after this post. Example: `77479242`
`before_id`	integer	Optional	Only return posts published before this post. Example: `77494371`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed object. Items have the same shape as GET /posts/mentions.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog - Bluesky mentions",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions/bluesky",
  "_microblog": {
    "about": "https://micro.blog/about/api"
  },
  "items": []
}

GET


                          /posts/mentions/blocked

Returns mentions that Micro.blog’s moderation held back from the user’s mentions timeline, newest first, in JSON Feed format. Returns at most the 40 most recent. There is no count parameter.

Example Request

curl -X GET "https://micro.blog/posts/mentions/blocked" \
  --header "Authorization: Bearer ABCDEF1234567890ABCD"

Query Parameters

Name	Type	Required	Description
`since_id`	integer	Optional	Only return posts published after this post. Example: `77479242`
`before_id`	integer	Optional	Only return posts published before this post. This filters the 40 most recent held-back mentions; it does not reach older ones. Example: `77494371`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed object. Items have the same shape as GET /posts/mentions.

Example Response

{
  "version": "https://jsonfeed.org/version/1",
  "title": "Micro.blog - Blocked mentions",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions/blocked",
  "_microblog": {
    "about": "https://micro.blog/about/api"
  },
  "items": []
}