{"openapi":"3.2.0","info":{"title":"Ahrefs Metrics API","description":"Fastest comprehensive domain & keyword insights with our Metrics API – analyze Domain Authority, Keyword Difficulty (KD), URL Rank, Traffic, Backlinks, website data analysis, domain rating, competitor research, keyword tracking, link building, SEO Audit, website Data, Domain Rating, Keyword Difficulty, URL Rank, Website Analysis, Competitor Research, Organic Keywords & Traffic, Keyword Generator, Referring Domains, Link Building, SERP Rank Checker, SEO Metrics, Ahrefs, Moz Pro, Similarweb, Semrush, Surfer SEO, Majestic, SpyFu, Whois, Ubersuggest","version":"1.0.0"},"servers":[{"url":"https://ahrefs-metrics.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Ahrfs API"}],"x-agent-commerce":{"catalog_url":"https://ahrefs-metrics.jojapi.net/_jojapi/agent/plans","discovery_url":"https://ahrefs-metrics.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/ahrefs-metrics","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/keyword-metrics":{"get":{"operationId":"get_keyword_metrics","summary":"Keyword Metrics","description":"Retrieves detailed metrics for a keyword, including search volume, estimated clicks, CPC, keyword difficulty, global search volume, and traffic potential.","tags":["Ahrfs API"],"responses":{"200":{"description":"Keyword metrics response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"searchVol":{"type":"integer","description":"Monthly search volume"},"clicks":{"type":"integer","description":"Estimated monthly clicks"},"cpc":{"type":"number","description":"Average cost per click (USD)"},"difficulty":{"type":"integer","description":"Keyword Difficulty (0-100)"},"globalSearchVol":{"type":"integer","description":"Global monthly search volume"},"trafficPotential":{"type":"integer","description":"Estimated achievable traffic"}}},"requestId":{"type":"string"}}},"examples":{"success":{"value":{"success":true,"data":{"searchVol":1000,"clicks":800,"cpc":1.5,"difficulty":35,"globalSearchVol":5000,"trafficPotential":2000},"requestId":"550e8400-e29b-41d4-a716-446655440000"}},"error":{"value":{"success":false,"message":"Invalid domain name","requestId":"550e8400-e29b-41d4-a716-446655440000"}}}}}}},"parameters":[{"name":"keyword","in":"query","description":"Target keyword to analyze","required":true,"schema":{"type":"string"}},{"name":"country","in":"query","description":"Target country (2-letter code, e.g. 'us'). Default is 'us'.","required":false,"schema":{"type":"string","example":"us","default":"us"}}]}},"/basic-metrics":{"get":{"operationId":"get_basic_metrics","summary":"Basic Metrics","description":"Retrieves basic domain metrics, including Domain Rating (DR) and Ahrefs Rank (AR), for a given URL.","tags":["Ahrfs API"],"responses":{"200":{"description":"Basic domain metrics response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"domainRating":{"type":"integer","description":"Domain Rating (0-100)"},"ahrefsRank":{"type":"integer","description":"Ahrefs Rank"}}},"requestId":{"type":"string"}}},"examples":{"error":{"value":{"success":false,"message":"Invalid domain name","requestId":"550e8400-e29b-41d4-a716-446655440000"}},"success":{"value":{"success":true,"data":{"domainRating":45,"ahrefsRank":123456},"requestId":"550e8400-e29b-41d4-a716-446655440000"}}}}}}},"parameters":[{"name":"url","in":"query","description":"Target URL to analyze (e.g. https://ahrefs.com)","required":true,"schema":{"type":"string","example":"https://ahrefs.com"}}]}},"/url-parser":{"get":{"operationId":"get_url_parser","summary":"URL Parser","description":"Parses a URL and returns its components: hostname, pathname, query parameters, protocol, port, hash, and origin.","tags":["Ahrfs API"],"responses":{"200":{"description":"Parsed URL components","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"url":{"type":"string"},"hostname":{"type":"string"},"pathname":{"type":"string"},"params":{"type":"object","additionalProperties":{"type":"string"}},"protocol":{"type":"string"},"port":{"type":"string"},"hash":{"type":"string"},"origin":{"type":"string"}}},"requestId":{"type":"string"}}},"examples":{"error":{"value":{"success":false,"message":"Invalid domain name","requestId":"550e8400-e29b-41d4-a716-446655440000"}},"success":{"value":{"success":true,"data":{"url":"https://example.com:8080/path?foo=bar#section","hostname":"example.com","pathname":"/path","params":{"foo":"bar"},"protocol":"https","port":"8080","hash":"#section","origin":"https://example.com:8080"},"requestId":"550e8400-e29b-41d4-a716-446655440000"}}}}}}},"parameters":[{"name":"url","in":"query","description":"Target URL to parse","required":true,"schema":{"type":"string"}}]}},"/url-metrics":{"get":{"operationId":"get_url_metrics","summary":"URL Metrics","description":"Retrieves detailed metrics for a specific URL, including page-level and domain-level statistics such as URL Rating (UR), word count, backlinks, referring domains, organic keywords, traffic volume, and value.","tags":["Ahrfs API"],"responses":{"200":{"description":"Detailed URL and domain metrics","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"page":{"type":"object","properties":{"urlRating":{"type":"integer","description":"URL Rating (UR)"},"noOfWordsOnPage":{"type":"integer","description":"Word count on page"},"backlinks":{"type":"integer","description":"Backlinks to URL"},"refDomains":{"type":"integer","description":"Referring domains to URL"},"organicKeywords":{"type":"integer","description":"Ranking keywords for URL"},"trafficVol":{"type":"integer","description":"Estimated organic traffic"},"trafficValue":{"type":"number","description":"Traffic value (USD)"}}},"domain":{"type":"object","properties":{"domainRating":{"type":"integer","description":"Domain Rating (DR)"},"ahrefsRank":{"type":"integer","description":"Ahrefs Rank"},"backlinks":{"type":"integer","description":"Domain backlinks"},"refDomains":{"type":"integer","description":"Domain referring domains"},"organicKeywords":{"type":"integer","description":"Domain ranking keywords"},"trafficVol":{"type":"integer","description":"Domain organic traffic"},"trafficValue":{"type":"number","description":"Domain traffic value (USD)"}}}}},"requestId":{"type":"string"}}},"examples":{"success":{"summary":"success","value":{"success":true,"data":{"page":{"urlRating":40,"noOfWordsOnPage":800,"backlinks":120,"refDomains":30,"organicKeywords":15,"trafficVol":500,"trafficValue":25.5},"domain":{"domainRating":70,"ahrefsRank":12345,"backlinks":1000,"refDomains":200,"organicKeywords":150,"trafficVol":10000,"trafficValue":500}},"requestId":"550e8400-e29b-41d4-a716-446655440000"}},"error":{"summary":"error","value":{"success":false,"message":"Invalid domain name","requestId":"550e8400-e29b-41d4-a716-446655440000"}}}}}}},"parameters":[{"name":"url","in":"query","description":"Target URL to analyze (e.g. https://ahrefs.com/blog/)","required":true,"schema":{"type":"string"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}