Tematy

API + MCP

GET/v3/content-helper/topics

Ten punkt końcowy zużywa bazowo 1000 jednostek na żądanie oraz dodatkowe 500 jednostek, jeśli poprosisz o ocenę adresu URL.

Analiza jest uruchamiana na żądanie na stronach, które obecnie pozycjonują się na dane słowo kluczowe, więc pierwsze żądanie dla słowa kluczowego trwa kilka sekund. Wyniki są buforowane, a kolejne żądania są obsługiwane z pamięci podręcznej bezpłatnie.

Wykorzystywane są wyłącznie wyniki SERP, które Ahrefs już zebrał — nie są zbierane nowe dane SERP. Jeśli zebraliśmy SERP dla danego słowa kluczowego i kraju w ciągu ostatnich 90 dni, punkt końcowy zwraca błąd 400, a jednostki nie są naliczane.

Parametry zapytania

keywordstringWymagane

Słowo kluczowe, dla którego ma zostać przeanalizowany SERP.

countrystringWymagane

Dwuliterowy kod kraju (ISO 3166-1 alpha-2).

Dozwolone wartości:adaeafagaialamaoarasatauawazba…

top_competitorsinteger

Ile najwyżej pozycjonujących się stron przeanalizować. Mniej stron przyspiesza analizę kosztem zakresu.

Domyślne:10

target_urlstring (url)

(500 jednostek) Twoja własna strona do oceny pod kątem tych samych tematów, np. szkic, nad którym pracujesz, lub strona, którą chcesz ulepszyć. Strona jest pobierana na żywo. Za każdym razem kosztuje dodatkowe jednostki API (jej ocena nie jest buforowana).

outputstring

Format wyjściowy.

Dozwolone wartości:jsonphp

Odpowiedzi

topicsarray<object>

avg_scorenumber (float)

Średni wynik pokrycia dla tego tematu, od 0 do 100, obliczony na podstawie stron, które udało się przeanalizować. Wysoka wartość oznacza, że temat jest szczegółowo omówiony na stronach, które już się pozycjonują. Wartość null, gdy żadnej ze stron nie udało się przeanalizować.

descriptionstring

O czym jest główny temat — zgodnie z identyfikacją na podstawie konkurencyjnych stron.

pagesarray<object>

Pokrycie tego tematu na poziomie poszczególnych stron: rekord z polami url, position (pozycja strony w SERP), score (0–100) oraz extracts (fragmenty ze strony, które omawiają temat). Pole score ma wartość null, a pole extracts jest puste w przypadku strony, której treści nie udało się pobrać — taką stronę należy odróżnić od strony, która uzyskała wynik zero.

urlstring (url)

positioninteger

scoreinteger

extractsarray<string>

pages_coveringinteger

Ile spośród przeanalizowanych stron w ogóle obejmuje ten temat (wynik różny od zera).

serp_datestring (date)

Kiedy zebrano analizowany SERP.

targetobject or null

W jakim stopniu strona podana jako target_url obejmuje ten temat. Wartość null, jeśli nie podano target_url.

urlstring (url)

scoreinteger

extractsarray<string>

topicstring

Nazwa głównego tematu omawianego przez najwyżej pozycjonujące się strony.