Przegląd konkurencji

API + MCP

GET/v3/rank-tracker/competitors-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:jsonphp

Odpowiedzi

keywordsarray<object>

competitors_listarray<object>

Informacje o konkurentach dla danego słowa kluczowego. Zawiera następujące pola: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Pola kończące się na prev są uwzględniane tylko w widoku porównawczym.

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

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.

languagestring

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

locationstring

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

serp_featuresarray<string>

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

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.

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".