---
ref: tool:ahrefs/get-keyword-overview
name: Get keyword search volume
company: company:ahrefs
workflows: [workflow:seo-topical-clusters]
access: [api]
tags: [capability:research-keywords, category:data-provider, has:api]
docs: https://docs.ahrefs.com/en/api/reference/keywords-explorer/get-overview
updated: 2026-09-29
---

# Get keyword search volume

Returns search volume, difficulty and other metrics for up to a batch of keywords in one country.

Note: `select` and `country` are required; `keywords` takes a comma-separated list.

## Set up

Use the first option your agent supports.

### API (official)

- Base URL: https://api.ahrefs.com/v3
- Endpoint: `GET /keywords-explorer/overview`
- Auth: send the header `Authorization: Bearer $AHREFS_API_KEY`
- Docs: https://docs.ahrefs.com/en/api/docs/introduction

Note: Only workspace owners and admins can create keys, in Account settings, API keys.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.