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

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>

project_idstring

Identifiant unique du Projet.

project_namestring

Nom du Projet.

target_protocolstring

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

target_urlstring

L’UR de la cible du Projet.

target_modestring

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

datestring 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.

statusstring or null

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

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.

urls_with_errorsinteger or null

Nombre d’UR internes avec erreurs

urls_with_warningsinteger or null

Nombre d’UR internes avec avertissements

urls_with_noticesinteger or null

Nombre d’UR internes avec remarques

totalinteger or null

Nombre total d'UR internes explorées