Ahrefs API v2 will stop working on March 1st, 2024
This documentation is for the legacy version of our API (v2), which has been discontinued. All active API v2 subscriptions will stop working on March 1st, 2024. Existing Integration apps will continue to work as before until further notice, but new submissions are no longer accepted.
To switch from API v2 to 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
}
}