Find Related Keyword Ideas · Ahrefs

Enter 1–100 seed keywords as an array and a country code to find related ideas with search volume, organic ranking difficulty and CPC.

Your AI

Use with your AI

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

CodexClaude CodeCursorWindsurfCline

View instructions

Use related-keywords-ahrefs (Tool ID 5e20cd0b-a6ce-4082-bd08-dd0e93aa574b). Reuse my Toolmu connection or follow https://toolmu.com/SKILL.md, within my current authorization and budget. Ask for country and keywords if missing. Send queryParams country us, keywords ["coffee beans"], limit 20 and order_by volume:desc; omit where unless I request a filter. Use an array of 1–100 nonempty strings. Compare the actual related ideas, which need not contain seed words. The limit caps the returned idea list, not results per seed. Explain volume as estimated average monthly searches over the latest known 12 months and difficulty as estimated organic top-10 ranking difficulty on a 100-point scale. The source API defines CPC in USD cents, but confirm the actual returned unit before conversion; divide by 100 only when cents are established. CPC is an ad-click metric, not the Toolmu execution charge. Preserve missing metrics as unknown, not zero. Do not claim an LSI algorithm, fixed related-term mode, complete coverage, live SERP results or ranking/traffic gains. Use only the five supported inputs; no terms/view/date/select controls or CSV keywords. Additional calls require authorization.

Task:
Find up to [20] searches for [coffee beans] in [United States]. Show how often people search for each one per month, how hard it may be to appear in Google's top 10 without ads, and what an ad click usually costs. Missing data is unknown; estimates don't promise rankings or visits.

Paste into your connected AI's conversation.

Connection guide

Up to 7.92 credits / call

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

Ahrefs

Find Related Keyword Ideas · Ahrefs

Enter 1–100 seed keywords as an array and a country code to find related ideas with search volume, organic ranking difficulty and CPC.

You receive

Get a bounded list of related keyword ideas and their available metrics. The ideas need not contain your seed words and can help you compare related topics.

Start with your task

Find up to [20] searches for [coffee beans] in [United States]. Show how often people search for each one per month, how hard it may be to appear in Google's top 10 without ads, and what an ad click usually costs. Missing data is unknown; estimates don't promise rankings or visits.

What to know

The cap applies to the returned idea list, not a promised number per seed. Ideas and metrics may be missing; the report does not guarantee current search results, rankings or traffic. Confirm the returned CPC unit before converting it.

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 `country, keywords`
Maximum idea rows`queryParams.limit`	`integer`	Optional	Optional integer from 1 to 100; default 100. Caps the returned idea list, not ideas per seed. The actual list can be shorter or empty. Default `100` Minimum `1` Maximum `100`
Optional idea filter`queryParams.where`	`string`	Optional	Nonempty string containing an Ahrefs JSON filter expression. Supported fields: keyword, volume, difficulty and cpc. Confirm the returned CPC unit before applying a monetary interpretation to a filter. Minimum length `1`
Country market`queryParams.country`	`string`	Required	Required two-letter ISO 3166-1 alpha-2 country code, such as us. Selects the country market for the query; it is not a keyword-language selector. Minimum length `2` Maximum length `2`
Seed-keyword array`queryParams.keywords`	`array`	Required	Required array of 1–100 nonempty strings, for example ["coffee beans"]. Supply an array rather than a comma-separated string. Related ideas need not contain the seed words; results are not guaranteed separately for every seed. Minimum items `1` Maximum items `100`
[]`queryParams.keywords[]`	`string`	—	Minimum length `1`
Optional idea order`queryParams.order_by`	`string`	Optional	Comma-separated field or field:desc. Supported fields: keyword, volume, difficulty and cpc. For example, volume:desc orders by search volume. No default order is promised here. Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "country",
        "keywords"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "limit": {
          "type": "integer",
          "default": 100,
          "maximum": 100,
          "minimum": 1,
          "description": "Maximum number of rows to return (the cost budget — billing is per row). Defaults to 100; max 100."
        },
        "where": {
          "type": "string",
          "minLength": 1,
          "description": "JSON filter expression (see the Ahrefs filter syntax docs). Filterable fields: keyword, volume, difficulty, cpc."
        },
        "country": {
          "type": "string",
          "maxLength": 2,
          "minLength": 2,
          "description": "Two-letter country code (ISO 3166-1 alpha-2), e.g. 'us'."
        },
        "keywords": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          },
          "maxItems": 100,
          "minItems": 1,
          "description": "Keywords to analyze (up to 100). Each returned keyword is one billed row."
        },
        "order_by": {
          "type": "string",
          "minLength": 1,
          "description": "Sort order: 'field' or 'field:desc', comma-separated. Sortable fields: keyword, volume, difficulty, cpc."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Use related ideas to widen your topic research beyond phrases that contain the seed words. Compare the actual suggestions with the topic you intend to cover; a returned relationship does not prove relevance to your particular audience or a ranking opportunity.

Search volume is an estimated monthly average over the latest known 12 months, not unique people, clicks or your site's traffic. Difficulty concerns organic top-10 rankings. CPC describes paid-search ad clicks; the source API uses USD cents, so keep the actual returned unit and convert only after it is confirmed.

Retain the country, seeds, row cap and any filters with your shortlist. Missing metrics stay unknown. A bounded idea list does not establish complete coverage, fresh live search results or future traffic.

Ahrefs related-term definitions

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

No. Ahrefs describes related terms through keywords that top-ranking pages also rank for or frequently mention. Ideas can extend beyond seed-containing phrases. This Tool does not expose separate controls for those relationship modes.

Find Related Keyword Ideas · Ahrefs

Find Related Keyword Ideas · Ahrefs

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Find searches related to coffee

Explore searches about bread

Plan content about home coffee

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Find searches related to coffee

Explore searches about bread

Plan content about home coffee

Questions about this tool.

Must every idea contain my seed words?

How should I read volume, difficulty and CPC?

Will 100 seeds return 100 ideas for each seed?