All tools
A
by Ahrefs
Get keyword search volume
Returns search volume, difficulty and other metrics for up to a batch of keywords in one country.
Updated Sep 29, 2026
get-keyword-overview.md
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.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | GET /keywords-explorer/overview | API key in $AHREFS_API_KEY | Docs |
