프로젝트 상태 점수

API + MCP

GET/v3/site-audit/projects

이 엔드포인트에 대한 요청은 무료이며 API 유닛을 소비하지 않습니다.

쿼리 매개변수

project_urlstring

대상 URL로 프로젝트를 필터링합니다(프로토콜과 끝의 슬래시는 무시됨).

project_namestring

이름으로 프로젝트를 필터링합니다.

datestring

YYYY-MM-DDThh:mm:ss 형식의 타임스탬프로, 메트릭을 가져올 크롤링 날짜를 지정합니다. 생략하면 사용 가능한 가장 최근 크롤링을 기본값으로 사용합니다. 예약 크롤링의 경우, 지정한 타임스탬프 이전에 완료된 크롤링 중 가장 최신 크롤링의 데이터를 반환합니다. Always-on audit 크롤링의 경우, 제공된 날짜와 시간 기준의 데이터를 반환합니다. 시간 부분이 생략되면 기본값은 00:00:00입니다. 타임스탬프는 UTC로 해석됩니다.

project_idinteger

프로젝트의 고유 식별자입니다. Ahrefs에서 사이트 감사 프로젝트 URL에서 확인할 수 있습니다: https://app.ahrefs.com/site-audit/#project_id#

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

healthscoresarray<object>

project_idstring

프로젝트의 고유 식별자입니다.

project_namestring

프로젝트 이름입니다.

target_protocolstring

대상의 프로토콜입니다. 가능한 값: both, http, https.

target_urlstring

프로젝트 타깃의 URL입니다.

target_modestring

타깃의 범위입니다. 가능한 값: exact, prefix, domain, subdomains.

datestring or null

마지막으로 완료된 크롤링의 종료 날짜 및 시간(GMT 시간대 기준)입니다.

statusstring or null

가장 최근에 완료된 크롤링의 상태입니다. 가능한 값: Completed, Stopped, Error, In_progress.

health_scoreinteger or null

마지막으로 완료된 크롤링을 기준으로 오류가 없는 사이트 내부 URL의 비율을 반영합니다. 시작 중, 진행 중, 마무리 중이거나 건너뛴 크롤링은 제외됩니다.

urls_with_errorsinteger or null

오류가 있는 내부 URL 수

urls_with_warningsinteger or null

경고가 있는 내부 URL 수

urls_with_noticesinteger or null

알림이 있는 내부 URL 수

totalinteger or null

크롤링된 내부 URL 총 개수