Automattic

Automattic Stats API

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

GitHub OpenAPI

Operations 43

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}/rate View email clicks rate by post. Returns mock data #
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 #

Documentation

📖
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/
📖
Documentation
https://akismet.com/development/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-stats-api-openapi.yml

Other Resources

🔗
Console
https://developer.wordpress.com/docs/api/console/
🔗
SourceCode
https://github.com/Automattic/akismet-api
🔗
PluginManifest
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/well-known/automattic-ai-plugin.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/automattic-stats-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

automattic-stats-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: WordPress.com REST API v1.1 Stats API
  version: v1.1
  description: 'The WordPress.com REST API, operated by Automattic. Derived by API Evangelist from Automattic''s own self-describing help document at https://public-api.wordpress.com/rest/v1.1/help (Accept: application/json), which publishes every endpoint''s method, path, description, path/query/body parameters and response fields. Security schemes come from https://public-api.wordpress.com/.well-known/openid-configuration. The error envelope was observed live.'
  termsOfService: https://wordpress.com/tos/
  contact:
    name: WordPress.com Developer Resources
    url: https://developer.wordpress.com/docs/api/
  x-derived-from: https://public-api.wordpress.com/rest/v1.1/help
  x-derived-by: API Evangelist enrichment pipeline
servers:
- url: https://public-api.wordpress.com/rest/v1.1
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (176 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-stats-api-openapi.yml