Oceny kondycji projektów

API + MCP

GET/v3/site-audit/projects

Żądania do tego punktu końcowego są bezpłatne i nie zużywają żadnych jednostek API.

Parametry zapytania

project_idinteger

Unikalny identyfikator projektu. Znajdziesz go w adresie URL swojego projektu Site Audit w Ahrefs: https://app.ahrefs.com/site-audit/#project_id#

datestring (date-time)

Znacznik czasu w formacie YYYY-MM-DDThh:mm:ss, określający datę indeksowania, dla której mają zostać pobrane metryki. Jeśli zostanie pominięty, domyślnie używane jest najnowsze dostępne indeksowanie. W przypadku zaplanowanych indeksowań zwracamy dane z ostatniego indeksowania zakończonego przed wskazanym znacznikiem czasu. W przypadku indeksowań audytu Always-on zwracamy dane według stanu na podaną datę i godzinę. Jeśli część określająca czas zostanie pominięta, domyślnie przyjmowana jest wartość 00:00:00. Znacznik czasu jest interpretowany w UTC.

project_namestring

Filtruje projekty według nazwy.

project_urlstring

Filtruje projekty według docelowego adresu URL (ignoruje protokół i końcowy ukośnik).

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

healthscoresarray<object>

datestring (date-time) or null

Data i godzina zakończenia ostatniego ukończonego indeksowania (strefa czasowa GMT).

health_scoreinteger or null

Odzwierciedla odsetek wewnętrznych adresów URL w Twojej witrynie, które nie mają błędów, na podstawie ostatniego ukończonego indeksowania. Nie obejmuje indeksowań, które się rozpoczynają, są w toku, finalizują się lub zostały pominięte.

project_idstring

Unikalny identyfikator projektu.

project_namestring

Nazwa projektu.

statusstring or null

Status ostatniego ukończonego indeksowania. Możliwe wartości: Completed, Stopped, Error, In_progress.

target_modestring

Zakres celu. Możliwe wartości: exact, prefix, domain, subdomains.

target_protocolstring

Protokół celu. Możliwe wartości: both, http, https.

target_urlstring (url)

Adres URL celu projektu.

totalinteger or null

Łączna liczba wewnętrznych adresów URL zindeksowanych przez indeksowanie.

urls_with_errorsinteger or null

Liczba wewnętrznych adresów URL z błędami

urls_with_noticesinteger or null

Liczba wewnętrznych adresów URL z uwagami

urls_with_warningsinteger or null

Liczba wewnętrznych adresów URL z ostrzeżeniami