Docs
Buscar documentación...⌘K

Puntuaciones de salud del proyecto

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

Las solicitudes a este endpoint son gratuitas y no consumen unidades de la API.

Parámetros de consulta

project_urlstring

Filtra los proyectos por la URL de destino (ignora el protocolo y la barra final).

project_namestring

Filtra los proyectos por nombre.

datestring (date-time)

Una marca de tiempo en formato YYYY-MM-DDThh:mm:ss que especifica la fecha de rastreo de la que se obtendrán las métricas. Si se omite, se usa el rastreo más reciente disponible. Para rastreos programados, devolvemos los datos del último rastreo finalizado antes de la marca de tiempo indicada. Para rastreos de auditoría Always-on, devolvemos los datos a la fecha y hora proporcionadas. Si se omite la parte de la hora, se usa por defecto 00:00:00. La marca de tiempo se interpreta en UTC.

project_idinteger

El identificador único del proyecto. Puedes encontrarlo en la URL de tu proyecto de Site Audit en Ahrefs: https://app.ahrefs.com/site-audit/#project_id#

outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

healthscoresarray<object>
datestring (date-time) or null

La fecha y hora de finalización del último Rastreo finalizado, en la zona horaria GMT.

health_scoreinteger or null

Refleja la proporción de URL internas de tu sitio que no tienen errores, según el último Rastreo finalizado. No incluye los Rastreos que están comenzando, en curso, finalizándose o que se hayan omitido.

project_idstring

El identificador único del proyecto.

project_namestring

El nombre del proyecto.

statusstring or null

El estado del Rastreo finalizado más reciente. Posibles valores: Completed, Stopped, Error, In_progress.

target_modestring

El alcance del objetivo. Valores posibles: exact, prefix, domain, subdomains.

target_protocolstring

El protocolo del destino. Valores posibles: both, http, https.

target_urlstring (url)

La URL del destino del proyecto.

totalinteger or null

Número total de URL internas rastreadas

urls_with_errorsinteger or null

Número de URL internas con errores

urls_with_noticesinteger or null

Número de URL internas con avisos

urls_with_warningsinteger or null

Número de URL internas con advertencias