Overview
API + MCPRequests to this endpoint are free and do not consume any API units.
Query parameters
A manual timeout duration in seconds.
The number of results to return.
A comma-separated list of columns to order results by, with optional direction. See response schema for valid column identifiers.
The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).
A comma-separated list of columns to return. See response schema for valid column identifiers.
A date to compare metrics with in YYYY-MM-DD format.
A date to report metrics on in YYYY-MM-DD format.
Choose between mobile and desktop rankings.
The unique identifier of the project. You can find it in the URL of your Rank Tracker project in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#
The search volume calculation mode: monthly or average. It affects volume, traffic, and traffic value.
The output format.
Responses
The top position (or target URL’s, if set) has a thumbnail.
The top position (or target URL’s, if set) has a thumbnail on the comparison date.
The top position (or target URL’s, if set) has a video preview.
The top position (or target URL’s, if set) has a video preview on the comparison date.
The kind of top position (or target URL’s, if set): organic, paid, or a SERP feature.
The kind of top position (or target URL’s, if set) on the comparison date.
Clicks metric refers to the average monthly number of clicks on the search results that people make while searching for the target keyword. Some searches generate clicks on multiple results, while others might not end in any clicks at all.
Clicks Per Search is the ratio of Clicks to Keyword Search volume. It shows how many different search results get clicked, on average, when people search for the target keyword in a given country.
Cost Per Click shows the average price that advertisers pay for each ad click in paid search results for a keyword.
The country that a given keyword is being tracked in. A two-letter country code (ISO 3166-1 alpha-2).
The country that a given keyword is being tracked in on the comparison date. A two-letter country code (ISO 3166-1 alpha-2).
The date when a keyword was added to the project.
User intent: branded. The user is searching for a specific brand or company name.
User intent: commercial. The user is comparing products or services before making a purchase decision.
User intent: informational. The user is looking for information or an answer to a specific question.
User intent: local. The user is looking for information relevant to a specific location or nearby services.
User intent: navigational. The user is searching for a specific website or web page.
User intent: transactional. The user is ready to complete an action, often a purchase.
The keyword your target ranks for.
An estimation of how hard it is to rank in the top 10 organic search results for a keyword on a 100-point scale.
Will return false if the keyword is still processing and no SERP has been fetched yet.
Indicates whether a keyword has exceeded the tracked keywords limit on your plan. Such keywords are "frozen", meaning they do not have their rankings updated.
The keyword your target ranks for on the comparison date.
The SERP language that a given keyword is being tracked for.
The SERP language on the comparison date.
The location (country, state/province, or city) that a given keyword is being tracked in.
The location (country, state/province, or city) that a given keyword is being tracked in on the comparison date.
Parent Topic determines if you can rank for your target keyword while targeting a more general topic on your page instead. To identify the Parent Topic, we take the #1 ranking page for your keyword and find the keyword responsible for sending the most traffic to that page.
The top position (or target URL’s, if set) in organic search.
The change in top position (or target URL’s, if set) between selected dates.
The top position (or target URL’s, if set) on the comparison date.
Search type Image shows the percentage of searches for a keyword made for images, highlighting interest in visual content.
Search type News shows the percentage of searches for a keyword made for news articles.
Search type Video shows the percentage of searches for a keyword made for video, reflecting interest in video content.
Search type Web shows the percentage of searches for a keyword made for general web content, indicating interest in a wide range of information.
The SERP features that appear in search results for a keyword.
The SERP features that appear in search results for a keyword on the comparison date.
The date when we last checked search engine results for a keyword.
The date when we checked search engine results up to the comparison date.
A list of tags assigned to a given keyword.
A list of tags assigned to a given keyword on the comparison date.
The number of target URLs ranking for a keyword.
An estimation of the number of monthly visits that a page gets from organic search over the latest month or over the latest known 12 months of data depending on the "volume_mode" parameter.
The change in traffic between your selected dates.
An estimation of the number of monthly visits that a page gets from organic search over the latest month or over the latest known 12 months of data depending on the "volume_mode" parameter.
The top-ranking URL (or target URL, if set) in organic search.
The top-ranking URL (or target URL, if set) on the comparison date.
An estimation of the average monthly number of searches for a keyword over the latest month or over the latest known 12 months of data depending on the "volume_mode" parameter.
The percentage of the total search volume that comes from desktop devices.
The percentage of the total search volume that comes from mobile devices.