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_idinteger

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

datestring (date-time)

Un horodatage au format YYYY-MM-DDThh:mm:ss indiquant la date d’exploration à partir de laquelle récupérer les métriques. S’il est omis, l’exploration disponible la plus récente est utilisée par défaut. Pour les explorations planifiées, nous renvoyons les données de la dernière exploration terminée avant l’horodatage spécifié. Pour les explorations d’audit Always-on, nous renvoyons les données telles qu’elles étaient à la date et à l’heure fournies. Si la composante horaire est omise, sa valeur par défaut est 00:00:00. L’horodatage est interprété en UTC.

project_namestring

Filtre les projets par nom.

project_urlstring

Filtre les projets par URL cible (ignore le protocole et la barre oblique finale).

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