Ahrefs

4 production-ready jobs — top pages content replication, trending topic discovery, competitive domain positioning, and keyword-driven content at scale

Ahrefs is one of the most comprehensive SEO toolkits available — backlink indexes, keyword databases, content explorers, and site audits all accessible through a single API. These four jobs connect Ahrefs data to Mavera’s surfaces (Mave Agent, Personas, Focus Groups, Brand Voices, Generate) so your content strategy, competitive positioning, and SEO execution are driven by real search data rather than guesswork.

All examples use two environment variables: AHREFS_API_TOKEN and MAVERA_API_KEY. Ahrefs API v3 returns JSON and authenticates via Bearer token (Authorization: Bearer {token}) or OAuth 2.0. Every API call consumes at least 50 units — check your balance at Ahrefs → API Usage. Rate limit is 60 requests per minute; the API returns 429 Too Many Requests when exceeded.

API Reference Card

Detail	Value
Base URL	https://api.ahrefs.com/v3/
Auth	Bearer Token (Authorization: Bearer {token}) or OAuth 2.0
Rate limits	60 requests/minute
Minimum cost	50 units per request
Response format	JSON
Mavera base	https://app.mavera.io/api/v1
Mavera auth	Authorization: Bearer mvra_live_...

Prerequisites

1. Ahrefs API token with available units

   Log in to Ahrefs and navigate to API → API Keys to generate a token. Verify that your plan includes API access — Starter plans have limited units, while Standard and above include higher allocations.
2. Mavera API key

   Generate a key at app.mavera.io/settings/api-keys. The key starts with mvra_live_.
3. Install dependencies

   pip install requests openai
   
4. Environment variables

   export AHREFS_API_TOKEN="your_ahrefs_api_token_here"
   export MAVERA_API_KEY="mvra_live_xxxxx"
   

Jobs

#	Job	Ahrefs Data	Mavera Surface	Output
1	Top Pages by Traffic → Content Replication	site-explorer/top-pages	Mave Agent + Generate	Content briefs replicating top page patterns
2	Content Explorer → Trending Topics	content-explorer/search	Personas + Focus Groups	Validated content concepts from trending topics
3	Domain Rating Comparison → Competitive Positioning	site-explorer/metrics	Mave Agent + Brand Voices	Competitive positioning messaging by authority gap
4	Keyword Ideas → Generate at Scale	keywords-explorer/keyword-ideas	Brand Voices + Generate	SEO-optimized titles, metas, and outlines per cluster

---

Rate Limits & Production Notes

Ahrefs Endpoint	Min Units	Caching Strategy
site-explorer/top-pages	50 units	Cache 24h — page rankings shift daily at most
content-explorer/search	50 units	Cache 12h — social shares update frequently
site-explorer/metrics	50 units	Cache 48h — domain rating changes slowly
keywords-explorer/keyword-ideas	50 units	Cache per seed for 7 days

Ahrefs enforces 60 requests/minute and a minimum of 50 units per request. All jobs above include time.sleep(1) / setTimeout(1000) delays. In production, implement a centralized rate limiter across all Ahrefs calls. On 429 Too Many Requests, retry after the Retry-After header value with exponential backoff (cap at 60s).

Ahrefs returns proper JSON — no custom parsing needed. However, large result sets may be paginated via offset and limit parameters. Always check the response for a has_more field and loop if building complete datasets.

Concern	Recommendation
API token security	Store in a secrets manager. Never commit to version control. Rotate tokens quarterly.
Unit monitoring	Check balance before batch runs at Ahrefs → API Usage. A full keyword ideas + metrics audit costs 200+ units.
Response caching	Ahrefs data updates daily at most. Cache with 24-48h TTL to preserve units.
Mavera credits	Monitor at Dashboard. Batch generation jobs consume credits per call.
Pagination	For large datasets (1000+ keywords), use offset parameter in a loop. Add 1s delay between pages.
OpenAI SDK compatibility	Mavera supports the OpenAI SDK with base_url pointed to https://app.mavera.io/api/v1 and model: "mave".

What’s Next

All Integrations

50+ API integrations with full code

Ahrefs API Docs

Official Ahrefs API v3 reference

Mave Agent

Full reference for POST /api/v1/mave/chat

Focus Groups API

Full reference for POST /api/v1/focus-groups

Generate API

Full reference for POST /api/v1/generations

Brand Voices API

Full reference for POST /api/v1/brand-voices