Verbrauchslimits

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

Alle Anfragen außer kostenlosen Testabfragen und den Endpoints Rank Tracker, Management, Public und einigen anderen verbrauchen API-Einheiten. Wenn ein Endpoint kostenlos ist, sehen Sie dazu einen Hinweis auf seiner Dokumentationsseite; andernfalls verbraucht er Einheiten.

Der Einheitenverbrauch pro Anfrage wird wie folgt berechnet:

max(base_cost, per_row_cost * num_rows)

Der base_cost jeder Anfrage beträgt 50 Einheiten. Der per_row_cost ist die Summe der Kosten jedes eindeutigen Feldes, das entweder im zurückgegebenen Ergebnis oder in den Parametern where oder order_by vorkommt. Wenn ein Feld in mehreren Parametern vorkommt, wird es einmal gezählt.

Die Standardkosten eines Feldes betragen 1 Einheit. Bestimmte Metriken sind jedoch teurer und können 5 oder 10 Einheiten verbrauchen. Solche Ausnahmen sind in der Feldbeschreibung des jeweiligen Endpoints angegeben. Anfragen, die aus dem Cache bedient werden, verbrauchen keine Einheiten.

Jede API-Anfrage gibt ihr Einheitenverbrauchsverhalten über die folgenden Response-Header an:

x-api-rows Die Anzahl der zurückgegebenen Zeilen.
x-api-units-cost-row Die Einheitenkosten pro Zeile.
x-api-units-cost-total Die Gesamtzahl der Einheiten, die die Anfrage basierend auf der Anzahl der Zeilen und den Kosten pro Zeile verbrauchen sollte.
x-api-units-cost-total-actual Die Gesamtzahl der Einheiten, die die Anfrage tatsächlich verbraucht hat.
x-api-cache Ob die Anfrage aus dem Cache bedient wurde. Einer der folgenden Werte: hit miss no_cache

info

Eine gute Möglichkeit, die Kosten einer Anfrage abzuschätzen, besteht darin, sie mit einem kostenlosen Ziel auszuführen und den Wert des Felds x-api-units-cost-total zu überprüfen. Um die Antwort-Header bei Verwendung des curl-Befehls anzuzeigen, können Sie die Option -v oder --verbose verwenden.

Beispiel 1

Betrachten Sie eine Anfrage an den Endpunkt Site Explorer - Domain-Rating (/site-explorer/domain-rating).

Er akzeptiert keine Parameter select, where oder order_by und gibt eine einzelne Zeile mit zwei Feldern zurück – domain_rating und ahrefs_rank – bei Kosten von 2 Einheiten pro Zeile.

Die Gesamtkosten für Zeilen (Kosten pro Zeile multipliziert mit der Anzahl der Zeilen) sind geringer als die Basiskosten. Daher kostet diese Anfrage den Basisbetrag von 50 Einheiten.

Beispiel 2

Betrachten Sie eine komplexere Anfrage an den Endpunkt Site Explorer - Backlinks (/site-explorer/all-backlinks), die die Konfiguration der Parameter select, where und order_by ermöglicht.

Angenommen, für diese Anfrage werden zwei Felder ausgewählt:

select=title,traffic

zwei Felder im Filterausdruck:

where={"and":[{"field":"traffic","is":["gt",1000]},{"field":"refdomains_source","is":["gt",10]}]}

und ein Sortierfeld:

order_by=traffic:desc

Über diese Parameter hinweg gibt es drei eindeutige Felder: title und refdomains_source kosten jeweils 1 Einheit, traffic hingegen kostet 10 Einheiten. Damit betragen die Kosten pro Zeile 1 + 1 + 10 = 12 Einheiten.

Angenommen, die Anfrage gibt 500 Zeilen zurück. Dann übersteigen die Gesamtkosten für Zeilen (12 * 500 = 6000 Einheiten) die Basiskosten. Daher betragen die Kosten dieser Anfrage 6000 Einheiten.