Build with Micro.blog logo
Build with Micro.blog
API Documentation

Mentions

View .md

Endpoints for mentions and blocked mention feeds.

BASE URL https://micro.blog
GET /posts/mentions

Returns mentions for the authenticated user.

Example Request

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

Query Parameters

Name Type Required Description
since_id integer Optional Only return posts newer than this post ID.
Example: 10203852
before_id integer Optional Only return posts older than this post ID.
Example: 9853826
count integer Optional Maximum number of items to return.
Example: 5

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 response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions",
  "items": []
}
GET /posts/mentions/blocked

Returns blocked or hidden mentions for the authenticated user.

Example Request

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

Query Parameters

Name Type Required Description
since_id integer Optional Only return posts newer than this post ID.
Example: 10203852
before_id integer Optional Only return posts older than this post ID.
Example: 9853826
count integer Optional Maximum number of items to return.
Example: 5

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 response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/mentions/blocked",
  "items": []
}
GET /posts/mentions/bluesky

Returns Bluesky mentions in JSON Feed format.

Example Request

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

Query Parameters

Name Type Required Description
count integer Optional count parameter.
Example: example
since_id string Optional Only return posts newer than this post ID.
Example: 77479242
before_id string Optional Only return posts older than this post ID.
Example: 9853826

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 response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
GET /posts/mentions/mastodon

Returns Mastodon mentions in JSON Feed format.

Example Request

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

Query Parameters

Name Type Required Description
count integer Optional count parameter.
Example: example
since_id string Optional Only return posts newer than this post ID.
Example: 77479242
before_id string Optional Only return posts older than this post ID.
Example: 9853826

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 response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
GET /posts/mentions/mb

Returns Micro.blog mentions in JSON Feed format.

Example Request

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

Query Parameters

Name Type Required Description
count integer Optional count parameter.
Example: example
since_id string Optional Only return posts newer than this post ID.
Example: 77479242
before_id string Optional Only return posts older than this post ID.
Example: 9853826

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 response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
POST /posts/mentions/{id}

Updates mention visibility metadata.

Example Request

curl -X POST "https://micro.blog/posts/mentions/{id}" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name Type Required Description
is_hidden_for_blog integer Optional Whether a mention should be hidden from the blog.
Example: 1

Header Parameters

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

Path Parameters

Name Type Required Description
id integer Required Resource identifier.
Example: 12345

Response

200 OK application/json

Returns an empty JSON object on success.

Example Response

{}