API-Leitfaden
Hier findest du eine vollständige, detaillierte Referenz für API v3: Ahrefs-API-Dokumentation. Diese Seite ist eine kurze Einführung für Ahrefs Connect-Entwickler.
Was du mit API v3 tun kannst
Mit Ahrefs API v3 kannst du eine breite Palette an Daten abrufen, darunter:
- Organische Daten und Backlink-Daten aus dem Site Explorer (für deine Website oder die der Wettbewerber)
- Keyword-Kennzahlen und -Ideen aus Keywords Explorer
- Google-SERP-Daten
- Daten aus den Rank Tracker- und Site Audit-Projekten des Nutzers
- Und mehr — wir fügen regelmäßig neue Endpunkte hinzu
API-Einheiten und Anfragekosten
Alle Anfragen — außer kostenlose Testabfragen sowie Rank Tracker-, Management-, Public- und einige weitere Endpunkte — verbrauchen API-Einheiten aus dem Konto des verbundenen Nutzers.
Kostenregeln:
- Hängt von der Anzahl der zurückgegebenen Zeilen und den angeforderten Feldern ab
- Mindestkosten für jede kostenpflichtige Anfrage: 50 Einheiten
- Wenn ein Endpunkt kostenlos ist, ist das auf seiner Dokumentationsseite entsprechend gekennzeichnet
Während der Entwicklung
Wie in So funktioniert es erläutert, befindet sich deine App nach dem Erstellen zunächst im Status Inaktiv. In diesem Modus kannst du OAuth-Abläufe testen und kostenlose Testanfragen an API v3-Endpunkte aus deiner Staging-Umgebung senden, ohne Einheiten zu verbrauchen. Sobald deine App genehmigt und aktiviert ist, verbrauchen Produktionsanfragen Einheiten gemäß den normalen Kostenregeln.
Mehr dazu: Kostenlose Testabfragen und Verbrauch von API-Limits
info
Best Practices zum Einsparen von API-Einheiten der Nutzer
Wenn du Anfragen im Namen von Nutzern stellst, behalte ihr monatliches Kontingent im Blick.
So minimierst du den Einheitenverbrauch:
- Verwenden Sie
select, um nur die benötigten Felder abzufragen: Bei den meisten Endpoints können Sie Felder angeben. - Begrenzen Sie die Anzahl der Zeilen: Verwenden Sie
limitoder entsprechende Parameter. Rufen Sie nicht unnötig Tausende von Zeilen ab. - Verwenden Sie nach Möglichkeit Bulk-Endpoints: So können Sie z. B. mit
batch-analysisMetriken für viele Seiten in einer einzigen Anfrage abrufen. - Ermöglichen Sie Nutzern, ihre Nutzung zu überwachen: Der Endpoint
limits-and-usagezeigt, wie viele Einheiten sie noch haben.