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

Micro.blog API Documentation

Explore Micro.blog API endpoints for authentication, timelines, posting, bookmarks, notes, books, feeds, themes, discovery, account settings, and IndieWeb protocols.

Available APIs

Authentication

Email sign-in, token verification, and IndieAuth endpoints.

Account

Endpoints for account preferences and account-level API settings.

Posts

Endpoints for the timeline, single posts, photos and media, replies, user profiles, search, and post deletion.

Posting and Micropub

Endpoints for publishing, replying, uploading media, and querying Micropub resources.

Microsub

Microsub endpoints for channels, timelines, feed subscriptions, and read state.

Discover

Endpoints for the curated Discover timeline, topic feeds, featured photos, books, best sellers, and slow reads.

Mentions

Endpoints for mentions, split by network, and mentions held back by moderation.

Bookmarks

Endpoints for bookmarks, bookmark tags, bookmark highlights, Listen Later episodes, and saved Reader pages.

Blocking and Reporting

Endpoints for reporting users, blocking users, and muting users, domains, keywords, and conversations.

Users and Relationships

Endpoints for following, relationship checks, user search, follow suggestions, and the activity log.

Profile

Endpoints for profile images and pins.

Themes

Endpoints for browsing and editing a blog's custom themes, plug-in templates, built-in theme templates, and custom CSS.

Markers

Endpoints for reading and updating timeline marker positions.

Conversations

Endpoints for resolving and reading Micro.blog conversation threads.

Books and Bookshelves

Endpoints for book search, bookshelves, bookshelf assignments, reading goals, and the reading calendar.

Push Notifications

Endpoints for registering, unregistering, and inspecting push notification devices.

Feeds and Reader

Feedbin-compatible reader endpoints, reader highlights, AI recaps, and public JSON and RSS feeds.

Notes

Endpoints for private notes, notebooks, note versions, and audio note transcription.

Movies

Endpoints for recent movie and TV activity, TMDB search, and post text for watched movies and episodes.

Status

Health check endpoint for Micro.blog.

Twitter Archive

Public endpoints for reading the tweets on a blog made from an imported Twitter archive.

Webmention

Endpoints for receiving webmentions and reading the replies to a post.

XML-RPC

XML-RPC endpoint for MetaWeblog and Micro.blog-compatible clients.