Docs
Dokumentation durchsuchen...⌘K

Einführung

Mit der Ahrefs API kannst du Daten aus deinem Ahrefs-Workspace nutzen, um benutzerdefinierte Integrationen und Automatisierungen zu erstellen. Derzeit ermöglicht Ihnen API v3, Daten aus den Endpoints von Site Explorer, Keywords Explorer, SERP-Übersicht, Rank Tracker, Site Audit, Brand Radar und Social Media Management abzurufen sowie Ihre Rank-Tracker-Projekte und Keywords-Explorer-Listen zu verwalten:

  • Site Explorer: Übersichtsstatistiken und historische Diagramme, Backlinks, Reports zu organischem und bezahltem Traffic
  • Keywords Explorer: Kennzahlen für ein einzelnes Keyword oder eine Keyword-Liste, Suchvolumen-Verlauf und Suchvolumen nach Ländern, Reports mit Keyword-Ideen
  • Site Audit: Gesundheitswerte der Projekte, vollständige Problem-Reports und Inhalte gecrawlter Seiten
  • SERP Overview: Die Top-100-SERP-Ergebnisse
  • Rank Tracker: Projektübersicht, Wettbewerber-Reports und Rank-Tracker-SERPs
  • Batch Analysis: Kennzahlen für bis zu 100 Ziele pro Anfrage
  • Brand Radar: Übersichtsstatistiken zur Marke, historische Performance-Diagramme sowie echte Prompts mit Quellenangaben über mehrere KI-Agenten hinweg
  • Social Media Management: Kanäle, Beiträge, Aktivitätsverlauf und Kennzahlen für verbundene Social-Media-Konten
  • Management: Endpoints zur Verwaltung deiner Rank-Tracker-Projekte und Keywords-Explorer-Listen
  • Abonnementinformationen: Deine API-Limits und Nutzung
  • Öffentliche Endpoints: Die IP-Adressen und -Bereiche unseres Crawlers

Berechtigung

Die Ahrefs API ist in berechtigten kostenpflichtigen Tarifen verfügbar. Bei allen anderen Tarifen hast du weiterhin Zugriff auf einen begrenzten Satz kostenloser Testabfragen.

Planlimits

Alle Anfragen außer kostenlosen Testabfragen sowie den Endpunkten Rank Tracker, Verwaltung, Öffentlich und einigen anderen verbrauchen API-Einheiten. Die Kosten hängen von der Anzahl der Zeilen in einer Antwort und den angeforderten Feldern ab. Die Mindestkosten für jede Anfrage betragen 50 Einheiten. Wenn ein Endpunkt kostenlos ist, siehst du dazu einen Hinweis auf seiner Dokumentationsseite; andernfalls verbraucht er Einheiten.

Zugehöriger Leitfaden: Limits consumption

info

Bitte beachte, dass verbrauchte API-Einheiten nicht erstattet werden können. Wir empfehlen dringend, für alle Entwicklungs- und Testzwecke unsere kostenlosen Testabfragen zu nutzen, um unbeabsichtigten Verbrauch von API-Einheiten zu vermeiden.

Wir empfehlen außerdem, Limits für deine API-Keys festzulegen, besonders während der Test- und Entwicklungsphase.

Berechtigte kostenpflichtige Tarife enthalten ein monatliches Kontingent an API-Einheiten. Bei Tarifen, die Pay-as-you-go-Nutzung unterstützen, werden zusätzliche Einheiten automatisch berechnet, sobald das enthaltene Limit überschritten wird.

Wenn du ein Jahresabo hast, kannst du Geld sparen, indem du weitere API-Einheiten im Voraus zu einem vergünstigten Preis bezahlst. Du kannst den Verbrauch von API-Einheiten nachverfolgen und Prepaid-Add-ons in den Kontoeinstellungen / Limits & Nutzung kaufen.

Siehe auch: Preisseite

Limits und Nutzung

API-Keys

Um Anfragen an die Ahrefs API zu senden, benötigst du einen API-Schlüssel. Nur Workspace-Inhaber und Admins können API-Schlüssel erstellen und verwalten. Das kannst du in den Kontoeinstellungen / API-Schlüssel erledigen.

Zugehöriger Leitfaden: Erstellung und Verwaltung von API-Schlüsseln

Grundlegende Nutzung

Starte schnell mit diesen API-Buttons in den Ahrefs Reports. Klicke darauf, um die Anfrage als cURL-Befehl anzuzeigen.

API button

Diese Buttons können als Query-Builder verwendet werden, da der cURL-Befehl dynamisch mit allen Filtern aktualisiert wird, die du im Report anwendest.

Beachte, dass cURL alle Felder und Metriken enthält, die im aktuellen Report angezeigt werden. Du kannst die Felder entfernen, die du nicht benötigst, um die Kosten einer Anfrage zu reduzieren.

Alle Details zur Nutzung findest du in unserer API-Referenz in diesen Docs. Die Referenz enthält eine OpenAPI-kompatible Spezifikation des Anfrage- und Antwortformats jedes Endpoints.

Rate Limiting

Die Ahrefs API ist standardmäßig auf 60 Anfragen pro Minute begrenzt. Wenn dieses Limit überschritten wird, antwortet die API mit dem HTTP-Statuscode 429 (Too Many Requests).

Zusätzlich können API-Anfragen zur Aufrechterhaltung einer optimalen Performance und Systemstabilität gelegentlich aufgrund von Drosselung mit demselben HTTP-Statuscode 429 abgelehnt werden. Drosselung erfolgt dynamisch auf Basis der Systemauslastung in Echtzeit, der verfügbaren Ressourcen und der Rechenanforderungen deiner Anfragen.