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_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#

datestring (date-time)

Una marca de tiempo en formato YYYY-MM-DDThh:mm:ss que especifica la fecha de rastreo de la que se recuperarán las métricas. Si se omite, se usa de forma predeterminada el rastreo disponible más reciente. Para los rastreos programados, devolvemos los datos del último rastreo que haya finalizado antes de la marca de tiempo especificada. Para los rastreos de auditoría Always-on, devolvemos los datos correspondientes a la fecha y hora proporcionadas. Si se omite el componente de hora, el valor predeterminado es 00:00:00. La marca de tiempo se interpreta en UTC.

project_namestring

Filtra los proyectos por nombre.

project_urlstring

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

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