Projekt-Gesundheitswerte

API + MCP

GET/v3/site-audit/projects

Anfragen an diesen Endpunkt sind kostenlos und verbrauchen keine API-Einheiten.

Query-Parameter

project_urlstring

Filtert Projekte nach Ziel-URL (ignoriert Protokoll und abschließenden Schrägstrich).

project_namestring

Filtert Projekte nach Namen.

datestring

Ein Zeitstempel im Format YYYY-MM-DDThh:mm:ss, der das Crawl-Datum angibt, aus dem Metriken abgerufen werden. Wenn er weggelassen wird, wird standardmäßig der zuletzt verfügbare Crawl verwendet. Bei geplanten Crawls liefern wir Daten aus dem letzten Crawl, der vor dem angegebenen Zeitstempel abgeschlossen wurde. Bei Always-on-Audit-Crawls liefern wir Daten zum angegebenen Datum und zur angegebenen Uhrzeit. Wenn der Zeitanteil fehlt, wird standardmäßig 00:00:00 verwendet. Der Zeitstempel wird als UTC interpretiert.

project_idinteger

Die eindeutige Kennung des Projekts. Sie finden sie in der URL Ihres Site Audit-Projekts in Ahrefs: https://app.ahrefs.com/site-audit/#project_id#

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

healthscoresarray<object>

project_idstring

Die eindeutige Kennung des Projekts.

project_namestring

Der Projektname.

target_protocolstring

Das Protokoll des Ziels. Mögliche Werte: both, http, https.

target_urlstring

Die URL des Projektziels.

target_modestring

Der Geltungsbereich des Ziels. Mögliche Werte: exact, prefix, domain, subdomains.

datestring or null

Das Enddatum und die Endzeit des letzten abgeschlossenen Crawls in der Zeitzone GMT.

statusstring or null

Der Status des zuletzt abgeschlossenen Crawls. Mögliche Werte: Completed, Stopped, Error, In_progress.

health_scoreinteger or null

Spiegelt den Anteil interner URLs auf Ihrer Website wider, die keine Fehler aufweisen, basierend auf dem letzten abgeschlossenen Crawl. Schließt Crawls aus, die gerade starten, in Bearbeitung sind, abgeschlossen werden oder übersprungen wurden.

urls_with_errorsinteger or null

Anzahl interner URLs mit Fehlern

urls_with_warningsinteger or null

Anzahl interner URLs mit Warnungen

urls_with_noticesinteger or null

Anzahl interner URLs mit Hinweisen

totalinteger or null

Anzahl der insgesamt gecrawlten internen URLs