Get top stats content is a WordPress ability from Jetpack — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Get top stats content

Read-only
Jetpack Backup & Site Management jetpack-stats/get-top-content

Return top-performing items for a chosen content type — posts, referrers, search terms, clicks, tags, authors, countries, downloads, or video plays.

Requires the Jetpack plugin on WordPress 6.9+. Abilities are registered by several bundled Jetpack packages (automattic/jetpack-backup, jetpack-connection, jetpack-forms, jetpack-stats) plus the main plugin's own registrars for Related Posts, Shortlinks, Sitemaps, Newsletter/Subscriptions, and Monitor. Permission requirements vary by ability — most gate on 'manage_options', 'jetpack_admin_page', or 'view_stats', while Forms abilities use 'edit_pages'. Backup abilities only register when a Backup product/plan is active; Sitemaps, Monitor, and Newsletter abilities only register when their respective module is turned on.

What it does

This ability returns a ranked list of top items for a single content type in one uniformly-shaped call, replacing nine separate WordPress.com stats endpoints. Supported types are posts, referrers, search-terms, clicks, tags, authors, countries, downloads, and video-plays, over a day/week/month/year period ending on a given date, rolling up a configurable number of prior periods (num) and capped at a maximum number of results (max). The countries type additionally joins full country names onto the result; tags returns a flat list without the day-by-day envelope other types use. An unknown or missing type returns a jetpack_stats_missing_type error.

See it in action

You ask your AI assistant

"What were my top 10 posts by views this month?"

Inputs

Name Type Required Description
type string Yes Content type to rank: posts, referrers, search-terms, clicks, tags, authors, countries, downloads, or video-plays.
period string No Granularity: day, week, month, or year. Defaults to day.
date string No End date in YYYY-MM-DD format. Defaults to today.
num integer No How many prior periods to roll up (1-90). Defaults to 1.
max integer No Maximum number of results to return (1-100). Defaults to 20.

Returns

An object with type, period, date, num, max, and items (an array of {rank, label, value, href?} objects).

Permission

The current user must have the 'view_stats' capability.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.