Projekt-Gesundheitswerte

API + MCP

GET/v3/site-audit/projects

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

Query-Parameter

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#

datestring (date-time)

Ein Zeitstempel im Format YYYY-MM-DDThh:mm:ss, der das Crawl-Datum angibt, aus dem Metriken abgerufen werden sollen. Wird er weggelassen, wird standardmäßig der zuletzt verfügbare Crawl verwendet. Bei geplanten Crawls geben wir Daten aus dem letzten Crawl zurück, der vor dem angegebenen Zeitstempel abgeschlossen wurde. Bei Always-on-Audit-Crawls geben wir Daten mit Stand des angegebenen Datums und der angegebenen Uhrzeit zurück. Wird die Zeitangabe weggelassen, gilt standardmäßig 00:00:00. Der Zeitstempel wird als UTC interpretiert.

project_namestring

Filtert Projekte nach Namen.

project_urlstring

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

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

healthscoresarray<object>

datestring (date-time) or null

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

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.

project_idstring

Die eindeutige Kennung des Projekts.

project_namestring

Der Projektname.

statusstring or null

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

target_modestring

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

target_protocolstring

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

target_urlstring (url)

Die URL des Projektziels.

totalinteger or null

Anzahl der insgesamt gecrawlten internen URLs

urls_with_errorsinteger or null

Anzahl interner URLs mit Fehlern

urls_with_noticesinteger or null

Anzahl interner URLs mit Hinweisen

urls_with_warningsinteger or null

Anzahl interner URLs mit Warnungen