Review Ranking-Page Count History · Ahrefs

Enter a domain or URL and a start date to review how many of its pages Ahrefs records as ranking in organic search across daily, weekly or monthly intervals.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use ranking-pages-history-ahrefs (Tool ID 7a3a745f-5609-472f-8ca2-ca4694f8e7ed). Reuse my Toolmu connection or follow https://toolmu.com/SKILL.md, within my current authorization and budget. Ask for the target and date_from if missing. Send queryParams target example.com, date_from 2026-07-01, date_to 2026-09-30, history_grouping monthly, mode domain, protocol both and country us. Keep the period within the supplier maximum of 60 chosen buckets per request. Review the returned dates and counts of pages ranking organically, not per-page URLs, ranking positions, traffic or indexed-page totals. Organize dates before comparing; do not assume source order, bucket completeness, averaging or a particular point within each bucket. Keep missing counts/intervals unknown rather than filling them with zero. Keep target scope, country and grouping consistent for comparisons; country omission semantics are unspecified, so use us explicitly here. Count changes do not identify which pages entered or left, explain causes or guarantee traffic changes. Use only the seven supported inputs; there is no page-position selector, filter, sort or limit input. Extra calls or ongoing monitoring require authorization.

Task:
For [https://example.com] from [Jul 1, 2026] to [Sep 30, 2026] in [United States], count how many pages from this website appear in the first 100 search results, leaving out ads, each month. A missing month has no count, not zero. The report does not list page links or visits.

Paste into your connected AI's conversation.

Connection guide

Up to 0.432 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

Ahrefs

Review Ranking-Page Count History · Ahrefs

Enter a domain or URL and a start date to review how many of its pages Ahrefs records as ranking in organic search across daily, weekly or monthly intervals.

You receive

Get a dated series of ranking-page counts for the selected target scope and country. Your Agent can organize the returned dates and compare the counts to review changes in the target’s organic search presence.

Start with your task

For [https://example.com] from [Jul 1, 2026] to [Sep 30, 2026] in [United States], count how many pages from this website appear in the first 100 search results, leaving out ads, each month. A missing month has no count, not zero. The report does not list page links or visits.

What to know

A request may cover at most 60 chosen time buckets. The report gives counts, not page URLs, individual positions or traffic; it does not guarantee complete historical intervals or explain why counts changed.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `target, date_from`
Target scope`queryParams.mode`	`string`	Optional	Optional exact, prefix, domain or subdomains; default subdomains. exact selects this URL, prefix selects URLs beginning with the target, domain excludes subdomains, and subdomains includes them. Default `subdomains` Options `exact, prefix, domain, subdomains`
Target domain or URL`queryParams.target`	`string`	Required	Required non-empty string, such as example.com or https://example.com/page. Together with mode, selects the target whose ranking-page counts are reported. Minimum length `1`
Search market`queryParams.country`	`string`	Optional	Optional two-letter ISO 3166-1 alpha-2 country code, such as us. Specify it for comparable market counts; the default or aggregation when omitted is unspecified. Minimum length `2` Maximum length `2`
End date`queryParams.date_to`	`string`	Optional	Optional YYYY-MM-DD end date, such as 2026-09-30; defaults to today. A current end date does not guarantee that the latest bucket is available or freshly collected. Pattern `^\d{4}-\d{2}-\d{2}$`
Target protocol`queryParams.protocol`	`string`	Optional	Optional both, http or https; default both. Selects the protocol of target URLs included in the count, not a live URL check. Default `both` Options `both, http, https`
Start date`queryParams.date_from`	`string`	Required	Required YYYY-MM-DD start date, such as 2026-07-01. Choose a range of at most 60 buckets at the requested grouping; earliest available history is not guaranteed. Pattern `^\d{4}-\d{2}-\d{2}$`
History interval`queryParams.history_grouping`	`string`	Optional	Optional daily, weekly or monthly; default monthly. Chooses time buckets, with at most 60 buckets per request. The contract does not specify bucket averaging, exact snapshot timing or filling missing intervals. Default `monthly` Options `daily, weekly, monthly`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "target",
        "date_from"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "mode": {
          "enum": [
            "exact",
            "prefix",
            "domain",
            "subdomains"
          ],
          "type": "string",
          "default": "subdomains",
          "description": "Scope of the target: exact (this URL only), prefix (URLs starting with the target), domain (the domain without subdomains), or subdomains (default — the domain and all its subdomains)."
        },
        "target": {
          "type": "string",
          "minLength": 1,
          "description": "The target of the report: a domain ('example.com') or a URL ('https://example.com/page')."
        },
        "country": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Two-letter country code (ISO 3166-1 alpha-2), e.g. 'us'."
        },
        "date_to": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "End date of the historical period in YYYY-MM-DD format. Defaults to today."
        },
        "protocol": {
          "enum": [
            "both",
            "http",
            "https"
          ],
          "type": "string",
          "default": "both",
          "description": "Protocol of the target: both (default), http, or https."
        },
        "date_from": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Start date of the historical period in YYYY-MM-DD format."
        },
        "history_grouping": {
          "enum": [
            "daily",
            "weekly",
            "monthly"
          ],
          "type": "string",
          "default": "monthly",
          "description": "Time bucket size for history rows: daily, weekly, or monthly (default). Each bucket is one billed row."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

The series measures the number of target pages recorded as ranking organically at the reported dates. It does not enumerate the pages, measure their positions or report traffic. It is also different from a sitemap page total or evidence that Google has indexed every page on a site.

Your Agent can arrange actual dates and compare the counts. Keep the target scope, country and grouping consistent, and preserve missing periods rather than inventing values. A larger count describes more reported ranking pages; it does not by itself prove which pages changed, higher visits, an SEO action’s effect or an algorithm cause.

Ahrefs ranking-page history definition

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

The report gives a date and an aggregate count of ranking pages, not their URLs or individual positions. A change in the count does not identify which pages entered or left, or whether a particular page moved up or down.

Review Ranking-Page Count History · Ahrefs

Review Ranking-Page Count History · Ahrefs

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

See how many pages appear in search each month

Review an online shop over six months

Follow a blog week by week

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

See how many pages appear in search each month

Review an online shop over six months

Follow a blog week by week

Questions about this tool.

Can I identify the pages whose rankings changed?

Does the 60-bucket maximum always mean 60 months?

Can missing intervals be treated as zero or a decline in traffic?