Changelog

Dec 3, 2025

The SA Projects endpoint has been updated with major improvements:

Support for historical crawl data.
Ability to query a specific project.
Always-on Audit (AOA) support.
Additional metrics, including counts of crawled URLs, errors, warnings, and notices.

Dec 1, 2025

Additional Brand Radar API endpoints have been released:

Nov 7, 2025

The first Brand Radar stats endpoint has been released:

Impressions overview: Returns brand impressions across AI clients with the same filters as in the UI.

Oct 9, 2025

A new RT Competitor stats endpoint has been released. It returns SoV, traffic, position counts, and other competitor metrics from Rank Tracker projects.

Oct 2, 2025

The new SA Page Explorer endpoint has been released. It provides programmatic access to Page Explorer metrics and supports historical comparisons and issue-based URL filtering.

Sep 29, 2025

The is_spam field has been added to all backlink-related API endpoints. This field matches the spam filter available in the Site Explorer UI.

Example: All backlinks endpoint

Sep 8, 2025

The first Brand Radar API endpoint has been released:

AI responses: Returns AI-generated responses with the same columns and filters as in the UI.

Jul 22, 2025

A new SA Issues endpoint has been released. It returns the list of issues for a Site Audit project and supports historical comparisons with metrics such as newly affected and fixed URLs.

Jul 3, 2025

The new SA Page content endpoint has been released. It allows retrieving raw HTML, rendered HTML, or extracted text content from Site Audit crawls, including historical snapshots for verified projects.

Jul 2, 2025

Several updates have been made to APIv3:

A new RT SERP Overview endpoint has been released to retrieve SERP data from Rank Tracker projects.
The SE Organic keywords endpoint now includes the all_positions field with all ranking URLs and positions.
The RT Overview endpoint now returns search intent data and mobile/desktop volume distribution.
The Projects endpoint now includes the number of keywords tracked in Rank Tracker.

Jun 9, 2025

New API endpoints to manage Keyword Explorer keyword lists have been released:

GET keyword-list-keywords: Lists all keywords in a keyword list.
PUT keyword-list-keyword: Add keywords to a list.
PUT keyword-list-keywords-delete: Remove keywords from a list.

May 22, 2025

A second batch of endpoints to manage Rank Tracker projects has been released. These endpoints allow modifying RT projects programmatically:

POST project: Create a new project.
PUT project-keyword: Add keywords to a project with locations and tags.
PUT project-keywords-delete: Remove keywords from a project.
POST project-competitor: Add competitors to a project.
POST project-competitors-delete: Remove competitors from a project.

May 2, 2025

The new volume_monthly_history fields has been added to the KE Overview endpoint. It returns historical monthly search volumes for requested keywords based on the period set by the volume_monthly_date_from and volume_monthly_date_to parameters.

Apr 21, 2025

The RT Competing pages endpoint has been released.

Mar 3, 2025

The 1st batch of API endpoints to manage RT projects have been released:

GET projects: Lists all projects in the workspace. Returns all projects by default but can be filtered by access type, owner, specific project ID, etc.
GET project-keywords: Lists all RT keywords for a given project.
GET project-competitors: Lists all RT competitors for a given project.
GET locations: A helper endpoint that provides a dictionary of all supported countries, locations, and languages. This will be useful for the next batch of endpoints, which will allow adding keywords to RT projects and assigning locations to them.

Dec 9, 2024

A bundle of APIv3 updates:

Total SV history in APIv3: The total-search-volume-history endpoint returns the total SV of keywords for which the target ranks in the top 10 or 100 positions.
Mobile / desktop distribution in the OK endpoint: The organic-keywords endpoint now includes two new fields: volume_mobile_pct and volume_desktop_pct, which return the percentages of search volume from mobile and desktop devices.
Search intents in the OK endpoint: Following the addition of intents to the KE endpoints, the organic-keywords endpoint now returns them as well. There’s a few new boolean fields such as is_commercial, is_informational, and others for that.

Dec 3, 2024

The SE Organic competitors endpoint has been released. Like the report itself, the endpoint returns a list of top competitors ranking in the top 10 for your keywords.

Nov 29, 2024

The competitors-overview endpoint for Rank Tracker API has been released. It provides rankings and estimated traffic that your competitors receive from the keywords you track, just like the Competitors Overview report in Rank Tracker.

Nov 28, 2024

The intents field has been added to the KE Overview endpoint and Keyword ideas endpoints.

Nov 8, 2024

Several new features have been added to the KE Overview endpoint and Keyword ideas endpoints:

Target filter: now you can filter keywords by your target's ranking position in API. There's new target, target_mode and target_position query parameters for that.
Empty keywords parameter: The endpoint now also supports passing an empty keywords parameter when above-mentioned target parameter is specified. These 2 features combined allow you to run a query to get KE metrics for all keywords your target ranks for.
Mobile / desktop distribution: The two new fields have been added, volume_desktop_pct and volume_mobile_pct, that return the percentage of searches for a keyword performed on desktop and mobile devices.
Monthly volumes: In addition to average search volume, the new volume_monthly field provides the number of searches for a keyword over the latest month.

Aug 5, 2024

The Batch Analysis endpoint has been released. It allows to pull selected metrics for a bunch of URLs and domains in bulk.
The search_engine parameter has been deprecated and removed from Keyword Explorer Overview, Volume by country, Matching terms and Search suggestions endpoints.

May 31, 2024

The offset parameter has been deprecated and removed from all API endpoints.

May 8, 2024

The Metrics history endpoint now supports the select parameter.

April 26, 2024

A new endpoint for the Rank Tracker Overview report has been added.

March 21, 2024

A new endpoint that returns outgoing link counts has been added.
Additionally, the Keywords history endpoint now supports the select parameter and includes new ranking groups: top11_20, top21_50 and top51_plus.

November 16, 2023

A new Limits and usage endpoint has been added, providing information about your subscription and API usage.

September 18, 2023

API endpoints now return USD values in cents for all output formats.

June 16, 2023

New endpoints for the Related terms and Search suggestions reports in Keywords Explorer have been added.

June 9, 2023

A new endpoint for the Matching terms report in Keywords Explorer has been added.

May 26, 2023

The ability to test Ahrefs APIv3 by running a limited set of free test queries that do not consume units has been added.

March 7, 2023

A new endpoint for SERP Overview has been added.

March 6, 2023

New endpoints for the Best by links and Broken backlinks reports have been added.

February 27, 2023

A new endpoint for the Linked domains report has been added.

November 25, 2022

Three new Keywords Explorer endpoints have been released: Keyword metrics for a single keyword or a list of keywords, Volume history for a single keyword, and Volume by country for a single keyword.

November 10, 2022

A new endpoint for the UR history chart has been added.

October 11, 2022

A new endpoint for the Keywords by top position chart has been added.

September 8, 2022

APIv3 has been released with endpoints available for the Site Explorer Overview, Backlinks, Referring domains, Organic keywords, Top pages, and Paid pages reports.