Changelog

Sep 15, 2026

The unknown value has been removed from the source_channel enum on Web Analytics API endpoints. Requests that still filter on unknown are treated as referral.

Sep 4, 2026

A new Content Helper Topics endpoint has been released. It identifies the topics covered by top-ranking pages for a keyword and can score a target URL against them.

The default value of traffic_mode on Site Explorer API endpoints has changed from static to adaptive. Pass traffic_mode=static explicitly to continue using the previous organic traffic calculation model.

Sep 2, 2026

The search_volume_type=keyword_volume option remains available on Brand Radar API endpoints until Sep 30, 2026. After that date, all requests will use AI-adjusted volume.

Aug 31, 2026

The Brand Radar prompts endpoint now returns each prompt's tags field. A new Update Brand Radar prompts endpoint lets you update the countries and tags assigned to prompts.

Aug 27, 2026

The SA Project Issues endpoint now returns AI Discoverability as an issue category.

Aug 26, 2026

The SE AI responses count endpoint now supports all_platforms in select and returns its combined citations and pages counts.

The substring and isubstring filter operators are no longer supported for the search_queries field in Brand Radar API endpoints. Use phrase_match or iphrase_match instead.

Aug 24, 2026

The SE Crawled pages endpoint now returns languages, page_category, page_type, and publish_date fields. These fields can also be selected, filtered, and used to order results.

Aug 20, 2026

The Batch Analysis endpoint now supports the top_countries parameter to return up to 10 countries in the org_traffic_top_by_country field.

Aug 19, 2026

The substring and isubstring filter operators are no longer supported for the topic field in Brand Radar API endpoints. Use phrase_match or iphrase_match instead.

Aug 10, 2026

The free Domain Rating endpoint now requires an API key. Requests to it remain free and do not consume API units. The warning field about unauthenticated access has been removed from the response.

Aug 7, 2026

The SMM Post metrics endpoint now returns the youtube_metrics field with the comment count for YouTube posts.

Aug 4, 2026

A traffic_mode parameter has been added to the SE Metrics, Metrics by country, Metrics history, Organic competitors, Organic keywords, Pages by traffic, and Top pages endpoints. It selects the organic traffic calculation mode, static (default) or adaptive, and affects organic traffic and traffic value.

Jul 31, 2026

A new Top domains by Domain Rating endpoint has been released. It returns the top 1M domains ranked by Domain Rating, with from and to to request a range of rank positions.

Jul 30, 2026

The SE Top pages endpoint now returns AI citation counts per AI platform: ai_responses_chatgpt, ai_responses_copilot, ai_responses_gemini, ai_responses_google_ai_mode, ai_responses_google_ai_overviews, ai_responses_grok, and ai_responses_perplexity.

Jul 29, 2026

CSV is no longer an accepted output value on the SE Organic keywords endpoint. The supported values are json, php, and xml.

Jul 27, 2026

The target_mode parameter of the KE Overview endpoint has been renamed to mode.

Jul 24, 2026

The Update project endpoint now accepts a folder operation, letting you move a project to a folder with folder_id or remove it from its folder tree.

Jul 14, 2026

A new Delete projects endpoint 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 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, Cited domains, and Cited pages endpoints, matching brands that were found but not cited.
• The SA Page Explorer endpoint now returns allowed and blocked AI search and training-bot fields.

Jun 26, 2026

The SMM Post metrics endpoint now includes TikTok metrics.

Jun 25, 2026

The protocol parameter has been removed from the SE Domain Rating endpoint.

Jun 23, 2026

The Projects endpoint now returns the folder field, and the Create project endpoint accepts a folder_id to place the project in a folder.

Jun 22, 2026

A new SE AI responses count endpoint 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
• Citations history

Jun 8, 2026

A new free Domain Rating endpoint 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: Add tags to project keywords.
• 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 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 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, Matching terms, Search suggestions, and Volume by country endpoints.
• The SA Page content endpoint 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, Cited domains, and Cited pages.
• The AI responses endpoint now returns the last_updated field.

May 13, 2026

Direct API access opened up for Lite+ plans!

Updates to Management endpoints:

• The Projects endpoint now returns the verified field.
• The Create report endpoint 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: Create a post.
• PATCH post: Update a post.
• 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.

Apr 27, 2026

The GSC Keywords endpoint 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 and Channel metrics
• Posts and Post metrics
• Authors
• 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 has been released. It returns the pages Ahrefs has crawled for a target.

Apr 10, 2026

The BR Cited pages endpoint 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: List saved reports.
• POST brand-radar-reports: Create a report.
• PATCH brand-radar-reports: Update a report.

Mar 30, 2026

The GSC Pages endpoint 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 and Keyword history
• Pages, Page history, and Pages history
• Positions history and Performance history
• Performance by device and Performance by position
• Metrics by country
• CTR by position
• Anonymous queries

Mar 17, 2026

Two reporting endpoints have been extended:

• The SE Pages history endpoint now supports the page_positions parameter to filter pages by ranking position (e.g. top10).
• The SA Page Explorer endpoint now returns the size_uncompressed field, with comparison values.

Mar 12, 2026

The tags field has been added to the BR AI responses endpoint.

Mar 11, 2026

API endpoints to manage Brand Radar custom prompts have been released:

• GET brand-radar-prompts: List custom prompts.
• POST brand-radar-prompts: Add custom prompts.
• PUT brand-radar-prompts-delete: Remove custom prompts.

Mar 9, 2026

The search_queries field has been added to the BR AI responses endpoint, 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.
• best-by-internal-links is now SE Pages by internal links.

Feb 25, 2026

The SA Projects endpoint 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
• Top pages
• Entry pages and Exit pages
• Countries, Continents, and Cities
• Sources, Source channels, and Referrers
• Devices, Browsers, and Operating systems
• Languages and UTM parameters

Each report also has a time-series -chart variant, alongside an overall visitors chart.

Jan 2, 2026

Additional Brand Radar API endpoints have been released:

• Cited domains: Returns the domains cited in AI responses with mention, page, response, and volume counts.
• Cited pages: Returns the pages cited in AI responses with the same metrics.

Dec 19, 2025

The SE Organic keywords endpoint 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 has been released. It returns share-of-voice metrics over time across AI clients.

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:

• Mentions distribution
• Impressions history
• Mentions history

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.

March 11, 2024

A new endpoint that returns a list of workspace projects with Site Audit Health Scores has been added.

January 30, 2024

A new endpoint for the Outgoing anchors report has been added.

January 17, 2024

A new endpoint for the Anchors report has been added.

December 5, 2023

A new endpoint that returns the IP ranges used by AhrefsBot has been added.

November 23, 2023

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

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.