Ahrefs API
Ahrefs Keyword ideas API
Get related keyword suggestions for any seed term, each with an Ahrefs difficulty and search-volume bucket.
POST/v1/run/ahrefs.keyword_ideas
Uptime
100.00%
30d · 1 call
Requests
1
30d
Response
18.5s
median · 30d
Try it
Make your first request
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
"data": {
"items": [
{
"country": "US",
"ideas": [
{
"difficulty": "example",
"keyword": "a1b2c3d4",
"updatedAt": "2024-01-15T09:30:00Z",
"volume": "example"
}
],
"searchEngine": "example",
"sourceKeyword": "https://example.com/page"
}
]
},
"found": true
}Response interface
interface AhrefsKeywordIdeasResponse {
data: {
items: {
country?: string;
ideas?: {
difficulty?: string;
keyword: string;
updatedAt?: string;
volume?: string;
}[];
searchEngine?: string;
sourceKeyword: string;
}[];
} | null;
found: boolean;
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
Request, response, and price
Last verified 2026-09-16 · uptime and latency measured over 30dPOST /v1/run/ahrefs.keyword_ideas
curl -X POST https://api.getanyapi.com/v1/run/ahrefs.keyword_ideas \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"country":"us","keyword":"coffee"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| keyword | string | "coffee"The seed keyword to expand into related suggestions (e.g. "coffee"). |
| country | string | "us"Two-letter country code that scopes the suggestions (e.g. us, gb, de). |
| Response | ||
| data | object | |
| data.items | object[] | 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. |
| data.items[].country | string | Two-letter country code the suggestions are scoped to. |
| data.items[].ideas | object[] | Related keyword suggestions for the seed term. Populated whenever the provider has data for the entity. |
| data.items[].ideas[].difficulty | string | Relative Ahrefs difficulty bucket (a letter such as E, M, or H), not an exact number. |
| data.items[].ideas[].keyword | string | The suggested related keyword. Populated whenever the provider has data for the entity. |
| data.items[].ideas[].updatedAt | string | Timestamp the suggestion metrics were last updated. |
| data.items[].ideas[].volume | string | Relative search-volume bucket (a letter grade), not an exact number. |
| data.items[].searchEngine | string | Search engine the suggestions are drawn from (e.g. Google). |
| data.items[].sourceKeyword | string | The seed keyword the suggestions were expanded from. Populated whenever the provider has data for the entity. |
| found | boolean | |
| Price | ||
| Price per request | USD | $0.00501 |
| Price /1k req | USD | $5.01 |
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 18.5 seconds across 1 measured calls.
It costs from $5.01 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.
Get related keyword suggestions for any seed term, each with an Ahrefs difficulty and search-volume bucket. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.
Over the last 30 days, 100.0% of Ahrefs keyword ideas calls through AnyAPI succeeded, with a median response time of 18.5 seconds across 1 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.