positions_metrics - Ahrefs API

Ahrefs API v2 has been deprecated

This documentation is for the legacy version of our API (v2), which was discontinued on March 1st, 2024. Existing API v2 integration apps are not affected and continue to work as before, but new submissions are no longer accepted.

To switch to API v3, please contact our Enterprise team. Read about API v3.

Documentation - positions_metrics

Contains the estimation of number of keywords, traffic and cost of the target URL.

Each request to positions_metrics costs 1 row.
Each result in the response costs 1 row.
Using 'where' costs 5 rows.

metrics

Column Type Where Having Description
positions int − − Total number of keywords that the target URL ranks for in the top 100 organic search results across all countries in our database.
positions_top3 int − − Total number of keywords that the target URL ranks for in the top 3 organic search results across all countries in our database.
positions_top10 int − − Total number of keywords that the target URL ranks for in the top 10 organic search results across all countries in our database.
traffic float − − Estimation of the total monthly search traffic to the target URL from the top 100 organic search results.
traffic_top3 float − − Estimation of the total monthly search traffic to the target URL from the top 3 organic search results.
traffic_top10 float − − Estimation of the total monthly search traffic to the target URL from the top 10 organic search results.
cost float − − The equivalent value of the organic search traffic, should that traffic have been acquired via PPC. Traffic value is in US cents.
cost_top3 float − − The equivalent value of the top 3 organic search traffic, should that traffic have been acquired via PPC. Traffic value is in US cents.
cost_top10 float − − The equivalent value of the top 10 organic search traffic, should that traffic have been acquired via PPC. Traffic value is in US cents.
country string + − Used to get data for a particular country. Parameter should be the country code (ISO-3166 alpha-2) in lowercase (e.g. &where=country:"ca").

Examples



Request

https://apiv2.ahrefs.com?from=positions_metrics&target=ahrefs.com&mode=subdomains&limit=2&output=json

Response

{
	"metrics": {
		"positions": 166445,
		"positions_top10": 34277,
		"positions_top3": 9578,
		"traffic": 695497.706219,
		"traffic_top10": 655791.366397,
		"traffic_top3": 467322.841172,
		"cost": 152895377.353411,
		"cost_top10": 145556581.485097,
		"cost_top3": 103207073.519511
	}
}