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
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.
Mavera API key
Generate a key at app.mavera.io/settings/api-keys. The key starts with
mvra_live_.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 |
| 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