API Documentation

Conversations

Endpoints for resolving and reading Micro.blog conversation threads.

BASE URL


                  https://micro.blog

GET


                          /conversation.js

Looks up a conversation for a post URL and returns it in the requested format.

Example Request

curl -X GET "https://micro.blog/conversation.js?url=https%3A%2F%2Fvincentritter.com%2F2022%2F03%2F29%2F16-09-31&format=jsonfeed"

Query Parameters

Name	Type	Required	Description
`url`	string	Required	URL to look up or modify. Example: `https://vincentritter.com/2022/03/29/16-09-31`
`format`	string	Optional	Response format. Example: `jsonfeed`

Response

200 OK application/json

Returns conversation data in the requested format.

Example Response

{
  "version": "https://jsonfeed.org/version/1",
  "title": "Conversation",
  "home_page_url": "https://micro.blog/vincent/12345",
  "feed_url": "https://micro.blog/conversation.js?url=https%3A%2F%2Fexample.com%2Fpost&format=jsonfeed",
  "items": [
    {
      "id": "98765",
      "content_html": "<p>@vincent Thanks!</p>",
      "url": "https://example.org/reply",
      "date_published": "2026-04-26T12:00:00+00:00",
      "author": {
        "name": "Manton Reece",
        "url": "https://manton.org/",
        "avatar": "https://avatars.micro.blog/avatars/2025/22/3.jpg",
        "_microblog": {
          "username": "manton"
        }
      }
    }
  ]
}

GET


                          /posts/conversation

Returns the conversation thread for a post, mention, favourite, or thread ID.

Example Request

curl -X GET "https://micro.blog/posts/conversation?id=88924898" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name	Type	Required	Description
`id`	integer	Required	Identifier for the resource. Example: `88924898`

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/conversation",
  "items": []
}