Automattic

Automattic Reader API

The reader API from Automattic — 106 operation(s) for reader.

GitHub OpenAPI

Operations 117

GET /wpcom/v2/reader/atmosphere/connections GET /wpcom/v2/reader/atmosphere/connections #
POST /wpcom/v2/reader/atmosphere/connections POST /wpcom/v2/reader/atmosphere/connections #
GET /wpcom/v2/reader/atmosphere/connections/{id} GET /wpcom/v2/reader/atmosphere/connections/{id} #
DELETE /wpcom/v2/reader/atmosphere/connections/{id} DELETE /wpcom/v2/reader/atmosphere/connections/{id} #
POST /wpcom/v2/reader/atmosphere/connections/{id}/blobs POST /wpcom/v2/reader/atmosphere/connections/{id}/blobs #
POST /wpcom/v2/reader/atmosphere/connections/{id}/follows POST /wpcom/v2/reader/atmosphere/connections/{id}/follows #
DELETE /wpcom/v2/reader/atmosphere/connections/{id}/follows/{rkey} DELETE /wpcom/v2/reader/atmosphere/connections/{id}/follows/{rkey} #
POST /wpcom/v2/reader/atmosphere/connections/{id}/likes POST /wpcom/v2/reader/atmosphere/connections/{id}/likes #
DELETE /wpcom/v2/reader/atmosphere/connections/{id}/likes/{rkey} DELETE /wpcom/v2/reader/atmosphere/connections/{id}/likes/{rkey} #
GET /wpcom/v2/reader/atmosphere/connections/{id}/notifications GET /wpcom/v2/reader/atmosphere/connections/{id}/notifications #
POST /wpcom/v2/reader/atmosphere/connections/{id}/posts POST /wpcom/v2/reader/atmosphere/connections/{id}/posts #
DELETE /wpcom/v2/reader/atmosphere/connections/{id}/posts/{rkey} DELETE /wpcom/v2/reader/atmosphere/connections/{id}/posts/{rkey} #
GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor} GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor} #
GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor}/feed GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor}/feed #
GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor}/followers GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor}/followers #
GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor}/follows GET /wpcom/v2/reader/atmosphere/connections/{id}/profile/{actor}/follows #
POST /wpcom/v2/reader/atmosphere/connections/{id}/reposts POST /wpcom/v2/reader/atmosphere/connections/{id}/reposts #
DELETE /wpcom/v2/reader/atmosphere/connections/{id}/reposts/{rkey} DELETE /wpcom/v2/reader/atmosphere/connections/{id}/reposts/{rkey} #
GET /wpcom/v2/reader/atmosphere/connections/{id}/tag/{hashtag}/feed GET /wpcom/v2/reader/atmosphere/connections/{id}/tag/{hashtag}/feed #
GET /wpcom/v2/reader/atmosphere/connections/{id}/thread GET /wpcom/v2/reader/atmosphere/connections/{id}/thread #
GET /wpcom/v2/reader/atmosphere/connections/{id}/timeline GET /wpcom/v2/reader/atmosphere/connections/{id}/timeline #
GET /wpcom/v2/reader/atmosphere/profile/{actor} GET /wpcom/v2/reader/atmosphere/profile/{actor} #
GET /wpcom/v2/reader/atmosphere/profile/{actor}/feed GET /wpcom/v2/reader/atmosphere/profile/{actor}/feed #
GET /wpcom/v2/reader/atmosphere/thread GET /wpcom/v2/reader/atmosphere/thread #
GET /wpcom/v2/reader/fediverse/connections GET /wpcom/v2/reader/fediverse/connections #
GET /wpcom/v2/reader/fediverse/connections/{id} GET /wpcom/v2/reader/fediverse/connections/{id} #
POST /wpcom/v2/reader/fediverse/connections/{id}/follows POST /wpcom/v2/reader/fediverse/connections/{id}/follows #
DELETE /wpcom/v2/reader/fediverse/connections/{id}/follows/{follow_id} DELETE /wpcom/v2/reader/fediverse/connections/{id}/follows/{follow_id} #
GET /wpcom/v2/reader/fediverse/connections/{id}/notifications GET /wpcom/v2/reader/fediverse/connections/{id}/notifications #
POST /wpcom/v2/reader/fediverse/connections/{id}/posts POST /wpcom/v2/reader/fediverse/connections/{id}/posts #
GET /wpcom/v2/reader/fediverse/connections/{id}/profile GET /wpcom/v2/reader/fediverse/connections/{id}/profile #
GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor} GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor} #
GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor}/followers GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor}/followers #
GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor}/following GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor}/following #
GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor}/timeline GET /wpcom/v2/reader/fediverse/connections/{id}/profile/{actor}/timeline #
GET /wpcom/v2/reader/fediverse/connections/{id}/timeline GET /wpcom/v2/reader/fediverse/connections/{id}/timeline #
GET /wpcom/v2/reader/greader GET /wpcom/v2/reader/greader #
GET /wpcom/v2/reader/greader/accounts/ClientLogin GET /wpcom/v2/reader/greader/accounts/ClientLogin #
POST /wpcom/v2/reader/greader/accounts/ClientLogin POST /wpcom/v2/reader/greader/accounts/ClientLogin #
GET /wpcom/v2/reader/greader/api/greader.php/accounts/ClientLogin GET /wpcom/v2/reader/greader/api/greader.php/accounts/ClientLogin #
POST /wpcom/v2/reader/greader/api/greader.php/accounts/ClientLogin POST /wpcom/v2/reader/greader/api/greader.php/accounts/ClientLogin #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/disable-tag POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/disable-tag #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/edit-tag POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/edit-tag #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/mark-all-as-read POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/mark-all-as-read #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/rename-tag POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/rename-tag #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/stream/contents/{stream} GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/stream/contents/{strea… #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/stream/items/contents POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/stream/items/contents #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/stream/items/ids GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/stream/items/ids #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/subscription/edit POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/subscription/edit #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/subscription/list GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/subscription/list #
POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/subscription/quickadd POST /wpcom/v2/reader/greader/api/greader.php/reader/api/0/subscription/quickadd #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/tag/list GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/tag/list #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/token GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/token #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/unread-count GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/unread-count #
GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/user-info GET /wpcom/v2/reader/greader/api/greader.php/reader/api/0/user-info #
GET /wpcom/v2/reader/greader/greader.php/accounts/ClientLogin GET /wpcom/v2/reader/greader/greader.php/accounts/ClientLogin #
POST /wpcom/v2/reader/greader/greader.php/accounts/ClientLogin POST /wpcom/v2/reader/greader/greader.php/accounts/ClientLogin #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/disable-tag POST /wpcom/v2/reader/greader/greader.php/reader/api/0/disable-tag #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/edit-tag POST /wpcom/v2/reader/greader/greader.php/reader/api/0/edit-tag #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/mark-all-as-read POST /wpcom/v2/reader/greader/greader.php/reader/api/0/mark-all-as-read #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/rename-tag POST /wpcom/v2/reader/greader/greader.php/reader/api/0/rename-tag #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/stream/contents/{stream} GET /wpcom/v2/reader/greader/greader.php/reader/api/0/stream/contents/{stream} #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/stream/items/contents POST /wpcom/v2/reader/greader/greader.php/reader/api/0/stream/items/contents #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/stream/items/ids GET /wpcom/v2/reader/greader/greader.php/reader/api/0/stream/items/ids #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/subscription/edit POST /wpcom/v2/reader/greader/greader.php/reader/api/0/subscription/edit #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/subscription/list GET /wpcom/v2/reader/greader/greader.php/reader/api/0/subscription/list #
POST /wpcom/v2/reader/greader/greader.php/reader/api/0/subscription/quickadd POST /wpcom/v2/reader/greader/greader.php/reader/api/0/subscription/quickadd #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/tag/list GET /wpcom/v2/reader/greader/greader.php/reader/api/0/tag/list #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/token GET /wpcom/v2/reader/greader/greader.php/reader/api/0/token #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/unread-count GET /wpcom/v2/reader/greader/greader.php/reader/api/0/unread-count #
GET /wpcom/v2/reader/greader/greader.php/reader/api/0/user-info GET /wpcom/v2/reader/greader/greader.php/reader/api/0/user-info #
POST /wpcom/v2/reader/greader/reader/api/0/disable-tag POST /wpcom/v2/reader/greader/reader/api/0/disable-tag #
POST /wpcom/v2/reader/greader/reader/api/0/edit-tag POST /wpcom/v2/reader/greader/reader/api/0/edit-tag #
POST /wpcom/v2/reader/greader/reader/api/0/mark-all-as-read POST /wpcom/v2/reader/greader/reader/api/0/mark-all-as-read #
POST /wpcom/v2/reader/greader/reader/api/0/rename-tag POST /wpcom/v2/reader/greader/reader/api/0/rename-tag #
GET /wpcom/v2/reader/greader/reader/api/0/stream/contents/{stream} GET /wpcom/v2/reader/greader/reader/api/0/stream/contents/{stream} #
POST /wpcom/v2/reader/greader/reader/api/0/stream/items/contents POST /wpcom/v2/reader/greader/reader/api/0/stream/items/contents #
GET /wpcom/v2/reader/greader/reader/api/0/stream/items/ids GET /wpcom/v2/reader/greader/reader/api/0/stream/items/ids #
POST /wpcom/v2/reader/greader/reader/api/0/subscription/edit POST /wpcom/v2/reader/greader/reader/api/0/subscription/edit #
GET /wpcom/v2/reader/greader/reader/api/0/subscription/list GET /wpcom/v2/reader/greader/reader/api/0/subscription/list #
POST /wpcom/v2/reader/greader/reader/api/0/subscription/quickadd POST /wpcom/v2/reader/greader/reader/api/0/subscription/quickadd #
GET /wpcom/v2/reader/greader/reader/api/0/tag/list GET /wpcom/v2/reader/greader/reader/api/0/tag/list #
GET /wpcom/v2/reader/greader/reader/api/0/token GET /wpcom/v2/reader/greader/reader/api/0/token #
GET /wpcom/v2/reader/greader/reader/api/0/unread-count GET /wpcom/v2/reader/greader/reader/api/0/unread-count #
GET /wpcom/v2/reader/greader/reader/api/0/user-info GET /wpcom/v2/reader/greader/reader/api/0/user-info #
GET /wpcom/v2/reader/mastodon/connections GET /wpcom/v2/reader/mastodon/connections #
POST /wpcom/v2/reader/mastodon/connections POST /wpcom/v2/reader/mastodon/connections #
GET /wpcom/v2/reader/mastodon/connections/{id} GET /wpcom/v2/reader/mastodon/connections/{id} #
GET /wpcom/v2/reader/mastodon/connections/{id}/auth-status GET /wpcom/v2/reader/mastodon/connections/{id}/auth-status #
POST /wpcom/v2/reader/mastodon/connections/{id}/follows POST /wpcom/v2/reader/mastodon/connections/{id}/follows #
DELETE /wpcom/v2/reader/mastodon/connections/{id}/follows/{account_id} DELETE /wpcom/v2/reader/mastodon/connections/{id}/follows/{account_id} #
POST /wpcom/v2/reader/mastodon/connections/{id}/likes POST /wpcom/v2/reader/mastodon/connections/{id}/likes #
DELETE /wpcom/v2/reader/mastodon/connections/{id}/likes/{status_id} DELETE /wpcom/v2/reader/mastodon/connections/{id}/likes/{status_id} #
POST /wpcom/v2/reader/mastodon/connections/{id}/media POST /wpcom/v2/reader/mastodon/connections/{id}/media #
GET /wpcom/v2/reader/mastodon/connections/{id}/notifications GET /wpcom/v2/reader/mastodon/connections/{id}/notifications #
GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor} GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor} #
GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor}/feed GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor}/feed #
GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor}/followers GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor}/followers #
GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor}/following GET /wpcom/v2/reader/mastodon/connections/{id}/profile/{actor}/following #
POST /wpcom/v2/reader/mastodon/connections/{id}/reposts POST /wpcom/v2/reader/mastodon/connections/{id}/reposts #
DELETE /wpcom/v2/reader/mastodon/connections/{id}/reposts/{status_id} DELETE /wpcom/v2/reader/mastodon/connections/{id}/reposts/{status_id} #
POST /wpcom/v2/reader/mastodon/connections/{id}/statuses POST /wpcom/v2/reader/mastodon/connections/{id}/statuses #
DELETE /wpcom/v2/reader/mastodon/connections/{id}/statuses/{status_id} DELETE /wpcom/v2/reader/mastodon/connections/{id}/statuses/{status_id} #
GET /wpcom/v2/reader/mastodon/connections/{id}/tag/{hashtag}/feed GET /wpcom/v2/reader/mastodon/connections/{id}/tag/{hashtag}/feed #
GET /wpcom/v2/reader/mastodon/connections/{id}/thread GET /wpcom/v2/reader/mastodon/connections/{id}/thread #
GET /wpcom/v2/reader/mastodon/connections/{id}/timeline GET /wpcom/v2/reader/mastodon/connections/{id}/timeline #
GET /wpcom/v2/reader/spaces GET /wpcom/v2/reader/spaces #
POST /wpcom/v2/reader/spaces POST /wpcom/v2/reader/spaces #
GET /wpcom/v2/reader/spaces/membership GET /wpcom/v2/reader/spaces/membership #
GET /wpcom/v2/reader/spaces/slug/{slug} GET /wpcom/v2/reader/spaces/slug/{slug} #
GET /wpcom/v2/reader/spaces/{id} GET /wpcom/v2/reader/spaces/{id} #
POST /wpcom/v2/reader/spaces/{id} POST /wpcom/v2/reader/spaces/{id} #
PUT /wpcom/v2/reader/spaces/{id} PUT /wpcom/v2/reader/spaces/{id} #
PATCH /wpcom/v2/reader/spaces/{id} PATCH /wpcom/v2/reader/spaces/{id} #
DELETE /wpcom/v2/reader/spaces/{id} DELETE /wpcom/v2/reader/spaces/{id} #
GET /wpcom/v2/reader/spaces/{id}/discover GET /wpcom/v2/reader/spaces/{id}/discover #
GET /wpcom/v2/reader/spaces/{id}/posts GET /wpcom/v2/reader/spaces/{id}/posts #

Documentation

📖
Documentation
https://developer.wordpress.com/docs/api/
📖
APIReference
https://developer.wordpress.com/docs/api/rest-api-reference/
📖
GettingStarted
https://developer.wordpress.com/docs/api/getting-started/
📖
Documentation
https://akismet.com/development/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-reader-api-openapi.yml

Other Resources

🔗
Console
https://developer.wordpress.com/docs/api/console/
🔗
SourceCode
https://github.com/Automattic/akismet-api
🔗
PluginManifest
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/well-known/automattic-ai-plugin.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/automattic-reader-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

automattic-reader-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: WordPress.com REST API — wpcom/v2 namespace Reader API
  version: v2
  description: Derived by API Evangelist from the WordPress.com REST API route index published at https://public-api.wordpress.com/wpcom/v2/. Paths, HTTP methods, and parameter names/types/descriptions/defaults are taken verbatim from that index. Response schemas are not published in the route index, so successful responses are described but not schematised; the error envelope was observed live on public-api.wordpress.com.
  contact:
    name: Automattic
    url: https://developer.wordpress.com/docs/api/
  x-derived-from: https://public-api.wordpress.com/wpcom/v2/
  x-derived-by: API Evangelist enrichment pipeline
servers:
- url: https://public-api.wordpress.com
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (107 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-reader-api-openapi.yml