Compare a Keyword's Search Volume by Country · Ahrefs

Provide one keyword to compare its estimated average monthly search volume across returned countries. Choose a maximum number of country rows, from 1 to 250.

Your AI

Use with your AI

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

CodexClaude CodeCursorWindsurfCline

View instructions

Use volume-by-country-ahrefs (Tool ID 00d56782-3f30-46b9-9a7a-cef898ec19a5). Reuse my Toolmu connection or follow https://toolmu.com/SKILL.md, within my current authorization and budget. Ask for keyword if missing. Send queryParams keyword coffee beans and limit 20. Show country codes and estimated average monthly searches, then sort only the returned subset for comparison. Limit is a maximum country-row count, from 1 to 250, default 100; it does not guarantee top-volume countries or worldwide coverage. Country coverage, row selection, averaging window and update time are unspecified; do not assume a 12-month mean or current-month counts. Preserve absent countries and missing values as unknown, not zero. Do not turn a partial sum into global volume or market shares, or equate searches with people, site visits, conversions or revenue. Keep the supplied keyword; do not add country/date/language filters, translations, ideas, history, KD or CPC. Additional keyword queries require calls within my existing authorization and budget.

Task:
For [words people search for], compare how often people search them each month in different countries. List returned countries with estimated counts, most to fewest. If a country is missing, that does not mean zero searches; this is not worldwide. Keep the words as entered; do not translate.

Paste into your connected AI's conversation.

Connection guide

Up to 9.9 credits / call

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

Ahrefs

Compare a Keyword's Search Volume by Country · Ahrefs

Provide one keyword to compare its estimated average monthly search volume across returned countries. Choose a maximum number of country rows, from 1 to 250.

You receive

Receive country codes with search-volume estimates for the same keyword. Your Agent can sort the returned countries and compare their estimates to identify markets for further research.

Start with your task

For [words people search for], compare how often people search them each month in different countries. List returned countries with estimated counts, most to fewest. If a country is missing, that does not mean zero searches; this is not worldwide. Keep the words as entered; do not translate.

What to know

The list may be partial, and a row cap does not guarantee the highest-volume countries or worldwide coverage. Missing countries are not zero-volume countries. These are estimated search counts, not people, visits or revenue; the exact averaging window and latest update are unspecified.

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`
Maximum country rows`queryParams.limit`	`integer`	Optional	Optional integer from 1 to 250; default 100. Caps returned country records, without guaranteeing that count, top-volume ordering or complete worldwide coverage. Default `100` Minimum `1` Maximum `250`
Keyword`queryParams.keyword`	`string`	Required	Required single nonempty keyword string, such as coffee beans. This is not a keyword array and does not request automatic translation. Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "keyword"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "limit": {
          "type": "integer",
          "default": 100,
          "maximum": 250,
          "minimum": 1,
          "description": "Maximum number of countries to return (one billed row per country). Defaults to 100; max 250."
        },
        "keyword": {
          "type": "string",
          "minLength": 1,
          "description": "The keyword to analyze."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Interpret country comparisons carefully

Keep the country code next to each estimate so the value stays tied to its market. Sorting the available rows can make comparisons easier; it does not show where an omitted country belongs.

A sum of a limited list is only a subtotal of that list. Without complete coverage, it cannot establish global search volume or each country's share of all searches. The report is an average-month estimate, not a chosen month's history.

Ahrefs volume-by-country documentation defines the source metric.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

It caps the number of country rows. The source does not define the selection or ordering here, so it does not establish the top 20. Your Agent can sort the rows actually returned.

Compare a Keyword's Search Volume by Country · Ahrefs

Compare a Keyword's Search Volume by Country · Ahrefs

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Interpret country comparisons carefully

Enter words people search for

Choose how many countries to show

Compare only countries in the list

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Interpret country comparisons carefully

Enter words people search for

Choose how many countries to show

Compare only countries in the list

Questions about this tool.

Does limit 20 mean the 20 highest-volume countries?

Can I request only one country or automatically translate the keyword?

Does search volume tell me how many customers a market contains?