# Automattic Posts API

**Canonical:** https://apis.io/apis/automattic/automattic-posts-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 Posts 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. Tagged areas include Posts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

The posts API from Automattic — 34 operation(s) for posts.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| GET | `/me/posts` | Get a list of posts across all the user's sites. |
| GET | `/sites/{site}/dropdown-pages/` | Get a list of pages to be displayed as options in a select-a-page-dropdown. |
| GET | `/sites/{site}/posts/` | Get a list of matching posts. |
| POST | `/sites/{site}/posts/delete` | Delete multiple posts. Note: If the trash is enabled, this request will send non-trashed posts to the trash. Trashed pos |
| POST | `/sites/{site}/posts/new` | Create a post. |
| POST | `/sites/{site}/posts/restore` | Restore multiple posts. |
| GET | `/sites/{site}/posts/slug:{post_slug}` | Get a single post (by slug). |
| GET | `/sites/{site}/posts/{post_ID}` | Get a single post (by ID). |
| POST | `/sites/{site}/posts/{post_ID}` | Edit a post. |
| POST | `/sites/{site}/posts/{post_ID}/delete` | Delete a post. Note: If the trash is enabled, this request will send the post to the trash. A second request will perman |
| GET | `/sites/{site}/posts/{post_ID}/likes/` | Get a list of the likes for a post. |
| GET | `/sites/{site}/posts/{post_ID}/likes/mine/` | Get the current user's like status for a post. |
| POST | `/sites/{site}/posts/{post_ID}/likes/mine/delete` | Unlike a post. |
| POST | `/sites/{site}/posts/{post_ID}/likes/new` | Like a post. |
| GET | `/sites/{site}/posts/{post_ID}/reblogs/mine` | Get reblog status for a post. |
| POST | `/sites/{site}/posts/{post_ID}/reblogs/new` | Reblog a post. |
| POST | `/sites/{site}/posts/{post_ID}/restore` | Restore a post or page from the trash to its previous status. |
| POST | `/sites/{site}/posts/{post}/related` | Search within a site for related posts. |
| GET | `/sites/{site}/posts/{post}/subscribers/` | Get a list of the specified post's subscribers. |
| GET | `/sites/{site}/posts/{post}/subscribers/mine` | Get subscription status of the specified post for the current user. |
| POST | `/sites/{site}/posts/{post}/subscribers/mine/delete` | Unsubscribe the current user from the specified post. |
| POST | `/sites/{site}/posts/{post}/subscribers/mine/update` | Subscribe current user to be notified of the specified post's comments. |
| POST | `/sites/{site}/posts/{post}/subscribers/new` | Subscribe current user to be notified of the specified post's comments. |
| GET | `/users/{user_id}/posts` | Get a list of published posts authored by a specified user across their public sites, ordered by date in descending orde |
| GET | `/wp/v2/sites/{wpcom_site}/posts` | GET /wp/v2/sites/{wpcom_site}/posts |
| POST | `/wp/v2/sites/{wpcom_site}/posts` | POST /wp/v2/sites/{wpcom_site}/posts |
| GET | `/wp/v2/sites/{wpcom_site}/posts/{id}` | GET /wp/v2/sites/{wpcom_site}/posts/{id} |
| POST | `/wp/v2/sites/{wpcom_site}/posts/{id}` | POST /wp/v2/sites/{wpcom_site}/posts/{id} |
| PUT | `/wp/v2/sites/{wpcom_site}/posts/{id}` | PUT /wp/v2/sites/{wpcom_site}/posts/{id} |
| PATCH | `/wp/v2/sites/{wpcom_site}/posts/{id}` | PATCH /wp/v2/sites/{wpcom_site}/posts/{id} |
| DELETE | `/wp/v2/sites/{wpcom_site}/posts/{id}` | DELETE /wp/v2/sites/{wpcom_site}/posts/{id} |
| GET | `/wp/v2/sites/{wpcom_site}/posts/{id}/autosaves` | GET /wp/v2/sites/{wpcom_site}/posts/{id}/autosaves |
| POST | `/wp/v2/sites/{wpcom_site}/posts/{id}/autosaves` | POST /wp/v2/sites/{wpcom_site}/posts/{id}/autosaves |
| GET | `/wp/v2/sites/{wpcom_site}/posts/{parent}/autosaves/{id}` | GET /wp/v2/sites/{wpcom_site}/posts/{parent}/autosaves/{id} |
| GET | `/wp/v2/sites/{wpcom_site}/posts/{parent}/revisions` | GET /wp/v2/sites/{wpcom_site}/posts/{parent}/revisions |
| GET | `/wp/v2/sites/{wpcom_site}/posts/{parent}/revisions/{id}` | GET /wp/v2/sites/{wpcom_site}/posts/{parent}/revisions/{id} |
| DELETE | `/wp/v2/sites/{wpcom_site}/posts/{parent}/revisions/{id}` | DELETE /wp/v2/sites/{wpcom_site}/posts/{parent}/revisions/{id} |
| POST | `/wpcom/v2/sites/{wpcom_site}/posts/auto-draft` | POST /wpcom/v2/sites/{wpcom_site}/posts/auto-draft |
| GET | `/wpcom/v2/sites/{wpcom_site}/posts/map-url` | GET /wpcom/v2/sites/{wpcom_site}/posts/map-url |
| GET | `/wpcom/v2/sites/{wpcom_site}/posts/{postId}/map-url` | GET /wpcom/v2/sites/{wpcom_site}/posts/{postId}/map-url |
| POST | `/wpcom/v2/sites/{wpcom_site}/posts/{postId}/publicize` | POST /wpcom/v2/sites/{wpcom_site}/posts/{postId}/publicize |
| GET | `/wpcom/v2/sites/{wpcom_site}/posts/{postId}/publicize/published-actions` | GET /wpcom/v2/sites/{wpcom_site}/posts/{postId}/publicize/published-actions |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-posts-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/)

## Tags

Posts

---

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