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 } }