# Automattic Stats API

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

The stats API from Automattic — 43 operation(s) for stats.

## Operations (43)

| Method | Path | Summary |
|---|---|---|
| GET | `/sites/{site}/stats` | Get a site's stats |
| GET | `/sites/{site}/stats/archives` | View a site's archives |
| GET | `/sites/{site}/stats/clicks` | View a site's outbound clicks |
| GET | `/sites/{site}/stats/clicks/emails/summary` | View the total number of email clicks for each post. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}` | View chart stats related to email clicks by period. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}/client` | View email clicks by client. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}/country` | View email clicks by country. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}/device` | View email clicks by device. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}/link` | View email clicks by link. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}/rate` | View email clicks rate by post. Returns mock data. |
| GET | `/sites/{site}/stats/clicks/emails/{post_id}/user-content-link` | View email clicks by user content link. |
| GET | `/sites/{site}/stats/comment-followers` | View a site's comment followers |
| GET | `/sites/{site}/stats/comments` | View a site's top comment authors and most-commented posts |
| GET | `/sites/{site}/stats/country-views` | View a site's views by country |
| GET | `/sites/{site}/stats/devices/{device_property_name}` | Fetch site's Device properties statistics. |
| GET | `/sites/{site}/stats/emails/summary` | View the total number of email opens and clicks for each post. |
| GET | `/sites/{site}/stats/file-downloads` | View a site's file downloads |
| GET | `/sites/{site}/stats/followers` | View a site's followers |
| GET | `/sites/{site}/stats/highlights` | View highlight metrics from the last seven days. |
| GET | `/sites/{site}/stats/location-views/{geo_mode}` | View a site's views by country, region and city |
| GET | `/sites/{site}/stats/opens/emails/summary` | View the total number of email opens for each post. |
| GET | `/sites/{site}/stats/opens/emails/{post_id}` | View multiple stats related to email opens by post. |
| GET | `/sites/{site}/stats/opens/emails/{post_id}/client` | View email opens stats by client. |
| GET | `/sites/{site}/stats/opens/emails/{post_id}/country` | View email opens stats by country. |
| GET | `/sites/{site}/stats/opens/emails/{post_id}/device` | View email opens stats by device. |
| GET | `/sites/{site}/stats/opens/emails/{post_id}/rate` | View email opens rate by post. |
| GET | `/sites/{site}/stats/post/{post_id}` | View a post's views |
| GET | `/sites/{site}/stats/publicize` | View a site's publicize follower counts |
| GET | `/sites/{site}/stats/referrers` | View a site's referrers |
| GET | `/sites/{site}/stats/referrers/spam` | List referrers marked as spam |
| POST | `/sites/{site}/stats/referrers/spam/delete` | Unreport a referrer as spam |
| POST | `/sites/{site}/stats/referrers/spam/new` | Report a referrer as spam |
| GET | `/sites/{site}/stats/search-terms` | View search terms used to find the site |
| GET | `/sites/{site}/stats/streak` | Get stats for Calendar Heatmap. Returns data with each post timestamp. |
| GET | `/sites/{site}/stats/summary` | View a site's summarized views, visitors, likes and comments |
| GET | `/sites/{site}/stats/tags` | View a site's views by tags and categories |
| GET | `/sites/{site}/stats/top-authors` | View a site's top authors |
| GET | `/sites/{site}/stats/top-posts` | View a site's top posts and pages by views |
| GET | `/sites/{site}/stats/utm/{utm_param_name}` | Fetch site's UTM param statistics. |
| GET | `/sites/{site}/stats/utm/{utm_param_name}/top_posts` | Fetch top posts for a given UTM parameter value. |
| GET | `/sites/{site}/stats/video-plays` | View a site's video plays |
| GET | `/sites/{site}/stats/video/{post_id}` | View the details of a single video |
| GET | `/sites/{site}/stats/views/posts` | View the total number of views for each post. |

## Machine-readable artifacts (8)

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

Stats

---

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