How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Automattic

Automattic Read API

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

Documentation Provider Profile APIs.io OpenAPI GitHub

Automattic Read API is one of 385 APIs that Automattic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

This API exposes 55 operations across 52 paths, and defines 2 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 4 base URLs: https://public-api.wordpress.com/rest/v1.1, https://public-api.wordpress.com/rest/v1.2, https://public-api.wordpress.com/rest/v1.3, https://public-api.wordpress.com.

55 operations 52 paths 2 schemas 1 DELETE31 GET23 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://public-api.wordpress.com/rest/v1.1
Authentication
OAuth 2.0, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Automattic Read API declares 2 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 21 scopes. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • oauth2 — WordPress.com OAuth 2.1 (see /.well-known/openid-configuration).
  • bearerAuth — Authorization: Bearer

Paths & Operations 55

Across 52 paths, the API surfaces 55 operations — 1 DELETE, 31 GET, 23 POST. Each is listed below with its method, path, parameters, and response codes.

read 55
GET
/read/email-settings/
Returns the email settings
getReadEmailSettings 6 params → 200400401403404
POST
/read/email-settings/
Returns the email settings
postReadEmailSettings 6 params body → 200400401403404
GET
/read/feed/
Get the ID and subscribe URL of one or more matching feeds by domain or URL.
getReadFeed 14 params → 200400401403404
GET
/read/feed/{feed_url_or_id}
Get details about a feed.
getReadFeedByFeedUrlOrId 7 params → 200400401403404
GET
/read/following/
Get a list of posts from the blogs a user follows.
getReadFollowing 11 params → 200400401403404
GET
/read/following/mine
Get a list of the feeds the user is following.
getReadFollowingMine 6 params → 200400401403404
POST
/read/following/mine/delete
Unfollow the specified blog.
postReadFollowingMineDelete 8 params body → 200400401403404
POST
/read/following/mine/new
Follow the specified blog.
postReadFollowingMineNew 8 params body → 200400401403404
GET
/read/liked/
Get a list of posts from the blogs a user likes.
getReadLiked 10 params → 200400401403404
GET
/read/lists/{user_slug}
Get an array of Reader lists by user slug.
getReadListsByUserSlug 7 params → 200400401403404
GET
/read/menu/
Get default reader menu.
getReadMenu 6 params → 200400401403404
GET
/read/recommendations/mine/
Get a list of blog recommendations for the current user.
getReadRecommendationsMine 10 params → 200400401403404
GET
/read/sites/{site}/posts/{post_ID}
Get a single post (by ID).
getReadSitesBySitePostsByPostId 8 params → 200400401403404
GET
/read/subscriptions-count/
Returns the number of blog, comment and pending subscriptions.
getReadSubscriptionsCount 6 params → 200400401403404
GET
/read/tags
Get a list of tags subscribed to by the user.
getReadTags 6 params → 200400401403404
GET
/read/tags/alphabetic
Get a filtered list of top tags, grouped by letter.
getReadTagsAlphabetic 7 params → 200400401403404
GET
/read/tags/{tag}
Get details about a specified tag.
getReadTagsByTag 7 params → 200400401403404
GET
/read/tags/{tag}/mine
Get the subscribed status of the user to a given tag.
getReadTagsByTagMine 7 params → 200400401403404
POST
/read/tags/{tag}/mine/delete
Unsubscribe from a tag.
postReadTagsByTagMineDelete 7 params → 200400401403404
POST
/read/tags/{tag}/mine/new
Subscribe to a new tag.
postReadTagsByTagMineNew 7 params → 200400401403404
GET
/read/tags/{tag}/posts
Get a list of posts from a tag.
getReadTagsByTagPosts 12 params → 200400401403404
GET
/read/trending/tags
Get a list of trending tags.
getReadTrendingTags 8 params → 200400401403404
GET
/read/feed/{feed_url_or_id}/posts/{feed_item_id}
Get a single post from a feed (by ID).
getReadFeedByFeedUrlOrIdPostsByFeedItemId 8 params → 200400401403404
GET
/read/following/mine/export
Export the current user's Reader subscriptions in OPML format.
getReadFollowingMineExport 6 params → 200400401403404
POST
/read/following/mine/import
Import an OPML file to the current user's Reader subscriptions.
postReadFollowingMineImport 6 params body → 200400401403404
GET
/read/lists
Get an array of Reader lists the current user is following.
getReadLists 7 params → 200400401403404
GET
/read/lists/{username}/{list}
Get a description of a Reader list.
getReadListsByUsernameByList 8 params → 200400401403404
POST
/read/lists/{username}/{list}/follow
Follow a specific Reader List.
postReadListsByUsernameByListFollow 8 params → 200400401403404
POST
/read/lists/{username}/{list}/unfollow
Unfollow a specific Reader List.
postReadListsByUsernameByListUnfollow 8 params → 200400401403404
POST
/read/lists/{username}/{list}/update
Update an existing Reader list for the current user.
postReadListsByUsernameByListUpdate 8 params body → 200400401403404
POST
/read/onboarding/welcome-digest/flush
Flush the pending Reader onboarding welcome digest for the current user.
postReadOnboardingWelcomeDigestFlush 6 params → 200400401403404
POST
/read/site/{site}/comment_email_subscriptions/delete
Remove an existing email subscription to a site's comments.
postReadSiteBySiteCommentEmailSubscriptionsDelete 8 params → 200400401403404
POST
/read/site/{site}/comment_email_subscriptions/new
Create a new email subscription to a site's comments.
postReadSiteBySiteCommentEmailSubscriptionsNew 8 params → 200400401403404
POST
/read/site/{site}/post_email_subscriptions/delete
Remove an existing email subscription to a site's posts.
postReadSiteBySitePostEmailSubscriptionsDelete 7 params body → 200400401403404
POST
/read/site/{site}/post_email_subscriptions/new
Create a new email subscription to a site's posts.
postReadSiteBySitePostEmailSubscriptionsNew 7 params body → 200400401403404
POST
/read/site/{site}/post_email_subscriptions/update
Update the delivery frequency for an existing email subscription.
postReadSiteBySitePostEmailSubscriptionsUpdate 7 params body → 200400401403404
GET
/wpcom/v2/read/interests
GET /wpcom/v2/read/interests
getWpcomV2ReadInterests → 200401404
GET
/wpcom/v2/read/lists/{list_id}/export
GET /wpcom/v2/read/lists/{listid}/export
getWpcomV2ReadListsbyListIdExport 1 param → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/notification-subscriptions/delete
POST /wpcom/v2/read/sites/{blogid}/notification-subscriptions/delete
postWpcomV2ReadSitesbyBlogIdNotificationSubscriptionsDelete 1 param → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/notification-subscriptions/new
POST /wpcom/v2/read/sites/{blogid}/notification-subscriptions/new
postWpcomV2ReadSitesbyBlogIdNotificationSubscriptionsNew 1 param → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/posts/{post_id}/follow
POST /wpcom/v2/read/sites/{blogid}/posts/{postid}/follow
postWpcomV2ReadSitesbyBlogIdPostsbyPostIdFollow 2 params → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/posts/{post_id}/forget
POST /wpcom/v2/read/sites/{blogid}/posts/{postid}/forget
postWpcomV2ReadSitesbyBlogIdPostsbyPostIdForget 2 params → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/posts/{post_id}/mute
POST /wpcom/v2/read/sites/{blogid}/posts/{postid}/mute
postWpcomV2ReadSitesbyBlogIdPostsbyPostIdMute 2 params → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/posts/{post_id}/remember
POST /wpcom/v2/read/sites/{blogid}/posts/{postid}/remember
postWpcomV2ReadSitesbyBlogIdPostsbyPostIdRemember 2 params → 200401404
POST
/wpcom/v2/read/sites/{blog_id}/posts/{post_id}/tags/add
POST /wpcom/v2/read/sites/{blogid}/posts/{postid}/tags/add
postWpcomV2ReadSitesbyBlogIdPostsbyPostIdTagsAdd 2 params body → 200401404
GET
/wpcom/v2/read/sites/{blog_id}/subscription-details
GET /wpcom/v2/read/sites/{blogid}/subscription-details
getWpcomV2ReadSitesbyBlogIdSubscriptionDetails 1 param → 200401404
GET
/wpcom/v2/read/smart-feed/user-model
GET /wpcom/v2/read/smart-feed/user-model
getWpcomV2ReadSmartFeedUserModel → 200401404
POST
/wpcom/v2/read/smart-feed/user-model
POST /wpcom/v2/read/smart-feed/user-model
postWpcomV2ReadSmartFeedUserModel body → 200401404
DELETE
/wpcom/v2/read/smart-feed/user-model
DELETE /wpcom/v2/read/smart-feed/user-model
deleteWpcomV2ReadSmartFeedUserModel → 200401404
GET
/wpcom/v2/read/streams/on-this-day
GET /wpcom/v2/read/streams/on-this-day
getWpcomV2ReadStreamsOnThisDay 3 params → 200401404
GET
/wpcom/v2/read/subscriptions/{subscription_id}
GET /wpcom/v2/read/subscriptions/{subscriptionid}
getWpcomV2ReadSubscriptionsbySubscriptionId 1 param → 200401404
GET
/wpcom/v2/read/tags/cards
GET /wpcom/v2/read/tags/cards
getWpcomV2ReadTagsCards 10 params → 200401404
GET
/wpcom/v2/read/tags/posts
GET /wpcom/v2/read/tags/posts
getWpcomV2ReadTagsPosts 8 params → 200401404
GET
/wpcom/v2/read/tags/{tag}/cards
GET /wpcom/v2/read/tags/{tag}/cards
getWpcomV2ReadTagsbyTagCards 11 params → 200401404
GET
/wpcom/v2/read/tags/{tag}/posts
GET /wpcom/v2/read/tags/{tag}/posts
getWpcomV2ReadTagsbyTagPosts 8 params → 200401404

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are WPRestError (3 properties), Error (2 properties). Each schema is shown below with its type and property counts.

Error
object
WordPress.com REST API error envelope (observed live).
2 properties
WPRestError
object
WordPress REST API error envelope (observed on public-api.wordpress.com).
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

automattic-read-api-openapi.yml Raw ↑

Other APIs Automattic publishes across the network.

WordPress.com MCP Server
AE Profile APIs.io
WordPress VIP Platform API
AE Profile APIs.io
Automattic A8c Lore API
AE Profile APIs.io
Automattic A8cmentorship API
AE Profile APIs.io
Automattic Abilities API
AE Profile APIs.io
Automattic Activity API
AE Profile APIs.io
Automattic Activity Log Events API
AE Profile APIs.io
Automattic Activitypub API
AE Profile APIs.io
Automattic Adflow API
AE Profile APIs.io
Automattic Admin Bar API
AE Profile APIs.io
Automattic Admin Color API
AE Profile APIs.io
Automattic Admin Menu API
AE Profile APIs.io
← Back to A APIs
API Details
ID
automattic:automattic-read-api
Base URL
https://public-api.wordpress.com/rest/v1.1
Docs
https://developer.wordpress.com/docs/api/
Provider
Automattic
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=automattic-read-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/automattic-read-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

This is an independent, third-party profile of Automattic Read API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.