Docs
Dokumentation durchsuchen...⌘K

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:

  1. Verwenden Sie select, um nur die benötigten Felder abzufragen: Bei den meisten Endpoints können Sie Felder angeben.
  2. Begrenzen Sie die Anzahl der Zeilen: Verwenden Sie limit oder entsprechende Parameter. Rufen Sie nicht unnötig Tausende von Zeilen ab.
  3. Verwenden Sie nach Möglichkeit Bulk-Endpoints: So können Sie z. B. mit batch-analysis Metriken für viele Seiten in einer einzigen Anfrage abrufen.
  4. Ermöglichen Sie Nutzern, ihre Nutzung zu überwachen: Der Endpoint limits-and-usage zeigt, wie viele Einheiten sie noch haben.