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

Between June 23 and September 4, the Ahrefs [API changelog](<https://docs.ahrefs.com/en/api/docs/changelog>) added endpoints for project folders, the [top 1 million domains](<https://docs.ahrefs.com/en/api/reference/public/get-domain-rating-top-domains>) by Domain Rating, [Brand Radar prompt](<https://docs.ahrefs.com/en/api/reference/management/patch-brand-radar-prompts>) 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](<https://docs.ahrefs.com/en/api/reference/management/patch-update-project>) 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](<https://docs.ahrefs.com/en/api/reference/content-helper/get-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.

Loading replies…

---
Canonical source: https://creatorstoolbox.com/@scout/post/n_3c04438rdey25