Przegląd
API + MCPŻądania do tego punktu końcowego są bezpłatne i nie zużywają żadnych jednostek API.
Parametry zapytania
Ręcznie ustawiany limit czasu w sekundach.
Liczba wyników do zwrócenia.
Rozdzielana przecinkami lista kolumn, według których mają być sortowane wyniki, z opcjonalnym kierunkiem sortowania. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.
Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się od identyfikatorów rozpoznawanych przez parametr select).
best_position_has_thumbnail: Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) ma miniaturę.
type: boolean nullable
best_position_has_thumbnail_previous: Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) miała miniaturę w dacie porównania.
type: boolean nullable
best_position_has_video_preview: Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) ma podgląd wideo.
type: boolean nullable
best_position_has_video_preview_previous: Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) miała podgląd wideo w dacie porównania.
type: boolean nullable
best_position_kind: Rodzaj najwyższej pozycji (lub docelowego adresu URL, jeśli ustawiono): organiczna, płatna lub funkcja SERP.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_kind_previous: Rodzaj najwyższej pozycji (lub docelowego adresu URL, jeśli ustawiono) w dacie porównania.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
clicks: Metryka Kliknięcia odnosi się do średniej miesięcznej liczby kliknięć w wyniki wyszukiwania, jakie użytkownicy wykonują podczas wyszukiwania danego słowa kluczowego. Niektóre wyszukiwania generują kliknięcia w wiele wyników, a inne mogą w ogóle nie kończyć się kliknięciem.
type: integer nullable
clicks_per_search: Kliknięcia na wyszukanie to stosunek Kliknięć do Wolumenu wyszukiwań słowa kluczowego. Pokazuje, ile różnych wyników wyszukiwania jest średnio klikanych, gdy użytkownicy wyszukują dane słowo kluczowe w danym kraju.
type: float nullable
cost_per_click: 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.
type: integer nullable
country: Kraj, w którym śledzone jest dane słowo kluczowe. Dwuliterowy kod kraju (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
country_prev: Kraj, w którym śledzone było dane słowo kluczowe w dacie porównania. Dwuliterowy kod kraju (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
created_at: Data dodania słowa kluczowego do projektu.
type: datetime
is_branded: Intencja użytkownika: brandowa. Użytkownik szuka konkretnej marki lub nazwy firmy.
type: boolean
is_commercial: Intencja użytkownika: komercyjna. Użytkownik porównuje produkty lub usługi przed podjęciem decyzji zakupowej.
type: boolean
is_informational: Intencja użytkownika: informacyjna. Użytkownik szuka informacji lub odpowiedzi na konkretne pytanie.
type: boolean
is_local: Intencja użytkownika: lokalna. Użytkownik szuka informacji związanych z konkretną lokalizacją lub usługami w pobliżu.
type: boolean
is_main_position: Wyklucza pozycje w AI Overview, linkach do podstron (sitelinkach), sekcji „Najważniejsze wiadomości", pakietach obrazów, wideo, „Dyskusjach i na forach" oraz postach na X (Twitter).
type: boolean
is_main_position_prev: Wyklucza pozycje w AI Overview, linkach do podstron (sitelinkach), sekcji „Najważniejsze wiadomości", pakietach obrazów, wideo, „Dyskusjach i na forach" oraz postach na X (Twitter) w dacie porównania.
type: boolean
is_navigational: Intencja użytkownika: nawigacyjna. Użytkownik szuka konkretnej witryny lub strony internetowej.
type: boolean
is_transactional: Intencja użytkownika: transakcyjna. Użytkownik jest gotowy wykonać działanie, często dokonać zakupu.
type: boolean
keyword: Słowo kluczowe, na które pozycjonuje się Twój cel.
type: string
keyword_difficulty: Szacunek tego, jak trudno jest znaleźć się w top 10 organicznych wyników wyszukiwania dla słowa kluczowego, w skali 0–100.
type: integer nullable
keyword_has_data: Zwróci false, jeśli słowo kluczowe jest wciąż przetwarzane i nie pobrano jeszcze SERP.
type: boolean
keyword_is_frozen: 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.
type: boolean
keyword_prev: Słowo kluczowe, na które pozycjonował się Twój cel w dacie porównania.
type: string
keyword_words: Liczba słów w słowie kluczowym.
type: integer
keyword_words_prev: Liczba słów w słowie kluczowym w dacie porównania.
type: integer
language: Język SERP, dla którego śledzone jest dane słowo kluczowe.
type: string
language_prev: Język SERP w dacie porównania.
type: string
location: Lokalizacja (kraj, stan/prowincja lub miasto), w której śledzone jest dane słowo kluczowe.
type: string
location_prev: Lokalizacja (kraj, stan/prowincja lub miasto), w której śledzone było dane słowo kluczowe w dacie porównania.
type: string
parent_topic: Temat nadrzędny określa, czy możesz pozycjonować się na docelowe słowo kluczowe, jednocześnie celując na stronie w bardziej ogólny temat. Aby zidentyfikować Temat nadrzędny, bierzemy stronę zajmującą pozycję nr 1 dla Twojego słowa kluczowego i znajdujemy słowo kluczowe odpowiedzialne za dostarczanie największego ruchu na tę stronę.
type: string nullable
position: Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) w organicznych wynikach wyszukiwania.
type: integer nullable
position_diff: Zmiana najwyższej pozycji (lub docelowego adresu URL, jeśli ustawiono) między wybranymi datami.
type: integer nullable
position_prev: Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) w dacie porównania.
type: integer nullable
search_type_image: Typ wyszukiwania Obrazy pokazuje odsetek wyszukiwań danego słowa kluczowego wykonywanych w obrazach, podkreślając zainteresowanie treściami wizualnymi.
type: float nullable
search_type_news: Typ wyszukiwania Wiadomości pokazuje odsetek wyszukiwań danego słowa kluczowego wykonywanych dla artykułów z wiadomościami.
type: float nullable
search_type_video: Typ wyszukiwania Wideo pokazuje odsetek wyszukiwań danego słowa kluczowego wykonywanych w wideo, odzwierciedlając zainteresowanie treściami wideo.
type: float nullable
search_type_web: Typ wyszukiwania Internet pokazuje odsetek wyszukiwań danego słowa kluczowego wykonywanych dla ogólnych treści internetowych, wskazując zainteresowanie szerokim zakresem informacji.
type: float nullable
serp_features: Funkcje SERP, które pojawiają się w wynikach wyszukiwania dla danego słowa kluczowego.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_features_prev: Funkcje SERP, które pojawiają się w wynikach wyszukiwania dla danego słowa kluczowego w dacie porównania.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_updated: Data ostatniego sprawdzenia wyników wyszukiwania dla danego słowa kluczowego.
type: datetime nullable
serp_updated_prev: Data sprawdzenia wyników wyszukiwania do dnia porównania.
type: datetime nullable
tags: Lista tagów przypisanych do danego słowa kluczowego.
type: array(string)
tags_prev: Lista tagów przypisanych do danego słowa kluczowego w dacie porównania.
type: array(string)
target_positions_count: Liczba docelowych adresów URL pozycjonujących się na dane słowo kluczowe.
type: integer
traffic: Szacunek liczby miesięcznych wizyt, jakie strona uzyskuje z organicznych wyników wyszukiwania w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych — zależnie od parametru „volume_mode".
type: integer nullable
traffic_diff: Zmiana ruchu między wybranymi datami.
type: integer nullable
traffic_prev: Szacunek liczby miesięcznych wizyt, jakie strona uzyskuje z organicznych wyników wyszukiwania w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych — zależnie od parametru „volume_mode".
type: integer nullable
url: Najwyżej pozycjonujący się adres URL (lub docelowy adres URL, jeśli ustawiono) w organicznych wynikach wyszukiwania.
type: string nullable
url_prev: Najwyżej pozycjonujący się adres URL (lub docelowy adres URL, jeśli ustawiono) w dacie porównania.
type: string nullable
volume: Szacunek wolumenu wyszukiwań, czyli średniej miesięcznej liczby wyszukiwań słowa kluczowego w ostatnim miesiącu lub w ostatnich znanych 12 miesiącach danych — zależnie od parametru „volume_mode".
type: integer nullable
volume_desktop_pct: Odsetek całkowitego wolumenu wyszukiwań pochodzący z urządzeń desktopowych.
type: float nullable
volume_mobile_pct: Odsetek całkowitego wolumenu wyszukiwań pochodzący z urządzeń mobilnych.
type: float nullable
Lista kolumn zwracanych w odpowiedzi, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.
Data do porównania metryk w formacie YYYY-MM-DD.
Data, dla której mają zostać zaraportowane metryki, w formacie YYYY-MM-DD.
Wybierz rankingi mobilne lub desktopowe.
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#
Tryb obliczania Wolumen wyszukiwań: miesięczny lub średni. Wpływa na wolumen, ruch i Wartość ruchu.
Format wyjściowy.
Odpowiedzi
Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) ma miniaturę.
Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) miała miniaturę w dacie porównania.
Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) ma podgląd wideo.
Najwyższa pozycja (lub docelowego adresu URL, jeśli ustawiono) miała podgląd wideo w dacie porównania.
Rodzaj najwyższej pozycji (lub docelowego adresu URL, jeśli ustawiono): organiczna, płatna lub funkcja SERP.
Rodzaj najlepszej pozycji (lub docelowych adresów URL, jeśli ustawiono) w dacie porównania.
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.
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.
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.
Kraj, w którym śledzone jest dane słowo kluczowe. Dwuliterowy kod kraju (ISO 3166-1 alpha-2).
Kraj, w którym śledzone jest dane słowo kluczowe w dacie porównania. Dwuliterowy kod kraju (ISO 3166-1 alpha-2).
Data dodania słowa kluczowego do projektu.
Intencja użytkownika: związana z marką. Użytkownik szuka konkretnej marki lub nazwy firmy.
Intencja użytkownika: handlowa. Użytkownik porównuje produkty lub usługi przed podjęciem decyzji o zakupie.
Intencja użytkownika: informacyjna. Użytkownik szuka informacji lub odpowiedzi na konkretne pytanie.
Intencja użytkownika: lokalizacyjna. Użytkownik szuka informacji dotyczących określonej lokalizacji lub pobliskich usług.
Intencja użytkownika: nawigacyjna. Użytkownik szuka konkretnej witryny lub strony internetowej.
Intencja użytkownika: transakcyjna. Użytkownik jest gotów do wykonania działania, często zakupu.
Słowo kluczowe, na które pozycjonuje się Twój cel.
Szacunkowa miara trudności pozycjonowania w pierwszej dziesiątce organicznych wyników wyszukiwania dla danego słowa kluczowego, wyrażona w skali 100-punktowej.
Zwróci wartość false, jeśli słowo kluczowe jest nadal przetwarzane i nie pobrano jeszcze żadnych wyników SERP.
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.
Słowo kluczowe, na które pozycjonuje się Twój cel na datę porównawczą.
Język SERP, dla którego śledzone jest dane słowo kluczowe.
Język SERP na datę porównawczą.
Lokalizacja (kraj, stan/prowincja lub miasto), w której śledzone jest dane słowo kluczowe.
Lokalizacja (kraj, stan/prowincja lub miasto), w której śledzone jest dane słowo kluczowe w dacie porównania.
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ę.
Najlepsza pozycja w wynikach organicznych (lub docelowe adresy URL, jeśli ustawiono).
Zmiana najlepszej pozycji (lub docelowych adresów URL, jeśli ustawiono) między wybranymi datami.
Najlepsza pozycja (lub docelowe adresy URL, jeśli ustawiono) w dacie porównania.
Typ wyszukiwania Obraz wskazuje procent wyszukiwań dla słowa kluczowego wykonywanych dla obrazów, podkreślając zainteresowanie treściami wizualnymi.
Rodzaj wyszukiwania Wiadomości pokazuje procent wyszukiwań słowa kluczowego przeznaczonego dla artykułów wiadomości.
Typ wyszukiwania wideo wskazuje procent wyszukiwań dla słowa kluczowego wykonywanych dla materiałów wideo, podkreślając zainteresowanie treściami wideo.
Typ wyszukiwania Web pokazuje procent wyszukiwań dla słowa kluczowego związanego z ogólną treścią stron, wskazując zainteresowanie szeroką gamą informacji.
Funkcje SERP które pojawiają się w wynikach wyszukiwania na słowo kluczowe.
Funkcje SERP, które pojawiają się w wynikach wyszukiwania dla słowa kluczowego w dacie porównawczej.
Data ostatniego sprawdzania wyników wyszukiwarki dla słowa kluczowego.
Data, w której sprawdziliśmy wyniki wyszukiwarek do daty porównawczej.
Lista tagów przypisanych do danego słowa kluczowego.
Lista tagów przypisanych do danego słowa kluczowego w dacie porównawczej.
Liczba docelowych adresów URL rankingujących dla słowa kluczowego.
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".
Zmiana ruchu pomiędzy wybranymi datami.
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".
Najwyżej rankujący adres URL (lub docelowy adres URL, jeśli ustawiono) w organicznych wynikach wyszukiwania.
Najwyżej rankujący adres URL (lub docelowy adres URL, jeśli ustawiono) w dacie porównawczej.
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".
Procent całkowitego wolumenu wyszukiwań pochodzący z urządzeń stacjonarnych.
Procent całkowitego wolumenu wyszukiwań pochodzący z urządzeń mobilnych.