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

Webmention

View .md

Endpoints for receiving webmentions and reading conversation webmentions.

BASE URL https://micro.blog
GET /webmention

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

Example Request

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

Query Parameters

Name Type Required Description
target string Required Target URL.
Example: https://example.com/post
format string Optional Response format.
Example: jsonfeed

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

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

Receives a Webmention and queues processing.

Example Request

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

Query Parameters

Name Type Required Description
source string Required Source URL.
Example: https://example.org/reply
target string Required Target URL.
Example: https://example.com/post

Response

202 OK text/plain

Returns 202 when the Webmention is accepted for processing.

Example Response

(empty response body)