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_urlstring

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

project_namestring

Filtruje projekty według nazwy.

datestring

Znacznik czasu w formacie YYYY-MM-DDThh:mm:ss, określający datę indeksowania, z której mają zostać pobrane metryki. Jeśli nie zostanie podany, domyślnie używany jest najnowszy dostępny indeks. W przypadku zaplanowanych indeksowań zwracamy dane z ostatniego indeksowania zakończonego przed podanym znacznikiem czasu. W przypadku indeksowań w trybie Always-on audit zwracamy dane na moment wskazany przez podaną datę i godzinę. Jeśli część czasowa zostanie pominięta, domyślnie przyjmowana jest 00:00:00. Znacznik czasu jest interpretowany w UTC.

project_idinteger

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

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

healthscoresarray<object>

project_idstring

Unikalny identyfikator projektu.

project_namestring

Nazwa projektu.

target_protocolstring

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

target_urlstring

Adres URL celu projektu.

target_modestring

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

datestring or null

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

statusstring or null

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

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.

urls_with_errorsinteger or null

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

urls_with_warningsinteger or null

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

urls_with_noticesinteger or null

Liczba wewnętrznych adresów URL z uwagami

totalinteger or null

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