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
Available to claim
Build and ship the Ahrefs plugin to earn 50 points when we merge it to main. You have 1 hour to link an issue, then 3 hours to open a PR with the plugin scaffold.
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.
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.
Retrieves the Domain Rating (DR) for a specified domain. Domain Rating is an Ahrefs metric that measures the strength and authority of a website's backlink profile on a logarithmic scale from 0 to 100. This endpoint should be used when you need to quickly assess the overall SEO strength of a domain based on its backlink profile. It's particularly useful for competitive analysis, link building research, and evaluating potential partnership opportunities. The tool provides a single, easy-to-understand metric but does not offer detailed information about the backlinks themselves or other SEO factors. For more comprehensive backlink analysis, consider using other Ahrefs endpoints that provide more detailed backlink data.
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.
Retrieves the search volume data for specified keywords across different countries using Ahrefs' Keywords Explorer tool. This endpoint allows users to obtain accurate search volume information, helping in keyword research and content strategy planning for specific geographic regions. It's particularly useful for SEO professionals and content marketers looking to optimize their targeting for different markets. The endpoint provides monthly search volume data, which can be used to gauge the popularity and potential traffic of keywords in various countries. Note that the data is based on Ahrefs' extensive database and may not always exactly match real-time Google search volumes.
Retrieves a comprehensive overview of keyword data from Ahrefs' Keywords Explorer tool. This endpoint provides essential insights for SEO professionals and content strategists, offering a summary of key metrics such as search volume, keyword difficulty, and potential traffic. It's ideal for users looking to get a quick snapshot of keyword performance and opportunities without diving into specific keyword details. The overview likely includes aggregate data and trends, helping users to make informed decisions about their keyword strategy. While it offers a broad perspective, it may not provide in-depth analysis of individual keywords. Use this endpoint when you need a high-level view of your keyword landscape or to identify general trends in your niche.
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.
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.
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.
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.
Retrieves a comprehensive overview of competitor data in relation to keyword rankings and organic search performance. This endpoint is part of Ahrefs' Rank Tracker feature and provides a comparative analysis of your website against multiple competitors. It offers insights into keyword positions, traffic share, and SERP features across all tracked keywords. Use this endpoint when you need a high-level view of your SEO performance relative to your competitors. The data returned helps identify ranking opportunities, track your market share in organic search, and understand how you stack up against your competition in terms of visibility and traffic. Note that this endpoint may have limitations on the number of competitors it compares against and the historical data range available.
The GetRankTrackerOverview endpoint retrieves a comprehensive summary of keyword rankings and SEO performance data from Ahrefs' Rank Tracker tool. It provides a high-level overview of a website's ranking positions, SERP features, and performance against competitors across multiple search engines and countries. This endpoint is ideal for quickly assessing the overall SEO health and progress of a website without delving into specific keyword details. It should be used when you need a snapshot of your SEO performance or to track changes in your overall ranking landscape over time. Note that while this overview gives a broad picture, it may not include in-depth data for individual keywords or specific SERP features.
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.
Retrieves the historical total search volume data for specified keywords using Ahrefs' Site Explorer tool. This endpoint allows users to track and analyze the search popularity trends of specific terms over time, which is crucial for SEO strategy and content planning. It provides aggregated search volume data, helping users understand seasonal trends, overall interest changes, and compare different keywords' performance. The tool is particularly useful for identifying trending topics, planning content calendars, and making data-driven decisions in digital marketing campaigns. However, it's important to note that the data represents past trends and should be used in conjunction with other metrics for comprehensive SEO analysis.
Retrieves a comprehensive overview of Search Engine Results Pages (SERP) data for specified keywords or queries. This endpoint provides valuable insights into search performance, including historical data, search intent analysis, and detailed metrics for each keyword. It's particularly useful for SEO professionals and digital marketers looking to optimize their content strategy and improve their website's search engine visibility. The SERP Overview can help identify trends, analyze competition, and inform content creation efforts based on real search data. Note that while this endpoint offers a wealth of information, it may not provide real-time data and should be used for strategic planning rather than immediate tactical decisions.
Retrieves a list of Site Audit projects associated with the authenticated Ahrefs account. This endpoint allows users to access and manage their Site Audit projects, which are essential for identifying technical and on-page SEO issues across websites. It should be used when you need an overview of all Site Audit projects or want to check the status of ongoing audits. The endpoint likely returns project details such as project names, URLs being audited, last audit dates, and overall health scores. Keep in mind that while this endpoint provides a list of projects, it does not include the detailed audit results for each project; separate API calls would be needed to fetch specific project data.
Retrieves country-specific Site Explorer metrics for a given website from Ahrefs. This endpoint provides valuable insights into a website's performance across different countries, including data on organic traffic, keyword rankings, and backlink profiles. It's particularly useful for analyzing international SEO performance, identifying strong markets, and uncovering opportunities for global expansion. The tool returns a list of countries with their respective SEO metrics, helping users understand how their website performs in various geographical regions. Note that the specific metrics returned may vary based on the Ahrefs plan and data availability for the target website.
The site-explorer-linked-anchors-external endpoint retrieves data about external anchor texts linking to a specified target website. This tool is essential for analyzing the backlink profile of a domain, understanding the context in which other sites are linking to it, and identifying potential SEO opportunities or issues. It provides insights into the most common anchor texts used in external links, which can help in assessing the website's perceived topical relevance and authority. Use this endpoint when you need to analyze the external link profile of a website, conduct competitor research, or identify potential link-building opportunities. Note that this tool focuses solely on external links and does not provide information about internal linking structures or other on-page SEO factors.
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.
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.
The 'get_best_by_external_links' endpoint retrieves a list of pages from a specified website, ranked by the number of external links pointing to them. This tool is essential for identifying the most authoritative and popular pages on a domain from an external linking perspective. It helps in understanding which content attracts the most backlinks, aiding in content strategy and link building efforts. The endpoint is particularly useful for SEO professionals and digital marketers looking to analyze a website's most valuable pages in terms of external link equity. However, it's important to note that this tool focuses solely on external links and doesn't provide information on internal linking or other SEO metrics.
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.
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.
Retrieves data on the best-performing internal links within a specified website using Ahrefs' Site Explorer feature. This endpoint analyzes the internal link structure of the target site and returns a list of the most effective internal links based on various SEO metrics. It's particularly useful for identifying high-value linking opportunities within your own website, which can help improve your site's overall SEO performance and user navigation. The tool provides insights that can be used to optimize your internal linking strategy, potentially boosting the ranking potential of important pages on your site. Note that this endpoint focuses solely on internal links and does not provide information about external backlinks or other SEO metrics.
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.
The GetOrganicCompetitors endpoint in the Ahrefs API provides a comprehensive analysis of websites competing for organic search rankings with a specified target domain. It identifies and ranks competitors based on their keyword overlap and organic search performance relative to the target site. This tool is essential for understanding the competitive landscape in SEO, discovering potential content gaps, and informing strategic decisions for improving organic search visibility. Use this endpoint when you need to identify key competitors in organic search, analyze their strengths, and uncover opportunities for outranking them. The tool focuses solely on organic search competitors and does not provide information on paid search or other marketing channels.
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.
Retrieves comprehensive statistics about outgoing links (outlinks) from a specified website using Ahrefs' Site Explorer tool. This endpoint provides valuable insights into a website's external linking practices, which is crucial for SEO analysis and understanding a site's overall link profile. Use this tool to gather data on the number of outlinks, the diversity of linked domains, and the distribution of follow vs. nofollow links. It's particularly useful for competitive analysis, identifying potential link-building opportunities, and assessing a site's overall linking strategy. Note that this endpoint focuses solely on outgoing links and does not provide information about backlinks or internal links.
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.
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.
The keywords_explorer_related_terms endpoint retrieves a list of related terms for a given keyword using Ahrefs' extensive keyword database. This tool is essential for expanding keyword research, finding new content ideas, and identifying potential long-tail keywords for SEO strategies. It provides valuable insights into semantically related terms that users are searching for, helping to broaden and refine content targeting. The endpoint is particularly useful when brainstorming content ideas or looking to expand the scope of an existing SEO campaign. However, it should be noted that this tool focuses on keyword relationships and does not provide metrics like search volume or keyword difficulty directly in its response.
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.
The GetSiteExplorerMetrics endpoint retrieves comprehensive SEO metrics for a specified website using Ahrefs' Site Explorer tool. It provides crucial data such as backlink profile, referring pages, organic keyword rankings, and various other SEO-related metrics that are essential for understanding a website's performance and authority in search engine results. This endpoint is particularly useful for SEO professionals, digital marketers, and website owners who need to analyze their own sites or competitor websites. The tool offers flexibility in terms of analysis scope and specific metrics retrieval, allowing users to tailor the data to their specific needs. However, users should be aware that the depth and recency of data may vary depending on Ahrefs' crawling frequency and the size of the target website.
Retrieves historical SEO metrics data for a specified website over a given time period. This endpoint is part of the Ahrefs Site Explorer tool and provides valuable insights into a website's performance trends. It should be used when analyzing long-term SEO progress, identifying patterns in backlink growth, or tracking changes in organic traffic and keyword rankings. The tool is particularly useful for competitive analysis, allowing users to compare their website's historical performance against competitors. It's important to note that the data granularity may vary depending on the date range selected, with more recent dates potentially offering more detailed data.
The get_site_explorer_pages_history endpoint retrieves historical data about specific pages or domains from Ahrefs' Site Explorer. It tracks changes in SEO performance over time, including backlinks, organic traffic, and visibility. Use this endpoint for assessing historical performance, comparing metrics, and identifying trends. Ideal for SEO audits and competitor analysis. Data availability may vary based on Ahrefs' crawl 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.
Retrieves detailed information about the current subscription limits and usage for an Ahrefs account. This endpoint provides essential data to monitor API consumption, track remaining credits or rows, and manage subscription usage effectively. It should be used regularly to ensure compliance with plan limits and to plan for potential upgrades or additional purchases. The tool does not modify any account settings or usage data; it only provides a snapshot of the current status. While specific response fields are not detailed in the schema, users can expect information about total limits, current usage, and possibly remaining allowances for various Ahrefs features and API endpoints.
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.
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.
Retrieves search suggestions for a given keyword or phrase using Ahrefs' Keywords Explorer tool. This endpoint provides autocomplete-style suggestions that can help uncover related keywords, long-tail variations, and potential content ideas based on real search data. It's particularly useful for expanding keyword lists, finding low-competition keywords, and understanding user search intent. The suggestions returned may include both informational and transactional keywords, offering insights into various stages of the user journey. This tool should be used when conducting keyword research, planning content strategies, or optimizing for search engine visibility. It does not provide detailed metrics like search volume or keyword difficulty; for such data, additional API calls may be necessary.
No webhooks.
