See Your Website in Search Results Over Time · Ahrefs

Choose a website or page link and a date range to see how many different searches showed it in ordinary search results over time. View daily, weekly or monthly history. Some dates may have no record; totals do not name individual searches or explain changes.

Your AI

Use with your AI

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

CodexClaude CodeCursorWindsurfCline

View instructions

Use Ahrefs search history in Toolmu with my existing connection and stay within my existing authorization. I can provide a website or page link, a start date, an optional end date, a country name and a daily, weekly or monthly view. Understand natural dates and full country names; do not ask me to look up codes or enter a special date format. Use monthly history by default and today as the end date when I do not give one. One request can cover up to 60 time periods; if my chosen range would be longer, ask me to shorten it. Show counts for searches where the site appeared in regular result positions 1–3, 4–10, 11–20, 21–50 and 51 or later. Leave dates with no returned record blank. These totals do not list individual searches, exact position changes or reasons. Use the full website by default; if I ask for one page, check only that page. Keep the same website, country and time view when comparing periods. Do not add paid requests automatically.

Task:
For [https://example.com], show [monthly] history from [July 2026] to [September 2026]. Count different searches that showed the site in search results without ads: top 3, 4–10, 11–20, 21–50, or 51 and later. Leave missing months blank; totals do not name searches or explain changes.

Paste into your connected AI's conversation.

Connection guide

Up to 1.296 credits / call

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

Ahrefs

See Your Website in Search Results Over Time · Ahrefs

You receive

Get dated keyword counts for positions 1–3, 4–10, 11–20, 21–50 and 51+. Your Agent can organize the available groups chronologically and compare changes in the target's ranking distribution using a consistent scope and search country.

Start with your task

For [https://example.com], show [monthly] history from [July 2026] to [September 2026]. Count different searches that showed the site in search results without ads: top 3, 4–10, 11–20, 21–50, or 51 and later. Leave missing months blank; totals do not name searches or explain changes.

What to know

Each request covers at most 60 time groups, and historical gaps may remain. The counts do not identify individual keywords, ranking URLs or exact positions, and a change does not establish its cause.

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. Keep the scope consistent across comparisons. 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 and protocol, selects the target whose ranking keyword counts are reported. Minimum length `1`
Search country`queryParams.country`	`string`	Optional	Optional two-letter ISO 3166-1 alpha-2 country code, such as us. Set it explicitly and keep it consistent for a country-specific comparison. Minimum length `2` Maximum length `2`
End date`queryParams.date_to`	`string`	Optional	Optional historical end date in YYYY-MM-DD format; defaults to today. This selects the report period, not the retrieval timestamp. An explicit end date makes the intended comparison window clear. Pattern `^\d{4}-\d{2}-\d{2}$`
Target protocol`queryParams.protocol`	`string`	Optional	Optional both, http or https; default both. Selects the target URL protocol included in the report. Keep it consistent when comparing periods. Default `both` Options `both, http, https`
Start date`queryParams.date_from`	`string`	Required	Required historical start date in YYYY-MM-DD format. Choose it with the end date and grouping so the range covers at most 60 time groups. Pattern `^\d{4}-\d{2}-\d{2}$`
Time grouping`queryParams.history_grouping`	`string`	Optional	Optional daily, weekly or monthly; default monthly. Sets the interval for history records, with at most 60 groups per request. It does not establish a particular average or snapshot rule. 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

These records describe the size of each organic ranking band in Ahrefs' history. A larger top-three count does not mean every keyword rose, and the counts do not describe search volume or visits. Keep the reported 51+ band as defined by the source.

A chronological table or trend summary is additional Agent analysis. Retain the dates and counts actually returned rather than assuming complete history, filling gaps or inferring why the distribution changed. The request reads recorded history and does not schedule ongoing checks.

Ahrefs ranking keyword count definitions

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

The report gives counts in position bands, not a list of keyword names or exact positions. An increase in the top-three count alone does not identify which keywords improved.

See Your Website in Search Results Over Time · Ahrefs

See Your Website in Search Results Over Time · Ahrefs

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

See a website's monthly search history

Check one page only

See weekly search results in one country

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

See a website's monthly search history

Check one page only

See weekly search results in one country

Questions about this tool.

Can I see which keywords moved?

Does the 60-group limit always mean 60 days?

Does a change prove an algorithm or content effect?