# Webmention

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

Endpoints for receiving webmentions and reading conversation webmentions.

## Endpoints
### GET /webmention

URL: `https://micro.blog/webmention`

Returns webmentions for a target URL as JSON Feed, JF2, or Microformats data.




Query parameters:
- `target` (string, required): Target URL.
  Example: `https://example.com/post`
- `format` (string, optional): Response format.
  Example: `jsonfeed`






Example request:

```sh
curl -X GET "https://micro.blog/webmention?target=https%3A%2F%2Fexample.com%2Fpost"
```

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

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```

### POST /webmention

URL: `https://micro.blog/webmention`

Receives a Webmention and queues processing.




Query parameters:
- `source` (string, required): Source URL.
  Example: `https://example.org/reply`
- `target` (string, required): Target URL.
  Example: `https://example.com/post`






Example request:

```sh
curl -X POST "https://micro.blog/webmention?source=https%3A%2F%2Fexample.org%2Freply&target=https%3A%2F%2Fexample.com%2Fpost"
```

Response:
- Status: 202
- Content-Type: `text/plain`
- Description: Returns 202 when the Webmention is accepted for processing.
Example response:

```text
(empty response body)
```