Ahrefs API adds project folders, top domains, and topic scores

Between June 23 and September 4, the Ahrefs API changelog added endpoints for project folders, the top 1 million domains by Domain Rating, Brand Radar prompt countries and tags, and Content Helper topic scores.

Listing projects includes each project's innermost folder. Creating a project can place it in a folder using the folder id from the dashboard URL. A PATCH request can move a project into a folder, which may make it visible to members of that folder, or remove it from the folder tree. These project requests don't use API units.

A public endpoint returns the top 1 million domains ranked by Domain Rating, with each domain's current rating and rank. The from and to parameters pick a range of ranks. One request can return up to 250,000 rows, and it defaults to the first 100. It needs an API v3 key, including a key from a free account, and it doesn't use API units. The same list is available through the Ahrefs MCP.

A free PATCH request updates custom prompts on a Brand Radar report. You can add a country so a prompt is tracked there, or remove a country to stop. A prompt left with no country is deleted. Tags can be added, removed, or replaced with an exact list. Adding a tag the report does not have yet creates it. Removing a tag from the prompts keeps that tag on the report. Replacing them with an empty list clears the tags.

Content Helper Topics reads pages that already rank for a keyword in one country. It names the topics they cover and scores each from 0 to 100. Pass a target URL to score that page on the same topics. A request costs 1,000 API units, plus 500 when you include a URL. The first request for a keyword takes a few seconds. Later requests for that keyword are cached and free, but the target page is fetched live and its score is not cached. It uses a SERP Ahrefs has already collected and doesn't collect a new one. It reads the top 10 ranking pages unless you set a smaller number.