Przegląd

API + MCP

GET/v3/rank-tracker/overview

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

Parametry zapytania

timeoutinteger

Ręcznie ustawiany limit czasu w sekundach.

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

order_bystring

Rozdzielana przecinkami lista kolumn, według których mają być sortowane wyniki, z opcjonalnym kierunkiem sortowania. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

Example:field_a,field_b:asc,field_c:desc

wherestring

Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się od identyfikatorów rozpoznawanych przez parametr select).

selectstringWymagane

Lista kolumn do zwrócenia, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

date_comparedstring (date)

Data do porównania metryk w formacie YYYY-MM-DD.

datestring (date)Wymagane

Data, dla której mają zostać zaraportowane metryki, w formacie YYYY-MM-DD.

devicestringWymagane

Wybierz rankingi mobilne lub desktopowe.

Dozwolone wartości:desktopmobile

project_idintegerWymagane

Unikalny identyfikator projektu. Możesz go znaleźć w adresie URL swojego projektu Rank Tracker w Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

Tryb obliczania Wolumen wyszukiwań: miesięczny lub średni. Wpływa na wolumen, ruch i Wartość ruchu.

Dozwolone wartości:monthlyaverage

Domyślne:monthly

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

overviewsarray<object>

best_position_has_thumbnailboolean or null

Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) ma miniaturę.

best_position_has_thumbnail_previousboolean or null

Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) miała miniaturę w dacie porównania.

best_position_has_video_previewboolean or null

Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) ma podgląd wideo.

best_position_has_video_preview_previousboolean or null

Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) miała podgląd wideo w dacie porównania.

best_position_kindstring or null

Rodzaj najwyższej pozycji (lub docelowego adresu URL, jeśli ustawiono): organiczna, płatna lub funkcja SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

best_position_kind_previousstring or null

Rodzaj najlepszej pozycji (lub docelowych adresów URL, jeśli ustawiono) w dacie porównania.

clicksinteger or null

Wskaźnik Kliknięcia odnosi się do średniej miesięcznej liczby kliknięć wyników wyszukiwania, które wykonują użytkownicy podczas wyszukiwania docelowego słowa kluczowego. Niektóre wyszukiwania generują kliknięcia wielu wyników, podczas gdy inne mogą w ogóle nie kończyć się kliknięciami.

clicks_per_searchnumber (float) or null

Kliknięcia na wyszukanie to współczynnik kliknięć do wolumenu wyszukań słowa kluczowego. Pokazuje, jak wiele różnych wyników wyszukań jest średnio klikanych, gdy ludzie szukają wybranego słowa kluczowego w danym kraju.

cost_per_clickinteger or null

Koszt za kliknięcie pokazuje średnią cenę, jaką reklamodawcy płacą za każde kliknięcie reklamy w płatnych wynikach wyszukiwania dla danego słowa kluczowego.

countrystring

Kraj, w którym śledzone jest dane słowo kluczowe. Dwuliterowy kod kraju (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

country_prevstring

Kraj, w którym śledzone jest dane słowo kluczowe w dacie porównania. Dwuliterowy kod kraju (ISO 3166-1 alpha-2).

created_atstring (date-time)

Data dodania słowa kluczowego do projektu.

is_brandedboolean

Intencja użytkownika: związana z marką. Użytkownik szuka konkretnej marki lub nazwy firmy.

is_commercialboolean

Intencja użytkownika: handlowa. Użytkownik porównuje produkty lub usługi przed podjęciem decyzji o zakupie.

is_informationalboolean

Intencja użytkownika: informacyjna. Użytkownik szuka informacji lub odpowiedzi na konkretne pytanie.

is_localboolean

Intencja użytkownika: lokalizacyjna. Użytkownik szuka informacji dotyczących określonej lokalizacji lub pobliskich usług.

is_navigationalboolean

Intencja użytkownika: nawigacyjna. Użytkownik szuka konkretnej witryny lub strony internetowej.

is_transactionalboolean

Intencja użytkownika: transakcyjna. Użytkownik jest gotów do wykonania działania, często zakupu.

keywordstring

Słowo kluczowe, na które pozycjonuje się Twój cel.

keyword_difficultyinteger or null

Szacunkowa miara trudności pozycjonowania w pierwszej dziesiątce organicznych wyników wyszukiwania dla danego słowa kluczowego, wyrażona w skali 100-punktowej.

keyword_has_databoolean

Zwróci wartość false, jeśli słowo kluczowe jest nadal przetwarzane i nie pobrano jeszcze żadnych wyników SERP.

keyword_is_frozenboolean

Wskazuje, czy słowo kluczowe przekroczyło limit śledzonych słów kluczowych w Twoim planie. Takie słowa kluczowe są „zamrożone”, co oznacza, że ich pozycje nie są aktualizowane.

keyword_prevstring

Słowo kluczowe, na które pozycjonuje się Twój cel na datę porównawczą.

languagestring

Język SERP, dla którego śledzone jest dane słowo kluczowe.

language_prevstring

Język SERP na datę porównawczą.

locationstring

Lokalizacja (kraj, stan/prowincja lub miasto), w której śledzone jest dane słowo kluczowe.

location_prevstring

Lokalizacja (kraj, stan/prowincja lub miasto), w której śledzone jest dane słowo kluczowe w dacie porównania.

parent_topicstring or null

Temat nadrzędny określa, czy można pozycjonować się na targetowane słowo kluczowe, targetując zamiast tego na bardziej ogólny temat na stronie. Aby zidentyfikować temat nadrzędny, bierzemy pod uwagę pierwszą stronę pozycjonowania dla danego słowa kluczowego i znajdujemy słowo kluczowe odpowiedzialne za wysłanie największego ruchu na tę stronę.

positioninteger or null

Najlepsza pozycja w wynikach organicznych (lub docelowe adresy URL, jeśli ustawiono).

position_diffinteger or null

Zmiana najlepszej pozycji (lub docelowych adresów URL, jeśli ustawiono) między wybranymi datami.

position_previnteger or null

Najlepsza pozycja (lub docelowe adresy URL, jeśli ustawiono) w dacie porównania.

search_type_imagenumber (float) or null

Typ wyszukiwania Obraz wskazuje procent wyszukiwań dla słowa kluczowego wykonywanych dla obrazów, podkreślając zainteresowanie treściami wizualnymi.

search_type_newsnumber (float) or null

Rodzaj wyszukiwania Wiadomości pokazuje procent wyszukiwań słowa kluczowego przeznaczonego dla artykułów wiadomości.

search_type_videonumber (float) or null

Typ wyszukiwania wideo wskazuje procent wyszukiwań dla słowa kluczowego wykonywanych dla materiałów wideo, podkreślając zainteresowanie treściami wideo.

search_type_webnumber (float) or null

Typ wyszukiwania Web pokazuje procent wyszukiwań dla słowa kluczowego związanego z ogólną treścią stron, wskazując zainteresowanie szeroką gamą informacji.

serp_featuresarray<string>

Funkcje SERP które pojawiają się w wynikach wyszukiwania na słowo kluczowe.

serp_features_prevarray<string>

Funkcje SERP, które pojawiają się w wynikach wyszukiwania dla słowa kluczowego w dacie porównawczej.

serp_updatedstring (date-time) or null

Data ostatniego sprawdzania wyników wyszukiwarki dla słowa kluczowego.

serp_updated_prevstring (date-time) or null

Data, w której sprawdziliśmy wyniki wyszukiwarek do daty porównawczej.

tagsarray<string>

Lista tagów przypisanych do danego słowa kluczowego.

tags_prevarray<string>

Lista tagów przypisanych do danego słowa kluczowego w dacie porównawczej.

target_positions_countinteger

Liczba docelowych adresów URL rankingujących dla słowa kluczowego.

trafficinteger or null

Szacunkowa liczba miesięcznych wizyt, które strona uzyskuje z organicznych wyników wyszukiwania, z ostatniego miesiąca lub z ostatnich znanych 12 miesięcy danych — w zależności od parametru "volume_mode".

traffic_diffinteger or null

Zmiana ruchu pomiędzy wybranymi datami.

traffic_previnteger or null

urlstring (url) or null

Najwyżej rankujący adres URL (lub docelowy adres URL, jeśli ustawiono) w organicznych wynikach wyszukiwania.

url_prevstring (url) or null

Najwyżej rankujący adres URL (lub docelowy adres URL, jeśli ustawiono) w dacie porównawczej.

volumeinteger or null

Szacunkowa średnia miesięczna liczba wyszukiwań słowa kluczowego z ostatniego miesiąca lub z ostatnich znanych 12 miesięcy danych — w zależności od parametru "volume_mode".

volume_desktop_pctnumber (float) or null

Procent całkowitego wolumenu wyszukiwań pochodzący z urządzeń stacjonarnych.

volume_mobile_pctnumber (float) or null

Procent całkowitego wolumenu wyszukiwań pochodzący z urządzeń mobilnych.