# Changelog

### Jul 14, 2026
A new [Delete projects endpoint](../reference/management/delete-projects) has been released, letting you delete projects via the `project_ids` parameter.

### Jul 13, 2026
* Claude is now available as a data source across all Brand Radar endpoints.
* The [SERP Overview endpoint](../reference/serp-overview/get-serp-overview) now supports the `type` parameter to filter results by SERP feature.

### Jul 8, 2026
* A `brand_filter` filter has been added to the Brand Radar [AI responses](../reference/brand-radar/post-ai-responses), [Cited domains](../reference/brand-radar/post-cited-domains), and [Cited pages](../reference/brand-radar/post-cited-pages) endpoints, matching brands that were found but not cited.
* The [SA Page Explorer endpoint](../reference/site-audit/get-page-explorer) now returns allowed and blocked AI search and training-bot fields.

### Jun 26, 2026
The [SMM Post metrics endpoint](../reference/social-media/get-post-metrics) now includes TikTok metrics.

### Jun 25, 2026
The `protocol` parameter has been removed from the [SE Domain Rating endpoint](../reference/site-explorer/get-domain-rating).

### Jun 23, 2026
The [Projects endpoint](../reference/management/get-projects) now returns the `folder` field, and the [Create project endpoint](../reference/management/post-projects) accepts a `folder_id` to place the project in a folder.

### Jun 22, 2026
A new [SE AI responses count endpoint](../reference/site-explorer/get-ai-responses-count) has been released. It returns the number of AI responses that mention a target.

### Jun 11, 2026
Brand Radar Citations endpoints have been released:
* [Citations overview](../reference/brand-radar/post-citations-overview)
* [Citations history](../reference/brand-radar/post-citations-history)

### Jun 8, 2026
A new free [Domain Rating endpoint](../reference/public/get-domain-rating-free) has been released. It returns the Domain Rating for a domain without the need for a subscription.

### May 29, 2026
API endpoints to manage tags on Rank Tracker project keywords have been released:
* [PUT project-keywords-tags](../reference/management/put-project-keywords-tags): Add tags to project keywords.
* [PUT project-keywords-tags-delete](../reference/management/put-project-keywords-tags-delete): Remove tags from project keywords.

### May 27, 2026
API and MCP usage limits have been increased. Visit our [pricing page](https://ahrefs.com/pricing) for the updated limits for each plan.

### May 25, 2026
Two additional data sources have been enabled across the Brand Radar report endpoints: `google_ai_mode_keywords` and `google_ai_overviews_keywords`.
They report AI Overviews / AI Mode visibility derived from Google search queries (keywords) rather than prompts.

### May 22, 2026
A new [RT Competitors Domains endpoint](../reference/rank-tracker/get-competitors-domains) has been released. It returns competitor metrics broken down by domain for a Rank Tracker project.

### May 18, 2026
* The `search_engine` parameter has been removed from the KE [Overview](../reference/keywords-explorer/get-overview), [Matching terms](../reference/keywords-explorer/get-matching-terms), [Search suggestions](../reference/keywords-explorer/get-search-suggestions), and [Volume by country](../reference/keywords-explorer/get-volume-by-country) endpoints.
* The [SA Page content endpoint](../reference/site-audit/get-page-content) now returns the `page_text_md` field with the page text in Markdown.

### May 15, 2026
Updates to the Brand Radar report endpoints:
* A `volume_range` filter has been added to [AI responses](../reference/brand-radar/post-ai-responses), [Cited domains](../reference/brand-radar/post-cited-domains), and [Cited pages](../reference/brand-radar/post-cited-pages).
* The [AI responses endpoint](../reference/brand-radar/get-ai-responses) now returns the `last_updated` field.

### May 13, 2026
Direct API access opened up for Lite+ plans!

Updates to Management endpoints:
* The [Projects endpoint](../reference/management/get-projects) now returns the `verified` field.
* The [Create report endpoint](../reference/management/post-brand-radar-reports) now supports defining brands and competitors by name and URL groups.

### May 11, 2026
Endpoints to manage Social Media posts have been released:
* [POST post](../reference/social-media/post-post): Create a post.
* [PATCH post](../reference/social-media/patch-post): Update a post.
* [DELETE post](../reference/social-media/delete-post): Delete a post.

### May 6, 2026
The Brand Radar POST endpoints now support a `tags_filter` filter (in the request body) to filter results by tag. Example: [AI responses](../reference/brand-radar/post-ai-responses).

### Apr 27, 2026
The [GSC Keywords endpoint](../reference/gsc/get-keywords) now supports filtering by keyword list through the new `keyword_lists` and `keyword_list_id` parameters, and returns the `keyword_list_labels` field.

### Apr 24, 2026
Grok is now available as a data source across all Brand Radar endpoints.

### Apr 20, 2026
The Social Media API has been released, providing programmatic access to the same reports available in Social Media Manager's UI:
* [Channels](../reference/social-media/get-channels) and [Channel metrics](../reference/social-media/get-channel-metrics)
* [Posts](../reference/social-media/get-posts) and [Post metrics](../reference/social-media/get-post-metrics)
* [Authors](../reference/social-media/get-authors)
* [Activity history](../reference/social-media/get-activity-history)

### Apr 17, 2026
Brand Radar API endpoints now support brand variations and brand websites, through POST versions of the existing GET endpoints.

### Apr 13, 2026
A new [SE Crawled pages endpoint](../reference/site-explorer/get-crawled-pages) has been released. It returns the pages Ahrefs has crawled for a target.

### Apr 10, 2026
The [BR Cited pages endpoint](../reference/brand-radar/get-cited-pages) now supports the `tracked_urls` parameter to filter results by tracked URLs.

### Mar 31, 2026
API endpoints to manage Brand Radar reports have been released:
* [GET brand-radar-reports](../reference/management/get-brand-radar-reports): List saved reports.
* [POST brand-radar-reports](../reference/management/post-brand-radar-reports): Create a report.
* [PATCH brand-radar-reports](../reference/management/patch-brand-radar-reports): Update a report.

### Mar 30, 2026
The [GSC Pages endpoint](../reference/gsc/get-pages) now includes the `traffic_value` field.

### Mar 19, 2026
The GSC Insights API has been released, providing programmatic access to Google Search Console data:
* [Keywords](../reference/gsc/get-keywords) and [Keyword history](../reference/gsc/get-keyword-history)
* [Pages](../reference/gsc/get-pages), [Page history](../reference/gsc/get-page-history), and [Pages history](../reference/gsc/get-pages-history)
* [Positions history](../reference/gsc/get-positions-history) and [Performance history](../reference/gsc/get-performance-history)
* [Performance by device](../reference/gsc/get-performance-by-device) and [Performance by position](../reference/gsc/get-performance-by-position)
* [Metrics by country](../reference/gsc/get-metrics-by-country)
* [CTR by position](../reference/gsc/get-ctr-by-position)
* [Anonymous queries](../reference/gsc/get-anonymous-queries)

### Mar 17, 2026
Two reporting endpoints have been extended:
* The [SE Pages history endpoint](../reference/site-explorer/get-pages-history) now supports the `page_positions` parameter to filter pages by ranking position (e.g. `top10`).
* The [SA Page Explorer endpoint](../reference/site-audit/get-page-explorer) now returns the `size_uncompressed` field, with comparison values.

### Mar 12, 2026
The `tags` field has been added to the [BR AI responses endpoint](../reference/brand-radar/get-ai-responses).

### Mar 11, 2026
API endpoints to manage Brand Radar custom prompts have been released:
* [GET brand-radar-prompts](../reference/management/get-brand-radar-prompts): List custom prompts.
* [POST brand-radar-prompts](../reference/management/post-brand-radar-prompts): Add custom prompts.
* [PUT brand-radar-prompts-delete](../reference/management/put-brand-radar-prompts-delete): Remove custom prompts.

### Mar 9, 2026
The `search_queries` field has been added to the [BR AI responses endpoint](../reference/brand-radar/get-ai-responses), matching the search query used by the chatbot to find information for the response.

### Feb 27, 2026
Two SE endpoints have been renamed for clarity (the previous paths continue to work):
* `best-by-external-links` is now [SE Pages by backlinks](../reference/site-explorer/get-pages-by-backlinks).
* `best-by-internal-links` is now [SE Pages by internal links](../reference/site-explorer/get-pages-by-internal-links).

### Feb 25, 2026
The [SA Projects endpoint](../reference/site-audit/get-projects) now supports filtering projects by name and URL through the new `project_name` and `project_url` parameters.

### Feb 4, 2026
The Web Analytics API has been released, providing programmatic access to the same reports available in the Web Analytics UI:
* [Stats](../reference/web-analytics/get-stats)
* [Top pages](../reference/web-analytics/get-top-pages)
* [Entry pages](../reference/web-analytics/get-entry-pages) and [Exit pages](../reference/web-analytics/get-exit-pages)
* [Countries](../reference/web-analytics/get-countries), [Continents](../reference/web-analytics/get-continents), and [Cities](../reference/web-analytics/get-cities)
* [Sources](../reference/web-analytics/get-sources), [Source channels](../reference/web-analytics/get-source-channels), and [Referrers](../reference/web-analytics/get-referrers)
* [Devices](../reference/web-analytics/get-devices), [Browsers](../reference/web-analytics/get-browsers), and [Operating systems](../reference/web-analytics/get-operating-systems)
* [Languages](../reference/web-analytics/get-languages) and [UTM parameters](../reference/web-analytics/get-utm-params)

Each report also has a time-series `-chart` variant, alongside an overall [visitors chart](../reference/web-analytics/get-chart).

### Jan 2, 2026
Additional Brand Radar API endpoints have been released:
* [Cited domains](../reference/brand-radar/get-cited-domains): Returns the domains cited in AI responses with mention, page, response, and volume counts.
* [Cited pages](../reference/brand-radar/get-cited-pages): Returns the pages cited in AI responses with the same metrics.

### Dec 19, 2025
The [SE Organic keywords endpoint](../reference/site-explorer/get-organic-keywords) now includes the `keyword_language` field, which can also be used as a filter.

### Dec 17, 2025
A new [BR Share of Voice history endpoint](../reference/brand-radar/get-sov-history) has been released. It returns share-of-voice metrics over time across AI clients.

### Dec 3, 2025
The [SA Projects endpoint](../reference/site-audit/get-projects) 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:
* [Mentions distribution](../reference/brand-radar/get-mentions-overview)
* [Impressions history](../reference/brand-radar/get-impressions-history)
* [Mentions history](../reference/brand-radar/get-mentions-history)

### Nov 7, 2025
The first Brand Radar stats endpoint has been released:
* [Impressions overview](../reference/brand-radar/get-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](../reference/rank-tracker/get-competitors-stats) 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](../reference/site-audit/get-page-explorer) 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](../reference/site-explorer/get-all-backlinks)

### Sep 8, 2025
The first Brand Radar API endpoint has been released:
* [AI responses](../reference/brand-radar/get-ai-responses): Returns AI-generated responses with the same columns and filters as in the UI.

### Jul 22, 2025
A new [SA Issues endpoint](../reference/site-audit/get-issues) 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](../reference/site-audit/get-page-content) 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](../reference/rank-tracker/get-serp-overview) has been released to retrieve SERP data from Rank Tracker projects.
* The [SE Organic keywords endpoint](../reference/site-explorer/get-organic-keywords) now includes the `all_positions` field with all ranking URLs and positions.
* The [RT Overview endpoint](../reference/rank-tracker/get-overview) now returns search intent data and mobile/desktop volume distribution.
* The [Projects endpoint](../reference/management/get-projects) 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](../reference/management/get-keyword-list-keywords): Lists all keywords in a keyword list.
* [PUT keyword-list-keyword](../reference/management/put-keyword-list-keywords): Add keywords to a list.
* [PUT keyword-list-keywords-delete](../reference/management/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](../reference/management/post-projects): Create a new project.
* [PUT project-keyword](../reference/management/put-project-keywords): Add keywords to a project with locations and tags.
* [PUT project-keywords-delete](../reference/management/put-project-keywords-delete): Remove keywords from a project.
* [POST project-competitor](../reference/management/post-project-competitors): Add competitors to a project.
* [POST project-competitors-delete](../reference/management/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](../reference/keywords-explorer/get-overview). 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](../reference/rank-tracker/get-competitors-pages) has been released.

### Mar 3, 2025
The 1st batch of API endpoints to manage RT projects have been released:
* [GET projects](../reference/management/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](../reference/management/get-project-keywords): Lists all RT keywords for a given project.
* [GET project-competitors](../reference/management/get-project-competitors): Lists all RT competitors for a given project.
* [GET locations](../reference/management/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](../reference/site-explorer/get-total-search-volume-history) 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](../reference/site-explorer/get-organic-keywords) 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](../reference/site-explorer/get-organic-keywords) 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](../reference/site-explorer/get-organic-competitors) 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](../reference/rank-tracker/get-competitors-overview) 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](../reference/keywords-explorer/get-overview) and Keyword ideas endpoints.

### Nov 8, 2024
Several new features have been added to the [KE Overview endpoint](../reference/keywords-explorer/get-overview) 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](../reference/batch-analysis/post-batch-analysis) 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](../reference/keywords-explorer/get-overview), [Volume by country](../reference/keywords-explorer/get-volume-by-country), [Matching terms](../reference/keywords-explorer/get-matching-terms) and [Search suggestions](../reference/keywords-explorer/get-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](../reference/site-explorer/get-metrics-history) now supports the `select` parameter.

### April 26, 2024
A new [endpoint for the Rank Tracker Overview report](../reference/rank-tracker/get-overview) has been added.

### March 21, 2024
* A new [endpoint that returns outgoing link counts](../reference/site-explorer/get-outlinks-stats) has been added.
* Additionally, the [Keywords history endpoint](../reference/site-explorer/get-keywords-history) now supports the `select` parameter and includes new ranking groups: `top11_20`, `top21_50` and `top51_plus`.

### March 11, 2024
A new [endpoint that returns a list of workspace projects with Site Audit Health Scores](../reference/site-audit/get-projects) has been added.

### January 30, 2024
A new [endpoint for the Outgoing anchors report](../reference/site-explorer/get-linked-anchors-external) has been added.

### January 17, 2024
A new [endpoint for the Anchors report](../reference/site-explorer/get-anchors) has been added.

### December 5, 2023
A new [endpoint that returns the IP ranges used by AhrefsBot](../reference/public/get-crawler-ip-ranges) has been added.

### November 23, 2023
A new [endpoint for the DR history chart](../reference/site-explorer/get-domain-rating-history) has been added.

### November 16, 2023
A new [Limits and usage](../reference/subscription-info/get-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](../reference/keywords-explorer/get-related-terms) and [Search suggestions](../reference/keywords-explorer/get-search-suggestions) reports in Keywords Explorer have been added.

### June 9, 2023
A new [endpoint for the Matching terms report](../reference/keywords-explorer/get-matching-terms) in Keywords Explorer has been added.

### May 26, 2023
The ability to test Ahrefs APIv3 by running a [limited set of free test queries](./free-test-queries.md) that do not consume units has been added.

### March 7, 2023
A new [endpoint for SERP Overview](../reference/serp-overview/get-serp-overview) has been added.

### March 6, 2023
New endpoints for the [Best by links](../reference/site-explorer/get-pages-by-backlinks) and [Broken backlinks](../reference/site-explorer/get-broken-backlinks) reports have been added.

### February 27, 2023
A new [endpoint for the Linked domains report](../reference/site-explorer/get-linkeddomains) has been added.

### November 25, 2022
Three new Keywords Explorer endpoints have been released: [Keyword metrics](../reference/keywords-explorer/get-overview) for a single keyword or a list of keywords, [Volume history](../reference/keywords-explorer/get-volume-history) for a single keyword, and [Volume by country](../reference/keywords-explorer/get-volume-by-country) for a single keyword.

### November 10, 2022
A new [endpoint for the UR history chart](../reference/site-explorer/get-url-rating-history) has been added.

### October 11, 2022
A new [endpoint for the Keywords by top position chart](../reference/site-explorer/get-keywords-history) has been added.

### September 8, 2022
APIv3 has been released with endpoints available for the Site Explorer [Overview](../reference/site-explorer/get-domain-rating), [Backlinks](../reference/site-explorer/get-all-backlinks), [Referring domains](../reference/site-explorer/get-refdomains), [Organic keywords](../reference/site-explorer/get-organic-keywords), [Top pages](../reference/site-explorer/get-top-pages), and [Paid pages](../reference/site-explorer/get-paid-pages) reports.