Ahrefs verbinden: API v3-Schlüssel, Datentypen und Einheiten-Limit
Verbinden Sie Ihren eigenen Ahrefs API v3-Schlüssel als Datenquelle; erfahren Sie, welche Datentypen er bereitstellt, wie viele API-Einheiten jede Aktion verbraucht und wie Sie ein monatliches Einheiten-Limit festlegen.
Diese Ansicht im Panel öffnenWenn Sie ein Ahrefs-Abonnement haben, kann SEOAsist dessen Daten als Datenquelle nutzen. SEOAsist verfolgt Rankings, findet Content-Gaps, wendet Korrekturen an und berichtet die Ergebnisse mit diesen Daten. Die Verbindung ist optional und läuft über Ihren eigenen API v3-Schlüssel: Jeder Aufruf verbraucht API-Einheiten aus Ihrem Ahrefs-Konto.
Das Verbinden allein ändert noch nichts. In der Tabelle Datenquellen auf dem Tab Daten unter Einstellungen → Integrationen wählen Sie aus, welche Datentypen Ahrefs beantwortet. Eine kostenpflichtige Quelle wird niemals verwendet, es sei denn, Sie wählen sie aus.
Welche Datentypen stellt es bereit?
| Datentyp | Ahrefs API v3-Endpunkt | Qualität |
|---|---|---|
| Rank-Tracking | Site Explorer → organic-keywords (beste Position und URL) | Ungefähr: Positionen aus der Ahrefs-Datenbank, kein Live-SERP-Check |
| Volumen / CPC / KD | Keywords Explorer → overview | Vollständig |
| Keyword-Ideen | Keywords Explorer → related-terms, matching-terms für Long-Tail | Vollständig |
| Mitbewerber und Content-Gap | Site Explorer → organic-competitors, die organic-keywords-Liste beider Domains | Vollständig |
| Backlinks | Site Explorer → backlinks-stats, domain-rating, all-backlinks (ein Link pro Domain, einschließlich in den letzten 90 Tagen verlorener Links), refdomains | Vollständig (Spam-Flag von Ahrefs wird als toxisch angezeigt) |
Das lokale Map-Grid funktioniert nicht mit Ahrefs; hierfür wird DataForSEO benötigt. Das Domain Rating (0–100) erscheint in der Spalte Rang der Backlink-Ansichten.
Voraussetzungen
- Ein Ahrefs-Konto mit API v3-Zugriff (Enterprise-Tarif oder das API-Add-on).
- Die Rolle Admin in SEOAsist.
API-Schlüssel abrufen
- Melden Sie sich bei app.ahrefs.com an.
- Öffnen Sie Kontoeinstellungen → API-Schlüssel (nur Workspace-Eigentümer und Admins können Schlüssel erstellen).
- Erstellen Sie einen Schlüssel und kopieren Sie ihn.
Verbindung mit SEOAsist herstellen
- Öffnen Sie die Karte Ahrefs auf dem Tab Daten unter Einstellungen → Integrationen.
- Fügen Sie den Schlüssel ein und klicken Sie auf Verbinden.
- Vor dem Speichern ruft SEOAsist den kostenlosen
limits-and-usage-Endpunkt von Ahrefs auf. Bei Erfolg sehen Sie „Ahrefs verbunden. Verbleibende Einheiten: …“. - Wählen Sie in der Tabelle Datenquellen auf demselben Tab Ahrefs (Ihr Konto) für die gewünschten Datentypen aus.
Der Schlüssel wird verschlüsselt gespeichert und niemals im Klartext an den Browser gesendet. Verbindung testen zeigt die verbleibenden Einheiten an und verbraucht keine.
Wie viele Einheiten verbraucht jede Aktion?
Ahrefs berechnet mindestens 50 Einheiten pro kostenpflichtiger Anfrage; die Kosten pro Zeile sind die Summe der ausgewählten Felder (die meisten Felder 1 Einheit, Volumen / KD / Intent / Traffic 10 Einheiten). Die folgenden Werte sind obere Schätzwerte.
| Aktion | Endpunkt | Maximal |
|---|---|---|
| Keyword-Recherche (Ideen / Long-Tail) | related-terms / matching-terms, 32 pro Zeile | 100 Zeilen → 3.200 |
| Volumen / CPC / KD auffüllen | overview, 32 pro Keyword | 300 Keywords → 9.600 |
| Rank-Check | organic-keywords, 3 pro Zeile | 1 Abruf pro Tag, 1.000 Zeilen → 3.000 |
| Mitbewerber finden | organic-competitors, 13 pro Zeile | 15 Zeilen → 195 |
| Mitbewerber-Sync | organic-keywords, 27 pro Zeile | 500 pro Mitbewerber + 1.000 eigene |
| Backlink-Sync | backlinks-stats 50 + domain-rating 50 + all-backlinks 10 pro Zeile | 500 Links → 5.100 |
| Backlink-Chancen | refdomains, 5 pro Zeile | 300 Zeilen pro Mitbewerber, bis zu 5 Mitbewerber |
Der Mitbewerber-Sync ist die teuerste Aktion mit Ahrefs. Testen Sie ihn zuerst mit einem Mitbewerber und legen Sie ein monatliches Limit fest.
Monatliches Einheiten-Limit
Geben Sie eine Zahl unter Monatliches Einheiten-Limit auf der Ahrefs-Karte ein und klicken Sie auf Speichern. Vor jedem Aufruf addiert SEOAsist die geschätzte Nutzung dieses Monats und die geschätzten Kosten des Aufrufs; würde das Limit überschritten, wird der Aufruf nicht gesendet und Sie erhalten eine Benachrichtigung. Lassen Sie das Feld leer für kein Limit. Die genaue Nutzung finden Sie unter app.ahrefs.com → API-Schlüssel.
Fehler
| Nachricht | Bedeutung | Was zu tun ist |
|---|---|---|
| API-Schlüssel wurde abgelehnt | HTTP 401: Falscher, abgelaufener oder gelöschter Schlüssel | Erstellen Sie einen neuen Schlüssel und verbinden Sie ihn erneut |
| API-Einheiten sind aufgebraucht | Das Einheiten-Limit wurde erreicht | Fügen Sie Einheiten in Ahrefs hinzu oder warten Sie auf das Zurücksetzungsdatum |
| Kein API-Zugriff | HTTP 403: Der Tarif deckt diesen Endpunkt nicht ab | Überprüfen Sie Ihren Ahrefs-Tarif |
| Ratenlimit überschritten | HTTP 429 (Standardmäßig 60 Anfragen pro Minute) | SEOAsist wartet und versucht es erneut |
| Monatliches Einheiten-Limit erreicht | Das von Ihnen festgelegte Limit | Erhöhen Sie das Limit oder warten Sie auf den neuen Monat |
Bei einem Schlüssel-, Einheiten- oder Zugriffsfehler zeigen die betreffenden Seiten ein Banner „Ahrefs funktioniert nicht“ an und der Eigentümer wird einmal täglich benachrichtigt. Eine ausgewählte Quelle, die fehlschlägt, wird niemals stillschweigend durch eine kostenlose ersetzt.
FAQ
Warum sind Rankings „Ungefähr“?
Positionen stammen aus der Ahrefs-Datenbank; Ahrefs aktualisiert diese nach eigenem Zeitplan und nur für Keywords, die es kennt. Für einen täglichen Live-SERP-Check wählen Sie DataForSEO für Rankings.
Wie entferne ich die Verbindung?
Öffnen Sie die Karte, klicken Sie auf Entfernen und bestätigen Sie. Datentypen, die auf Ahrefs eingestellt sind, wechseln zur kostenlosen Ebene; wählen Sie eine andere Quelle in der Tabelle Datenquellen, wenn Sie eine möchten. Die Ahrefs-Datenreihe bleibt erhalten, wird aber nicht fortgeführt.
Berechnet SEOAsist Gebühren für Ahrefs?
Nein. Einheiten werden direkt von Ihrem Ahrefs-Konto abgezogen. Siehe Kosten.
Verwandte Artikel
- Datenquellen: die kostenlose Stufe, Bing Webmaster, Platform-Daten und DataForSEOWoher Rankings, Suchvolumen, Keyword-Ideen, Themen von Mitbewerbern und Backlinks stammen, was die kostenlosen Quellen und die im Tarif enthaltenen Plattform-Daten leisten können und was nicht, wie Sie einen Bing Webmaster-Schlüssel hinzufügen und wie Sie die Quelle pro Datentyp auswählen.
- Semrush verbinden: API-Schlüssel, Datentypen und monatliches Einheiten-LimitVerbinden Sie Ihren eigenen Semrush-API-Schlüssel als Datenquelle; erfahren Sie, welche Datentypen er bereitstellt, wie viele API-Einheiten jede Aktion verbraucht und wie Sie ein monatliches Einheiten-Limit festlegen.
- DataForSEO: Plattformdaten, eigener Account, Kosten und GuthabenNützen Sie DataForSEO-Daten über die im SEOAsist-Tarif enthaltenen Plattformdaten oder Ihren eigenen Account; erfahren Sie, welche Module dadurch versorgt werden, wie das Plattformkontingent funktioniert, wie viele Aufrufe jede Aktion verbraucht und wo Sie Ihr Guthaben im Blick behalten.
- Kosten: KI-Guthaben, eigene Schlüssel und DataForSEOHäufige Fragen dazu, was in Ihrem Paket enthalten ist, was Sie über Ihre eigenen Konten bezahlen und wie monatliche Kontingente gezählt werden.
- Backlinks: Tabs, Jetzt synchronisieren und die wöchentliche SynchronisierungErfahren Sie, was jeder Tab auf der Backlinks-Seite anzeigt, was "Jetzt synchronisieren" im Hintergrund tut und welche Benachrichtigung Sie erhalten, wenn eine Synchronisierung fehlschlägt.