Find Search Suggestions · Ahrefs

Enter 1–100 seed keywords as an array and a country code to find autocomplete-style keyword suggestions with search volume 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 search-suggestions-ahrefs (Tool ID 669737a0-aa5d-4f1a-ae03-7cc09215f4ef). 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. Review actual search-suggestion phrases with available volume and CPC, then explain your topic-relevance shortlist. The cap applies to the returned list, not a quota per seed; do not promise complete results or that every suggestion contains the seed. Explain volume as estimated average monthly searches over the latest known 12 months. The source API defines CPC in USD cents; confirm the actual returned unit and divide by 100 only when cents are established. CPC is an ad-click metric, not the Toolmu charge. Keep missing metrics unknown, not zero. Do not add difficulty or related-term modes from other Tools, claim a live search-box match, invent results or predict ranking/traffic gains. Use only the five supported inputs. Additional calls require authorization.

Task:
Find up to [20] related searches for [coffee beans] in [United States]. Show how often each is searched monthly and what an ad click usually costs if known. Missing data is unknown. These are ideas, not Google's suggestions as you type, and estimates don't promise rankings or visitors.

Paste into your connected AI's conversation.

Connection guide

Up to 4.32 credits / call

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

Ahrefs

Find Search Suggestions · Ahrefs

Enter 1–100 seed keywords as an array and a country code to find autocomplete-style keyword suggestions with search volume and CPC.

You receive

Get a bounded list of suggested search phrases and their available volume and CPC metrics, then shortlist phrases relevant to your topic.

Start with your task

Find up to [20] related searches for [coffee beans] in [United States]. Show how often each is searched monthly and what an ad click usually costs if known. Missing data is unknown. These are ideas, not Google's suggestions as you type, and estimates don't promise rankings or visitors.

What to know

This is an Ahrefs suggestion report, not a guaranteed live search-box response. Suggestions and metrics may be missing; the cap applies to the returned list, not a quota per seed. 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 suggestion rows`queryParams.limit`	`integer`	Optional	Optional integer from 1 to 100; default 100. Caps the returned suggestion list, not rows per seed. Actual results can contain fewer rows or none. Default `100` Minimum `1` Maximum `100`
Optional suggestion filter`queryParams.where`	`string`	Optional	Nonempty string containing an Ahrefs JSON filter expression. Supported fields: keyword, volume and cpc. Confirm CPC units before interpreting a monetary threshold; difficulty is not a supported 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 query market, not a separate keyword-language option. Minimum length `2` Maximum length `2`
Seed-keyword array`queryParams.keywords`	`array`	Required	Required array of 1–100 nonempty strings, for example ["coffee beans"]. Use an array rather than a comma-separated string. Per-seed output counts and seed containment are not guaranteed. Minimum items `1` Maximum items `100`
[]`queryParams.keywords[]`	`string`	—	Minimum length `1`
Optional suggestion order`queryParams.order_by`	`string`	Optional	Comma-separated field or field:desc. Supported fields: keyword, volume and cpc. For example, volume:desc orders by search volume. This order is not the original order in a live search box. 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, 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, cpc."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Choose suggested phrases for their relevance to the topic you plan to cover. If the actual list includes questions or modifiers, your Agent can organize them for review; those categories and long-tail phrasing are not guaranteed for every seed.

Keep the country, seeds, filters and row cap with your shortlist. Search volume is a latest-known 12-month monthly average estimate, so it does not measure current clicks or your future traffic. Missing metrics stay unknown. Preserve the actual CPC unit before making comparisons or conversions.

Suggestions are research candidates. Their presence does not prove audience fit, a currently displayed search-box suggestion or an attainable ranking.

Ahrefs search-suggestion definitions

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

That is not guaranteed. It requests autocomplete-style suggestions through Ahrefs; the immediate collection time, source search engine and original suggestion order are not established here. Treat the response as an Ahrefs suggestion report.

Find Search Suggestions · Ahrefs

Find Search Suggestions · Ahrefs

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Find searches related to matcha

Explore searches about camping

Research emergency plumbing searches

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Find searches related to matcha

Explore searches about camping

Research emergency plumbing searches

Questions about this tool.

Will this match what a search box suggests right now?

What do volume and CPC measure?

How does the cap work with several seeds?