Docs
Cerca nella documentazione...⌘K

Punteggi di salute del progetto

API + MCP
GET/v3/site-audit/projects

Le richieste a questo endpoint sono gratuite e non consumano unità API.

Parametri della query

project_urlstring

Filtra i progetti per URL di destinazione (ignora il protocollo e la barra finale).

project_namestring

Filtra i progetti per nome.

datestring

Un timestamp nel formato YYYY-MM-DDThh:mm:ss che specifica la data della scansione da cui recuperare le metriche. Se omesso, viene usata per impostazione predefinita la scansione più recente disponibile. Per le scansioni pianificate, restituiamo i dati dell'ultima scansione completata prima del timestamp specificato. Per le scansioni di audit Always-on, restituiamo i dati alla data e ora fornite. Se la componente oraria viene omessa, il valore predefinito è 00:00:00. Il timestamp è interpretato in UTC.

project_idinteger

L'identificatore univoco del progetto. Puoi trovarlo nell'URL del tuo progetto Site Audit in Ahrefs: https://app.ahrefs.com/site-audit/#project_id#

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

healthscoresarray<object>
project_idstring

L'identificatore univoco del progetto.

project_namestring

Il nome del progetto.

target_protocolstring

Il protocollo del target. Valori possibili: both, http, https.

target_urlstring

L'URL del target del progetto.

target_modestring

L'ambito del target. Valori possibili: exact, prefix, domain, subdomains.

datestring or null

La data e l’ora di fine dell’ultima Scansione completata, nel fuso orario GMT.

statusstring or null

Lo stato della Scansione completata più recente. Valori possibili: Completed, Stopped, Error, In_progress.

health_scoreinteger or null

Indica la proporzione di URL interni del tuo sito privi di errori, in base all'ultima Scansione completata. Esclude le Scansioni in avvio, in corso, in fase di finalizzazione o che sono state saltate.

urls_with_errorsinteger or null

Numero di URL interni con errori

urls_with_warningsinteger or null

Numero di URL interni con avvisi

urls_with_noticesinteger or null

Numero di URL interni con segnalazioni

totalinteger or null

Numero totale di URL interni scansionati