AnyAPI ahrefs.keywords (Ahrefs Keyword Difficulty)

{ "bodyFields": { "country": { "default": "us", "description": "Two-letter country code that scopes volume and difficulty (e.g. us, gb, de).", "type": "string" }, "keyword": { "description": "The search term to analyze (e.g. \"seo tools\").", "type": "string" } }, "bodyType": "json", "discoverable": true, "method": "POST", "type": "http" }

{ "properties": { "costUsd": { "description": "USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.", "type": "number" }, "items": { "description": "Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.", "type": "integer" }, "jqError": { "description": "Present only when a `jq` expression failed; `output` then carries the full unshaped result and this explains why the reshape did not apply.", "type": "string" }, "output": { "anyOf": [ { "additionalProperties": false, "properties": { "data": { "oneOf": [ { "type": "null" }, { "additionalProperties": false, "properties": { "items": { "description": "Keyword-difficulty records: the difficulty score and the referring-domain gap needed to rank in the top 10. Populated whenever the provider has data for the entity.", "items": { "properties": { "country": { "description": "Two-letter country code the metrics are scoped to.", "type": "string" }, "difficulty": { "description": "Ahrefs Keyword Difficulty, 0-100.", "type": "integer" }, "keyword": { "description": "Populated whenever the provider has data for the entity.", "type": "string", "x-anyapi-must-populate": true }, "referringDomainsToRank": { "description": "Estimated number of referring domains a page needs to rank in the top 10 for this keyword.", "type": "integer" } }, "required": [ "keyword" ], "type": "object" }, "type": "array", "x-anyapi-must-populate": true } }, "required": [ "items" ], "type": "object" } ] }, "found": { "type": "boolean" } }, "required": [ "found", "data" ], "title": "Ahrefs keyword difficulty output", "type": "object" }, { "type": "null" } ], "description": "Normalized output, or null when the replay payload was not retained." }, "provider": { "description": "Always \"AnyAPI\".", "type": "string" }, "replayed": { "description": "True when this response replays the durable result of an earlier run without billing or upstream execution.", "type": "boolean" }, "resultId": { "description": "Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache.", "type": "string" } }, "required": [ "output", "provider", "costUsd", "replayed" ], "type": "object" }