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

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>
project_idstring

El identificador único del proyecto.

project_namestring

El nombre del proyecto.

target_protocolstring

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

target_urlstring

La URL del destino del proyecto.

target_modestring

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

datestring or null

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

statusstring or null

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

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.

urls_with_errorsinteger or null

Número de URL internas con errores

urls_with_warningsinteger or null

Número de URL internas con advertencias

urls_with_noticesinteger or null

Número de URL internas con avisos

totalinteger or null

Número total de URL internas rastreadas