Ahrefs Keyword ideas API
Get related keyword suggestions for any seed term, each with an Ahrefs difficulty and search-volume bucket.
$5.01/1k req, pay per request, no subscription.
{"sourceKeyword": "coffee","country": "us","searchEngine": "Google","ideas": [...],"questions": [...]}
Pricing
Ahrefs Keyword ideas API pricing
Try it
Get Ahrefs keyword ideas in one request
This sample shows 16 of 17 fields. See every field
{
"found": true,
"data": {
"items": [
{
"sourceKeyword": "coffee",
"country": "us",
"searchEngine": "Google",
"ideas": [
{
"keyword": "coffee shops near me",
"difficulty": "E",
"volume": "A",
"updatedAt": "2026-09-14T00:00:00Z"
},
{
"keyword": "best coffee beans",
"difficulty": "M",
"volume": "B",
"updatedAt": "2026-09-14T00:00:00Z"
},
{
"keyword": "cold brew coffee recipe",
"difficulty": "E",
"volume": "C",
"updatedAt": "2026-09-10T00:00:00Z"
}
],
"questions": [
{
"keyword": "how much caffeine is in coffee",
"difficulty": "E",
"volume": "B",
"updatedUtc": 1757808000
},
{
"keyword": "is coffee good for you",
"difficulty": "M",
"volume": "C",
"updatedUtc": 1757462400
}
]
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-31 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- keywordstring
coffee
The seed keyword to expand into related suggestions (e.g. "coffee").
- countrystring
us
Two-letter country code that scopes the suggestions (e.g. us, gb, de).
Response
JSON, one example value per field.
Keyword-idea records: the seed keyword and its related keyword suggestions, each with an Ahrefs difficulty and search-volume bucket. Populated whenever the provider has data for the entity.
- countrystring
us
Two-letter country code the suggestions are scoped to.
- searchEnginestring
Google
Search engine the suggestions are drawn from (e.g. Google).
- sourceKeywordstring
coffee
The seed keyword the suggestions were expanded from. Populated whenever the provider has data for the entity.
Related keyword suggestions for the seed term. Populated whenever the provider has data for the entity.
- difficultystring
E
Relative Ahrefs difficulty bucket (a letter such as E, M, or H), not an exact number.
- keywordstring
coffee shops near me
The suggested related keyword. Populated whenever the provider has data for the entity.
- updatedAtstring
2026-09-14T00:00:00Z
Timestamp the suggestion metrics were last updated.
- volumestring
A
Relative search-volume bucket (a letter grade), not an exact number.
Question-shaped keyword suggestions for the seed term.
- difficultystring
E
Relative Ahrefs difficulty bucket (a letter such as E, M, or H), not an exact number.
- keywordstring
how much caffeine is in coffee
The suggested question keyword.
- updatedUtcnumber
1757808000
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- volumestring
B
Relative search-volume bucket (a letter grade), not an exact number.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Ahrefs Keyword ideas API
The AnyAPI Ahrefs Keyword ideas API returns Ahrefs keyword ideas data as normalized JSON from one POST call to /v1/run/ahrefs.keyword_ideas. Get related keyword suggestions for any seed term, each with an Ahrefs difficulty and search-volume bucket. AnyAPI returns one normalized schema whichever source serves it. It costs from $5.01 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Ahrefs keyword ideas calls through AnyAPI succeeded, with a median response time of 9.2 seconds across 148 measured calls.