Automattic

Automattic Read API

The read API from Automattic — 52 operation(s) for read.

GitHub OpenAPI

Operations 55

GET /read/email-settings/ Returns the email settings #
POST /read/email-settings/ Returns the email settings #
GET /read/feed/ Get the ID and subscribe URL of one or more matching feeds by domain or URL #
GET /read/feed/{feed_url_or_id} Get details about a feed #
GET /read/following/ Get a list of posts from the blogs a user follows #
GET /read/following/mine Get a list of the feeds the user is following #
POST /read/following/mine/delete Unfollow the specified blog #
POST /read/following/mine/new Follow the specified blog #
GET /read/liked/ Get a list of posts from the blogs a user likes #
GET /read/lists/{user_slug} Get an array of Reader lists by user slug #
GET /read/menu/ Get default reader menu #
GET /read/recommendations/mine/ Get a list of blog recommendations for the current user #
GET /read/sites/{site}/posts/{post_ID} Get a single post (by ID) #
GET /read/subscriptions-count/ Returns the number of blog, comment and pending subscriptions #
GET /read/tags Get a list of tags subscribed to by the user #
GET /read/tags/alphabetic Get a filtered list of top tags, grouped by letter #
GET /read/tags/{tag} Get details about a specified tag #
GET /read/tags/{tag}/mine Get the subscribed status of the user to a given tag #
POST /read/tags/{tag}/mine/delete Unsubscribe from a tag #
POST /read/tags/{tag}/mine/new Subscribe to a new tag #
GET /read/tags/{tag}/posts Get a list of posts from a tag #
GET /read/trending/tags Get a list of trending tags #
GET /read/feed/{feed_url_or_id}/posts/{feed_item_id} Get a single post from a feed (by ID) #
GET /read/following/mine/export Export the current user's Reader subscriptions in OPML format #
POST /read/following/mine/import Import an OPML file to the current user's Reader subscriptions #
GET /read/lists Get an array of Reader lists the current user is following #
GET /read/lists/{username}/{list} Get a description of a Reader list #
POST /read/lists/{username}/{list}/follow Follow a specific Reader List #
POST /read/lists/{username}/{list}/unfollow Unfollow a specific Reader List #
POST /read/lists/{username}/{list}/update Update an existing Reader list for the current user #
POST /read/onboarding/welcome-digest/flush Flush the pending Reader onboarding welcome digest for the current user #
POST /read/site/{site}/comment_email_subscriptions/delete Remove an existing email subscription to a site's comments #
POST /read/site/{site}/comment_email_subscriptions/new Create a new email subscription to a site's comments #
POST /read/site/{site}/post_email_subscriptions/delete Remove an existing email subscription to a site's posts #
POST /read/site/{site}/post_email_subscriptions/new Create a new email subscription to a site's posts #
POST /read/site/{site}/post_email_subscriptions/update Update the delivery frequency for an existing email subscription #
GET /wpcom/v2/read/interests GET /wpcom/v2/read/interests #
GET /wpcom/v2/read/lists/{list_id}/export GET /wpcom/v2/read/lists/{list_id}/export #
POST /wpcom/v2/read/sites/{blog_id}/notification-subscriptions/delete POST /wpcom/v2/read/sites/{blog_id}/notification-subscriptions/delete #
POST /wpcom/v2/read/sites/{blog_id}/notification-subscriptions/new POST /wpcom/v2/read/sites/{blog_id}/notification-subscriptions/new #
POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/follow POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/follow #
POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/forget POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/forget #
POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/mute POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/mute #
POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/remember POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/remember #
POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/tags/add POST /wpcom/v2/read/sites/{blog_id}/posts/{post_id}/tags/add #
GET /wpcom/v2/read/sites/{blog_id}/subscription-details GET /wpcom/v2/read/sites/{blog_id}/subscription-details #
GET /wpcom/v2/read/smart-feed/user-model GET /wpcom/v2/read/smart-feed/user-model #
POST /wpcom/v2/read/smart-feed/user-model POST /wpcom/v2/read/smart-feed/user-model #
DELETE /wpcom/v2/read/smart-feed/user-model DELETE /wpcom/v2/read/smart-feed/user-model #
GET /wpcom/v2/read/streams/on-this-day GET /wpcom/v2/read/streams/on-this-day #
GET /wpcom/v2/read/subscriptions/{subscription_id} GET /wpcom/v2/read/subscriptions/{subscription_id} #
GET /wpcom/v2/read/tags/cards GET /wpcom/v2/read/tags/cards #
GET /wpcom/v2/read/tags/posts GET /wpcom/v2/read/tags/posts #
GET /wpcom/v2/read/tags/{tag}/cards GET /wpcom/v2/read/tags/{tag}/cards #
GET /wpcom/v2/read/tags/{tag}/posts GET /wpcom/v2/read/tags/{tag}/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-read-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-read-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-read-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Automattic Read API
  x-derived-by: API Evangelist enrichment pipeline
  x-refined-note:
  - x-derived-from differs across the merged source definitions and was not carried
  version: '1.0'
  description: 'Operations tagged read across 4 of this provider''s published API definitions: automattic-wordpress-com-rest-v1-1-openapi.yml, automattic-wordpress-com-rest-v1-2-openapi.yml, automattic-wordpress-com-rest-v1-3-openapi.yml, automattic-wordpress-com-wpcom-v2-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://public-api.wordpress.com/rest/v1.1
- url: https://public-api.wordpress.com/rest/v1.2
- url: https://public-api.wordpress.com/rest/v1.3
- url: https://public-api.wordpress.com
security:
- bearerAuth: []
tags:


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