Review a Keyword's Organic SERP · Ahrefs

Enter one keyword and a country code to review Ahrefs' available organic search results, with result positions, page URLs and titles, page-level UR, backlink counts, referring domains and estimated traffic.

Your AI

Use with your AI

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

CodexClaude CodeCursorWindsurfCline

View instructions

Use serp-overview-ahrefs (Tool ID c0197ccf-5367-401c-a26e-546d3092f1ad). Reuse my Toolmu connection or follow https://toolmu.com/SKILL.md, within my current authorization and budget. Ask for keyword and country if missing. Send queryParams keyword coffee beans, country us, top_positions 10; omit date to request the most recent available overview. A historical date, if requested, uses only YYYY-MM-DD; do not invent a precise timestamp, cutoff or timezone conversion. Most recent available is not guaranteed live. top_positions selects positions 1..N, not N guaranteed organic rows: SERP features are not returned, so preserve source positions and gaps without renumbering. Review only supported available position, page URL/title, UR, backlinks, referring domains and estimated traffic. UR is page-level backlink strength on a 100-point logarithmic scale, not DR, a quality score or a ranking guarantee; do not interpret differences as linear multiples. Distinguish backlink occurrences from unique source domains per page. Page traffic is an estimated monthly total from ALL its ranking keywords, not traffic from this query alone or measured analytics. Keep null/missing metrics unknown, not zero; do not invent DR/AR/top keyword/features/update dates or a success prediction. Use only the four supported inputs. Additional snapshots or ongoing tracking require authorized calls.

Task:
For [coffee beans] in [United States], show up to [10] latest Google results without ads. List each page's place, address and title, a score about its links, and how many links and websites point to it, plus monthly visits from all searches. Gaps may occur; this is one snapshot, not live.

Paste into your connected AI's conversation.

Connection guide

Up to 7.2 credits / call

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

Ahrefs

Review a Keyword's Organic SERP · Ahrefs

You receive

Get the organic result records within a chosen SERP position range. Compare the available page details and link metrics; each page's traffic estimate covers its monthly organic traffic from all ranking keywords, not just your query.

Start with your task

For [coffee beans] in [United States], show up to [10] latest Google results without ads. List each page's place, address and title, a score about its links, and how many links and websites point to it, plus monthly visits from all searches. Gaps may occur; this is one snapshot, not live.

What to know

SERP features are omitted, so positions 1–N can yield fewer than N records and gaps in positions. The overview is an available Ahrefs snapshot, not a guaranteed live search. Missing fields stay unknown and page metrics do not guarantee ranking success.

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 `keyword, country`
Optional historical date`queryParams.date`	`string`	Optional	Optional YYYY-MM-DD date, such as 2026-10-01. Requests an available historical overview; exact day cutoff and source timestamp adaptation are unspecified. Omit it for the most recent available overview, not guaranteed live results. Pattern `^\d{4}-\d{2}-\d{2}$`
Country market`queryParams.country`	`string`	Required	Required two-letter ISO 3166-1 alpha-2 code, such as us. Selects the country for the overview; no device, city or separate language controls are exposed. Minimum length `2` Maximum length `2`
One keyword`queryParams.keyword`	`string`	Required	Required nonempty string, such as coffee beans. This is the query whose overview is requested, not a target website or an array of keywords. Minimum length `1`
SERP position range`queryParams.top_positions`	`integer`	Optional	Optional integer from 1 to 100; default 100. Selects organic records in positions 1 through N, not N guaranteed rows. SERP features are omitted, so actual rows can be fewer and positions have gaps. Default `100` Minimum `1` Maximum `100`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "keyword",
        "country"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Report date in YYYY-MM-DD format. Use today's date for current values."
        },
        "country": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Two-letter country code (ISO 3166-1 alpha-2), e.g. 'us'."
        },
        "keyword": {
          "type": "string",
          "minLength": 1,
          "description": "The keyword to analyze."
        },
        "top_positions": {
          "type": "integer",
          "default": 100,
          "maximum": 100,
          "minimum": 1,
          "description": "How many top positions to return (one billed row per position). Defaults to 100 (the maximum)."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Compare the actual ranking pages using their titles, URLs and available metrics. A result page's referring-domain count deduplicates its sources, while its backlink count measures links. Different result pages can share source domains, so summing their domain counts does not produce a unique total for the whole SERP.

Keep the keyword, country, requested position range and any date with the comparison. UR describes a page's link profile on a logarithmic scale; a score difference is not a linear strength multiple or a promise of ranking success. Traffic estimates concern the page across its ranking keywords, not only the query you supplied.

Ahrefs SERP overview definitions · Ahrefs URL Rating explanation

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

The Tool returns organic records within positions 1–10. SERP features occupying some positions are omitted, so the list can be shorter and positions may have gaps. Keep the reported positions rather than renumbering them.

Review a Keyword's Organic SERP · Ahrefs

Review a Keyword's Organic SERP · Ahrefs

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Check Google results for one search

See fewer search results

See a page's links and visit estimates

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Check Google results for one search

See fewer search results

See a page's links and visit estimates

Questions about this tool.

Why can a range of 10 positions return fewer than 10 rows?

Is this live, and how does the optional date work?

What do the page metrics mean?