Ahrefs API v3 — Bruno Collection

A complete Bruno collection covering all 139 endpoints of the Ahrefs API v3, organized into the same 13 groups as the official docs.

Import

1. Open Bruno → Open Collection → select the Ahrefs API v3 folder.
2. Select an environment (top-right): Production or Free Test Queries.
3. Edit the environment and set AHREFS_API_KEY to your key (app.ahrefs.com → Account settings → API keys).

Authentication

Bearer token, defined once at the collection level (collection.bru). Every request uses auth: inherit, so you only set the key in one place. The key is stored as a secret environment variable.

Structure

#	Group	Endpoints
01	Site Explorer	27
02	Keywords Explorer	6
03	Site Audit	4
04	Rank Tracker	5
05	SERP Overview	1
06	Batch Analysis	1
07	Subscription Information	1
08	Management	19
09	Brand Radar	18
10	Web Analytics	34
11	GSC Insights	12
12	Social Media	9
13	Public	2
	Total	139

Conventions

• Query params: disabled/optional params are prefixed with ~ in Bruno (toggle them on in the UI). Required params (select, target, etc.) are enabled with sample values.
• Variables: path/ID values like project_id, list_id, channel_id, post_id, prompt_id, report_id are environment variables — fill them in before running the relevant requests.
• Bodies: POST/PUT/PATCH requests include a ready-to-edit JSON body.
• Docs block: each request has an inline docs {} block with the method, full URL, link to the official reference page, and parameter notes.

Notes from the API docs

• All parameter values must be URL-encoded.
• Most data endpoints require the select parameter (comma-separated columns).
• where takes a JSON filter expression, e.g. {"and":[{"field":"domain_rating","is":["gt",90]}]}.
• order_by example: field_a:desc,field_b:asc.
• output: json | csv | xml | php.
• Endpoints consume API units (minimum 50 each) except Rank Tracker, Management, Public, and free-test endpoints. Use Free Test Queries while developing — consumed units are non-refundable.
• Default rate limit: 60 requests/minute (HTTP 429 when exceeded).

Reference: https://docs.ahrefs.com/en/api/docs/introduction