Docs
Pesquisar na documentação...⌘K

Pontuações de Saúde do Projeto

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

As solicitações para este endpoint são gratuitas e não consomem unidades de API.

Parâmetros de consulta

project_idinteger

O identificador exclusivo do projeto. Você pode encontrá-lo na URL do seu projeto do Site Audit no Ahrefs: https://app.ahrefs.com/site-audit/#project_id#

datestring (date-time)

Um timestamp no formato YYYY-MM-DDThh:mm:ss que especifica a data do rastreamento da qual recuperar as métricas. Se omitido, o padrão é o rastreamento disponível mais recente. Para rastreamentos agendados, retornamos os dados do último rastreamento concluído antes do timestamp especificado. Para rastreamentos de auditoria Always-on, retornamos os dados referentes à data e hora fornecidas. Se o componente de hora for omitido, o padrão é 00:00:00. O timestamp é interpretado em UTC.

project_namestring

Filtra projetos por nome.

project_urlstring

Filtra projetos por URL de destino (ignora o protocolo e a barra final).

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

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

A data e hora de término do último Rastreamento concluído, no fuso horário GMT.

health_scoreinteger or null

Reflete a proporção de URLs internas do seu site que não têm erros, com base no último Rastreamento concluído. Exclui Rastreamentos que estão iniciando, em andamento, sendo finalizados ou que foram ignorados.

project_idstring

O identificador exclusivo do Projeto.

project_namestring

O nome do projeto.

statusstring or null

O status do Rastreamento concluído mais recente. Valores possíveis: Completed, Stopped, Error, In_progress.

target_modestring

O escopo do alvo. Valores possíveis: exact, prefix, domain, subdomains.

target_protocolstring

O protocolo do destino. Valores possíveis: both, http, https.

target_urlstring (url)

A URL do destino do projeto.

totalinteger or null

Número total de URLs internas rastreadas

urls_with_errorsinteger or null

Número de URLs internas com erros

urls_with_noticesinteger or null

Número de URLs internas com observações

urls_with_warningsinteger or null

Número de URLs internas com avisos