Scores de santé du projet

API + MCP

GET/v3/site-audit/projects

Les requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.

Paramètres de requête

project_urlstring

Filtre les projets par URL cible (ignore le protocole et le slash final).

project_namestring

Filtre les projets par nom.

datestring (date-time)

Un horodatage au format YYYY-MM-DDThh:mm:ss précisant la date d'exploration depuis laquelle récupérer les métriques. Par défaut, si ce champ est omis, la dernière exploration disponible est utilisée. Pour les explorations planifiées, nous renvoyons les données de la dernière exploration terminée avant l'horodatage indiqué. Pour les explorations d'audit Always-on, nous renvoyons les données à la date et à l'heure fournies. Si la composante heure est omise, la valeur par défaut est 00:00:00. L'horodatage est interprété en UTC.

project_idinteger

L'identifiant unique du projet. Vous pouvez le trouver dans l'URL de votre projet Site Audit dans Ahrefs : https://app.ahrefs.com/site-audit/#project_id#

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

healthscoresarray<object>

datestring (date-time) or null

La date et l’heure de fin de la dernière opération « Explorer le web » terminée, dans le fuseau horaire GMT.

health_scoreinteger or null

Reflète la proportion d’UR internes de votre site qui ne présentent pas d’erreurs, d’après la dernière opération « Explorer le web » terminée. Exclut les opérations « Explorer le web » en démarrage, en cours, en finalisation ou ignorées.

project_idstring

Identifiant unique du Projet.

project_namestring

Nom du Projet.

statusstring or null

Le statut de la dernière opération « Explorer le web » terminée. Valeurs possibles : Completed, Stopped, Error, In_progress.

target_modestring

La portée de la cible. Valeurs possibles : exact, prefix, domain, subdomains.

target_protocolstring

Le protocole de la cible. Valeurs possibles : both, http, https.

target_urlstring (url)

L’UR de la cible du Projet.

totalinteger or null

Nombre total d'UR internes explorées

urls_with_errorsinteger or null

Nombre d’UR internes avec erreurs

urls_with_noticesinteger or null

Nombre d’UR internes avec remarques

urls_with_warningsinteger or null

Nombre d’UR internes avec avertissements