Ahrefs
Ahrefs is an SEO and marketing platform offering site audits, keyword research, content analysis, and competitive insights to improve search rankings and drive organic traffic
Tools (46)
Backlinks stats retrieval
Retrieves comprehensive backlink statistics for a specified website or URL using Ahrefs' Site Explorer tool. This endpoint provides crucial data for SEO analysis, including the total number of backlinks, referring domains, and potentially the Domain Rating (DR). It's essential for understanding a site's link profile, assessing its SEO performance, and conducting competitive analysis. The tool is particularly useful when users need detailed insights into a website's backlink structure or when comparing the backlink profiles of multiple domains. Note that the data returned is based on Ahrefs' extensive web crawl and may not include very recent backlinks.
Inputs: date, mode, output, target, protocol
Batch Url Analysis
Performs a batch analysis on multiple URLs or domains using Ahrefs' powerful SEO metrics. This endpoint allows users to retrieve key SEO data for up to 100 targets simultaneously, streamlining the process of analyzing multiple websites or pages. It's particularly useful for comparing competitors, analyzing site sections, or processing large sets of URLs efficiently. The endpoint offers customization options for selecting specific metrics, filtering by country, and choosing the calculation mode for volume-based metrics. While it provides comprehensive data, users should be aware of the 100-target limit per request and ensure they have sufficient API quota for large-scale analyses.
Inputs: output, select, country, targets, order_by, volume_mode
Domain rating for site explorer
Retrieves Ahrefs Domain Rating and Ahrefs Rank for a specified domain or URL on a requested date. Domain Rating measures the strength of a website's backlink profile on a logarithmic scale from 0 to 100.
Inputs: date, output, target, protocol
Domain rating history
Retrieves the historical Domain Rating (DR) data for a specified domain over time. This endpoint is part of Ahrefs' Site Explorer tool and provides insights into how a domain's authority has changed. It's useful for tracking the impact of SEO efforts, analyzing competitors, or understanding long-term trends in domain strength. The tool returns a time series of Domain Rating values, allowing users to visualize changes in a domain's perceived authority according to Ahrefs' metrics. It should be used when analyzing the historical performance of a domain in terms of its overall SEO strength and backlink profile quality. Note that this endpoint focuses solely on Domain Rating and does not provide other metrics like backlink counts or organic traffic data.
Inputs: output, target, date_to, date_from, history_grouping
Explore keywords overview
Retrieves keyword-level overview metrics from Ahrefs' Keywords Explorer for specified keywords or an existing keyword list in a country. Available metrics include search volume, keyword difficulty and traffic potential.
Inputs: limit, where, offset, output, select, target, country, timeout, keywords, order_by, target_mode, search_engine, keyword_list_id, target_position
Explore keyword volume by country
Retrieves monthly search volume data across countries for a specified keyword using Ahrefs' Keywords Explorer. The data can help compare keyword popularity across geographic markets.
Inputs: limit, output, keyword, search_engine
Explore linked domains of a site
Retrieves a list of external domains that the specified target website or URL links to, using Ahrefs' Site Explorer functionality. This endpoint is crucial for analyzing a website's external linking structure, which can provide insights into its content strategy, partnerships, and overall SEO approach. It's particularly useful for competitive analysis, link building strategies, and identifying potential opportunities or risks in a website's outbound link profile. The endpoint returns detailed information about each linked domain, including the number of links pointing to it from the target site.
Inputs: mode, limit, where, offset, output, select, target, timeout, order_by, protocol
Explore matching terms for keywords
The keywords_explorer_matching_terms endpoint retrieves a list of keyword phrases that match or contain the specified keyword from Ahrefs' vast database. This tool is part of Ahrefs' Keyword Explorer functionality and is designed to assist in comprehensive keyword research for SEO purposes. It returns matching terms along with their relevant metrics such as search volume, keyword difficulty, and potential traffic. This endpoint is particularly useful when expanding a seed keyword list, finding long-tail variations, or discovering closely related search terms. The tool takes into account the specified country for localized results, allowing for targeted keyword strategies in different markets. It's important to note that while this tool provides valuable keyword suggestions, it should be used in conjunction with other Ahrefs features for a complete SEO strategy.
Inputs: limit, terms, where, offset, output, select, country, timeout, keywords, order_by, match_mode, search_engine, keyword_list_id
Fetch all backlinks
Retrieves a comprehensive list of backlinks for a specified website or URL using Ahrefs' Site Explorer tool. This endpoint provides detailed information about the backlink profile of the target, including the source URLs, link attributes, and potentially other SEO metrics like Domain Rating (DR) or URL Rating (UR) of the linking pages. It's particularly useful for analyzing a website's link-building efforts, identifying potential link-building opportunities, and assessing the overall health of a site's backlink profile. The endpoint can handle large-scale backlink data, making it suitable for in-depth SEO analysis and competitive research. However, users should be aware that for websites with a substantial number of backlinks, multiple API calls or pagination may be necessary to retrieve the complete dataset.
Inputs: mode, limit, where, offset, output, select, target, history, timeout, order_by, protocol, aggregation
Fetch broken backlinks data
Retrieves a list of broken backlinks for a specified website using Ahrefs' Site Explorer tool. This endpoint helps identify and analyze backlinks that are no longer functional, potentially affecting the website's SEO performance. It should be used when conducting a backlink audit, cleaning up a website's link profile, or identifying opportunities for link reclamation. The tool provides detailed information about each broken backlink, including the referring page, anchor text, and the specific broken URL. It's important to note that this endpoint may have limitations on the number of results returned and may require additional API calls for pagination if there are many broken backlinks.
Inputs: mode, limit, where, offset, output, select, target, timeout, order_by, protocol, aggregation
Fetch competitors overview
Retrieves a Rank Tracker competitor overview for a project, including comparative keyword ranking and organic search performance data. Requires a connected Ahrefs account; managed Ahrefs credentials cannot access this action.
Inputs: date, limit, where, device, offset, output, select, timeout, order_by, project_id, volume_mode, date_compared
Fetch rank tracker overview
Retrieves an Ahrefs Rank Tracker overview for a project, date and device, with ranking and search-performance metrics. Requires a connected Ahrefs account.
Inputs: date, limit, where, device, offset, output, select, timeout, order_by, project_id, volume_mode, date_compared
Fetch site explorer referring domains
Retrieves a list of domains that have backlinks pointing to a specified target website. This endpoint is essential for conducting comprehensive backlink analysis, allowing users to identify and evaluate the sources of incoming links to their website. It provides valuable data for assessing the strength and quality of a site's backlink profile, which is crucial for SEO strategies and competitor analysis. The endpoint returns detailed information about each referring domain, likely including metrics such as Domain Rating (DR), number of backlinks, and first seen date. It should be used when analyzing a website's backlink structure, identifying potential link-building opportunities, or auditing the quality of incoming links. Note that while this endpoint provides aggregate data about referring domains, it does not offer specifics about individual backlinks or anchor texts.
Inputs: mode, limit, where, offset, output, select, target, history, timeout, order_by, protocol
Fetch total search volume history
Retrieves historical total search volume for keywords associated with a target domain or URL using Ahrefs Site Explorer. The history can be grouped over time and scoped by country and top organic positions.
Inputs: mode, output, target, country, date_to, protocol, date_from, volume_mode, top_positions, history_grouping
Get content helper topics
Retrieve topics covered by top-ranking pages for a keyword. The analysis runs on demand from Ahrefs' collected SERP data and may take several seconds on the first request; repeated keyword and country requests can use cached results. When target_url is provided, Ahrefs fetches that page live.
Inputs: output, country, keyword, target_url, top_competitors
Get domain rating free
Retrieve the free Ahrefs Domain Rating for a domain or URL. Use of the returned data is subject to the license URL in the response and requires attribution as "Domain Rating by Ahrefs" with a link to https://ahrefs.com/.
Inputs: output, target
Get domain rating top domains
Retrieves domains ordered by Ahrefs Domain Rating. Use this action to inspect a ranked range of top domains. The endpoint can return up to 250,000 rows.
Inputs: to, from, output
Get serp overview
Retrieves a SERP overview for one keyword in a specified country, optionally at a historical date. Results can include ranking positions, URLs and associated page metrics.
Inputs: date, output, select, country, keyword, top_positions
Get site audit projects
Lists Site Audit projects associated with the authenticated Ahrefs account, with project and crawl status details. Requires a connected Ahrefs account.
Inputs: output
Get site explorer AI responses count
Retrieve AI response citation and page counts for a site.
Inputs: date, mode, output, select, target, country, protocol
Get site explorer country metrics
Retrieves country-specific Site Explorer metrics for a target website or URL, including organic traffic and keyword metrics. The validated response contains a country and its metrics.
Inputs: date, mode, limit, output, target, protocol, volume_mode
Get site explorer crawled pages
Retrieve crawled pages and crawl metadata for a target URL.
Inputs: mode, limit, where, output, select, target, order_by, protocol
Get site explorer linked anchors external
Retrieves anchor text data for external links going out from a target website using Ahrefs Site Explorer. Use it to analyze the anchors and external domains linked from the target.
Inputs: mode, limit, where, offset, output, select, target, timeout, order_by, protocol
Get url rating history
Retrieves the historical URL Rating data for a specified URL over time. This endpoint provides insights into how a URL's SEO strength has changed, allowing users to track the impact of their SEO efforts or analyze competitors' URL performance. The URL Rating is a key Ahrefs metric that reflects the strength of a URL based on its backlink profile and other SEO factors. Use this endpoint to visualize URL Rating trends, identify significant changes in a URL's SEO performance, and correlate these changes with specific events or strategies. The data returned is particularly useful for long-term SEO analysis and competitive research.
Inputs: output, target, date_to, date_from, history_grouping
Linked anchors explorer
Retrieves information about internal linked anchors for a specified website using the Ahrefs API. This endpoint provides data on anchor text used in internal links and the number of outgoing links associated with each anchor. It's particularly useful for analyzing a website's internal linking structure, identifying commonly used anchor texts, and optimizing internal link distribution. The endpoint is part of Ahrefs' Site Explorer tool and helps in understanding the website's hierarchy and content relationships. Each request and result incurs a cost of 1 row, which should be considered when making multiple or large-scale queries.
Inputs: mode, limit, where, offset, output, select, target, timeout, order_by, protocol
List best by external links
Retrieves pages from a specified website using Ahrefs' Site Explorer best-by-external-links report. The report includes external backlink metrics and can also include page information such as internal link counts.
Inputs: mode, limit, where, offset, output, select, target, history, timeout, order_by, protocol
Pages by traffic overview
Retrieves a list of pages from a specified website, ordered by their estimated organic search traffic. This endpoint is part of the Ahrefs Site Explorer tool and provides valuable insights into which pages on a website are performing well in terms of attracting organic search visitors. It's useful for identifying top-performing content, understanding traffic distribution across a site, and prioritizing optimization efforts. The endpoint returns data such as page URLs, estimated traffic, and other relevant metrics. It's important to note that the traffic data is an estimation based on Ahrefs' algorithms and may not exactly match actual analytics data. This tool is particularly useful for SEO professionals, content strategists, and website owners looking to analyze and improve their site's organic search performance.
Inputs: mode, output, target, country, protocol, volume_mode
Post Domain Rating Free
Retrieve Domain Rating scores for up to 1,000 target URLs. Use of the returned data is subject to the license URL in the response and requires attribution as "Domain Rating by Ahrefs" with a link to https://ahrefs.com/.
Inputs: output, targets
Retrieve anchor data
Retrieves anchor text data for a specified website or URL using Ahrefs' Site Explorer tool. This endpoint provides valuable insights into the anchor text distribution of backlinks pointing to the target URL or domain. It helps SEO professionals analyze the quality and diversity of anchor texts, which can influence search engine rankings. Use this endpoint when you need to understand how other websites are linking to a specific page or domain, and to identify potential opportunities for link building or anchor text optimization. The tool does not provide information about the linking pages themselves, focusing solely on the anchor text data.
Inputs: mode, limit, where, offset, output, select, target, history, timeout, order_by, protocol
Retrieve best by internal links
Retrieves pages ranked by internal links for a specified website using Ahrefs' Site Explorer. The report can include page details such as internal link counts, URL Rating and external link counts.
Inputs: mode, limit, where, offset, output, select, target, timeout, order_by, protocol
Retrieve crawler ip ranges
Retrieves the list of IP address ranges used by Ahrefs' web crawler (AhrefsBot). This endpoint provides essential information for website administrators to identify and potentially whitelist Ahrefs' crawler traffic. Use this endpoint when you need to configure your server's firewall rules, analyze server logs, or verify the authenticity of crawler requests claiming to be from Ahrefs. The returned data includes the current set of IP ranges, which may change over time, so it's recommended to check this endpoint periodically for updates. Note that while this information helps in identifying Ahrefs' crawler, it should not be used as the sole method of authentication for the crawler.
Inputs: output
Retrieve organic competitors
Retrieves organic search competitors for a target domain or URL, with keyword overlap and performance metrics. Results may also include paid-search metrics.
Inputs: date, mode, limit, where, offset, output, select, target, country, timeout, order_by, protocol, volume_mode, date_compared
Retrieve organic keywords
Retrieves organic keywords data for a specified website using Ahrefs' Site Explorer tool. This endpoint provides valuable insights into a website's SEO performance by returning a list of keywords for which the site ranks in organic search results. It's particularly useful for analyzing a website's organic search visibility, identifying ranking opportunities, and comparing keyword performance against competitors. The data returned includes key metrics such as keyword position, search volume, and estimated traffic, allowing users to make informed decisions about their SEO strategy. Note that the results are based on Ahrefs' database and may not reflect real-time search engine results.
Inputs: date, mode, limit, where, offset, output, select, target, country, timeout, order_by, protocol, volume_mode, date_compared
Retrieve outlinks stats
Retrieves outgoing-link statistics for a specified website or URL using Ahrefs Site Explorer. The response schema includes internal and external link counts for crawled pages.
Inputs: mode, output, target, protocol
Retrieve paid pages data
Retrieves information about paid pages (PPC advertising) for a specified website using Ahrefs' Site Explorer tool. This endpoint provides valuable insights into a website's paid search strategy, including the keywords they're targeting, ad copies, and potentially performance metrics. It's particularly useful for competitive analysis in digital marketing, allowing users to understand their competitors' paid search efforts. The tool should be used when analyzing a website's PPC strategy or researching potential keywords for paid campaigns. It does not provide information about organic search performance or other SEO metrics.
Inputs: date, mode, limit, where, offset, output, select, target, country, timeout, order_by, protocol, volume_mode, date_compared
Retrieve public crawler ips
Retrieves a list of IP addresses currently used by AhrefsBot, Ahrefs' web crawler. This endpoint provides essential information for webmasters and SEO professionals who want to verify the authenticity of requests coming from Ahrefs or manage their server's access rules. The returned list includes all active IP addresses utilized by AhrefsBot for crawling websites. This tool should be used when you need to confirm if a particular IP belongs to Ahrefs or when updating your website's firewall rules to allow Ahrefs' crawler. It's important to note that this list may change over time, so it's recommended to check it periodically for the most up-to-date information.
Inputs: output
Retrieve related terms
Retrieves related keyword ideas for a given keyword or keyword list in a specified country. Related terms may include metrics such as search volume and keyword difficulty.
Inputs: limit, terms, where, offset, output, select, country, timeout, keywords, order_by, view_for, keyword_list_id
Retrieve site explorer keywords history
Retrieves historical keyword performance data for a specified website or domain using Ahrefs' Site Explorer. This endpoint provides insights into how keywords have performed over time, including changes in rankings, search volume, and potential traffic. It's particularly useful for analyzing SEO trends, understanding the impact of optimization efforts, and identifying seasonal patterns in keyword performance. The tool should be used when you need a comprehensive view of a website's keyword history to inform SEO strategies and content planning. It does not provide real-time data and may have limitations on the historical range available.
Inputs: mode, output, select, target, country, date_to, protocol, date_from, history_grouping
Retrieve site explorer metrics
Retrieves Site Explorer SEO metrics for a target domain or URL on a specified date, including backlink, referring-page and crawled-page counts. The analysis scope can be adjusted for the target.
Inputs: date, mode, output, target, country, protocol, volume_mode
Retrieve site explorer metrics history
Retrieves historical Site Explorer traffic metrics for a target website or URL over a specified period, including estimated organic and paid traffic and cost. Results can be grouped by time interval for trend analysis.
Inputs: mode, output, select, target, country, date_to, protocol, date_from, volume_mode, history_grouping
Retrieve site explorer pages history
Retrieves historical page counts for a target domain or URL from Ahrefs Site Explorer over a specified period. Use it to analyze page-count trends over time.
Inputs: mode, output, target, country, date_to, protocol, date_from, history_grouping
Retrieve site explorer referring domains history
Retrieves the historical data of referring domains for a specified website or URL over time. This endpoint is part of Ahrefs' Site Explorer tool and provides valuable insights into the growth or decline of a website's backlink profile. It should be used when analyzing the long-term SEO performance of a website, identifying trends in link building efforts, or comparing the backlink acquisition rates of different domains. The data returned includes the number of referring domains at various points in time, allowing users to track changes and potentially correlate them with specific events or marketing efforts. This endpoint is particularly useful for SEO professionals, digital marketers, and website owners who need to monitor their site's authority growth over time or analyze competitors' link building strategies.
Inputs: mode, output, target, date_to, protocol, date_from, history_grouping
Retrieve subscription limits and usage
Retrieves an Ahrefs account's subscription limits and remaining API usage allowance. This account-scoped action requires connecting your own Ahrefs account.
Inputs: output
Retrieve top pages from site explorer
Retrieves data about the top-performing pages of a specified website using Ahrefs' Site Explorer tool. This endpoint provides valuable insights into a site's most successful content based on various SEO metrics. It's particularly useful for content analysis, competitive research, and identifying opportunities for optimization. The data returned includes details such as page URLs, organic traffic estimates, ranking keywords, and other relevant SEO metrics for each top page. Use this endpoint when you need to analyze the best-performing content of a website or compare top pages across different domains. Note that the results are based on Ahrefs' data and estimates, which may not always reflect real-time traffic or exact Google rankings.
Inputs: date, mode, limit, where, offset, output, select, target, country, timeout, order_by, protocol, volume_mode, date_compared
Retrieve volume history
Retrieves the historical search volume data for a specified keyword using Ahrefs' Keywords Explorer tool. This endpoint provides valuable insights into how the popularity of a keyword has changed over time, allowing users to analyze trends, seasonality, and long-term shifts in search behavior. The data returned can be crucial for planning SEO strategies, content calendars, and understanding market dynamics. It's particularly useful when you need to assess the historical performance of keywords, identify seasonal patterns, or evaluate the potential of trending topics. The tool does not provide future predictions or real-time data, focusing instead on historical trends based on Ahrefs' comprehensive database of search information.
Inputs: output, country, keyword
Search suggestions explorer
Retrieves search suggestions for keywords or an existing keyword list using Ahrefs Keywords Explorer. Suggestions may include associated metrics such as search volume, keyword difficulty and traffic potential for keyword research.
Inputs: limit, where, offset, output, select, country, timeout, keywords, order_by, search_engine, keyword_list_id