# Automattic Sites API

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

The sites API from Automattic — 25 operation(s) for sites.

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| GET | `/me/sites` | Get a list of the current user's sites. |
| GET | `/me/sites/compact` | Not in use |
| GET | `/me/sites/features` | Get a list of the current user's sites features |
| GET | `/me/sites/plugins` | Get a list of the current user's sites plugins |
| GET | `/sites/{site}` | Get information about a site. |
| GET | `/sites/{site}/automated-transfers/status` | Returns the current status of Automated Transfer for a site. |
| GET | `/sites/{site}/embeds` | Get a list of embeds available on a site. Note: The current user must have publishing access. |
| GET | `/sites/{site}/embeds/render` | Get a rendered embed for a site. Note: The current user must have publishing access. |
| GET | `/sites/{site}/headers/mine` | Get the custom header options for a site. |
| POST | `/sites/{site}/headers/mine` | Set the custom header options for a site. |
| GET | `/sites/{site}/headers/{theme_slug}` | Get the custom header options for a site with a particular theme. |
| GET | `/sites/{site}/page-templates` | Get a list of page templates supported by a site. |
| GET | `/sites/{site}/post-counts/{post_type}` | Get number of posts in the post type groups by post status |
| GET | `/sites/{site}/post-types` | Get a list of post types available for a site. |
| POST | `/sites/{site}/search` | Search within a site using an Elasticsearch Query API. |
| GET | `/sites/{site}/search` | Search within a site as you type |
| GET | `/sites/{site}/shortcodes` | Get a list of shortcodes available on a site. Note: The current user must have publishing access. |
| GET | `/sites/{site}/shortcodes/render` | Get a rendered shortcode for a site. Note: The current user must have publishing access. |
| GET | `/sites/{site}/widgets` | Retrieve the active and inactive widgets for a site. |
| POST | `/sites/{site}/widgets/new` | Activate a widget on a site. |
| GET | `/sites/{site}/widgets/widget:{id}` | Retrieve a widget on a site by its ID. |
| POST | `/sites/{site}/widgets/widget:{id}` | Update a widget on a site by its ID. |
| POST | `/sites/{site}/widgets/widget:{id}/delete` | Deactivate a widget on a site by its ID. Will delete if already deactivated. |
| POST | `/sites/{site}/wordads/approve` | Request streamlined approval to join the WordAds program. |
| GET | `/sites/{site}/wordads/earnings` | Get detailed WordAds earnings information about a site. |
| GET | `/sites/{site}/wordads/settings` | Get detailed WordAds settings information about a site. |
| POST | `/sites/{site}/wordads/settings` | Update WordAds settings for a site. |
| GET | `/sites/{site}/wordads/stats` | Get WordAds stats for a site |
| GET | `/sites/{site}/wordads/tos` | Get WordAds TOS information about a site. |
| POST | `/sites/{site}/wordads/tos` | Update WordAds TOS setting for a site. |

## Machine-readable artifacts (8)

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

Sites

---

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