rank-math/get-analytics-summary returns a Rank Math analytics summary for a date range, with period-over-period comparison.
Several summary types: the dashboard rollup, search performance, keyword totals, per-post-type performance, the optimisation score breakdown, or one post’s figures.
At a glance
| Ability | rank-math/get-analytics-summary |
| Toolset | Rank Math — toolset/rank-math |
| Group | Rank Math › Analytics |
| Requires | Rank Math SEO, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
This needs a connected Google Search Console. Without one the ability says so rather than returning empty data — an empty result that reads as zero traffic is worse than an error, because it looks like an answer.
The period-over-period comparison is the part that makes the numbers mean anything. Impressions for a month is a number; impressions against the previous month is a direction, and direction is what anybody actually asks about.
The per-post-type breakdown answers a question most analytics cannot: whether the effort going into one kind of content is producing anything. A site publishing both posts and case studies can see which is earning impressions.
The optimisation score breakdown crosses Rank Math’s own scoring with search performance, which is the closest thing available to evidence about whether the scores correlate with anything on this particular site.
One post’s figures are available here too, which is usually enough to avoid paging through the row-level ability.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
type | string | Yes | Which summary: the dashboard rollup, search performance, keywords, post types, the score breakdown, or a single post. |
from | string | No | Start date, YYYY-MM-DD. |
to | string | No | End date, YYYY-MM-DD. |
post_id | integer | Required for the single-post summary | Which post. |
What comes back
| Name | Type | What it is |
|---|---|---|
summary | object | The figures for the period. |
comparison | object | The same figures for the preceding period. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
How did search traffic do last month compared to the month before?
It resolves to one call:
{
"ability": "rank-math/get-analytics-summary",
"parameters": {
"type": "search-performance",
"from": "2026-08-01",
"to": "2026-08-31"
}
}Worth knowing
- Needs a connected Search Console. Without one it says so rather than returning zeros.
- The comparison is what turns numbers into direction.
- The per-post-type breakdown shows which content is earning anything.
- Read-only.
Related abilities
- Get Rank Math Analytics Rows — the detail behind the summary
- Get Rank Math Index Status — whether pages are indexed at all
- Get Rank Math Status — check the Search Console connection
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category