# Conversations

Page: https://microblog.dev/api/conversations/
API base URL: https://micro.blog

Endpoints for resolving and reading Micro.blog conversation threads.

## Endpoints
### GET /conversation.js

URL: `https://micro.blog/conversation.js`

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




Query parameters:
- `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`






Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns conversation data in the requested format.
Example response:

```json
{
  "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

URL: `https://micro.blog/posts/conversation`

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




Query parameters:
- `id` (integer, required): Identifier for the resource.
  Example: `88924898`



Header parameters:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON Feed response.
Example response:

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/conversation",
  "items": []
}
```