# Automattic Read API

**Canonical:** https://apis.io/apis/automattic/automattic-read-api/  
**Provider:** Automattic — https://apis.io/providers/automattic/  
**Base URL:** https://public-api.wordpress.com/rest/v1.1  
**Documentation:** https://developer.wordpress.com/docs/api/

Automattic Read API is one of 385 APIs that [Automattic](https://apis.io/providers/automattic/) publishes on the [APIs.io](https://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.

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

## Operations (55)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-read-api-openapi.yml
- **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/
- **Console** — https://developer.wordpress.com/docs/api/console/
- **Documentation** — https://akismet.com/development/api/
- **SourceCode** — https://github.com/Automattic/akismet-api
- **PluginManifest** — https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/well-known/automattic-ai-plugin.json

## Other Automattic APIs (12)

- [WordPress.com MCP Server](https://apis.io/apis/automattic/wordpresscom-mcp-server/)
- [WordPress VIP Platform API](https://apis.io/apis/automattic/wordpress-vip-platform-api/)
- [Automattic A8c Lore API](https://apis.io/apis/automattic/automattic-a8c-lore-api/)
- [Automattic A8cmentorship API](https://apis.io/apis/automattic/automattic-a8cmentorship-api/)
- [Automattic Abilities API](https://apis.io/apis/automattic/automattic-abilities-api/)
- [Automattic Activity API](https://apis.io/apis/automattic/automattic-activity-api/)
- [Automattic Activity Log Events API](https://apis.io/apis/automattic/automattic-activity-log-events-api/)
- [Automattic Activitypub API](https://apis.io/apis/automattic/automattic-activitypub-api/)
- [Automattic Adflow API](https://apis.io/apis/automattic/automattic-adflow-api/)
- [Automattic Admin Bar API](https://apis.io/apis/automattic/automattic-admin-bar-api/)
- [Automattic Admin Color API](https://apis.io/apis/automattic/automattic-admin-color-api/)
- [Automattic Admin Menu API](https://apis.io/apis/automattic/automattic-admin-menu-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/automattic/automattic-read-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/automattic/.