Docs
Szukaj w dokumentacji...⌘K

Organiczne słowa kluczowe

API + MCP
GET/v3/site-explorer/organic-keywords

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.

protocolstring

Protokół Twojego celu.

Dozwolone wartości:bothhttphttps
Domyślne:both
targetstring (url)Wymagane

Cel wyszukiwania: domena lub adres URL.

modestring

Zakres wyszukiwania na podstawie podanego celu.

Dozwolone wartości:exactprefixdomainsubdomains
Domyślne:subdomains
countrystring

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
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.

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

keywordsarray<object>
all_positionsarray<object>

(5 jednostek) Lista wszystkich pozycji dla słowa kluczowego.

all_positions_prevarray<object>

(5 jednostek) Lista wszystkich pozycji dla słowa kluczowego na dzień porównania.

best_positioninteger or null

Najwyższe pozycjonowanie celu w organicznych wynikach wyszukiwana dla danego słowa kluczowego.

best_position_diffinteger or null

Zmiana pozycji między wybranymi datami.

best_position_has_thumbnailboolean or null

Najwyższa pozycja ma miniaturę.

best_position_has_thumbnail_prevboolean or null

Najwyższa pozycja ma miniaturę w dniu porównania.

best_position_has_videoboolean or null

Najwyższa pozycja ma wideo.

best_position_has_video_prevboolean or null

Najwyższa pozycja ma wideo w dniu porównania.

best_position_kindstring or null

Rodzaj najwyższej pozycji: organiczna, płatna lub funkcja SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

Rodzaj najwyższej pozycji zoptymalizowany pod kątem sortowania.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

Rodzaj najwyższej pozycji w dniu porównania.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

Najwyższa pozycja w dniu porównania.

best_position_setstring

Grupa rankingowa najwyższej pozycji.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

Grupa rankingowa najwyższej pozycji w dniu porównania.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

Adres URL zajmujący pozycję w wynikach wyszukiwania organicznego.

best_position_url_prevstring (url) or null

Adres URL zajmujący pozycję w dniu porównania.

cpcinteger 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, w centach USD.

cpc_mergedinteger or null

Pole CPC zoptymalizowane do sortowania.

cpc_previnteger or null

Metryka CPC w dacie porównawczej.

entitiesarray<object>

Organizacje, produkty, osoby, dzieła, wydarzenia i lokalizacje znalezione dla słowa kluczowego.

is_best_position_set_top_11_50boolean

Grupa rankingowa najlepszej pozycji to 11–50.

is_best_position_set_top_11_50_prevboolean or null

Grupa rankingowa najlepszej pozycji wynosiła 11–50 na datę porównawczą.

is_best_position_set_top_3boolean

Grupa rankingowa najlepszej pozycji to Top 3.

is_best_position_set_top_3_prevboolean or null

Grupa rankingowa najlepszej pozycji wynosiła Top 3 na datę porównawczą.

is_best_position_set_top_4_10boolean

Grupa rankingowa najlepszej pozycji to 4–10.

is_best_position_set_top_4_10_prevboolean or null

Grupa rankingowa najlepszej pozycji wynosiła 4–10 na datę porównawczą.

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 or null

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

keyword_countrystring

Kraj słowa kluczowego, na które pozycjonuje się Twój cel.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_difficultyinteger or null

(10 jednostek) Oszacowanie trudności znalezienia się w top 10 organicznych wyników wyszukiwania dla danego słowa kluczowego, w skali 100 punktów.

keyword_difficulty_mergedinteger or null

(10 jednostek) Pole Trudność słowa kluczowego zoptymalizowane pod kątem sortowania.

keyword_difficulty_previnteger or null

(10 jednostek) Trudność słowa kluczowego na datę porównawczą.

keyword_languagearray<string>

Język zapytania wyszukiwania

keyword_mergedstring

Pole słowa kluczowego zoptymalizowane pod kątem sortowania.

keyword_prevstring or null

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

languagestring

Język SERP.

language_prevstring or null

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

last_updatestring (date-time)

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

last_update_prevstring (date-time) or null

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

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_features_countinteger

Liczba funkcji SERP, które pojawiają się w wynikach wyszukiwania dla słowa kluczowego.

serp_features_count_previnteger or null

Liczba funkcji SERP w dacie porównawczej.

serp_features_mergedarray<string>

Pole funkcji SERP zoptymalizowane pod kątem sortowania.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_target_main_positions_countinteger

Liczba docelowych adresów URL rankingujących dla słowa kluczowego, z wyłączeniem pozycji w linkach do stron, najważniejszych artykułach, pakietach obrazów i postach na X (Twitter).

serp_target_main_positions_count_previnteger or null

Liczba docelowych adresów URL rankingujących dla słowa kluczowego, z wyłączeniem pozycji w linkach do stron, najważniejszych artykułach, pakietach obrazów i postach na X (Twitter), w dacie porównawczej.

serp_target_positions_countinteger

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

serp_target_positions_count_previnteger or null

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

statusstring

Status strony: nowa strona, która właśnie zaczęła się pozycjonować („left”), utracona strona, która zniknęła z wyników wyszukiwania („right”), albo brak zmian („both”).

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10 jednostek) Szacunkowa liczba miesięcznych wizyt, które Twój cel uzyskuje z płatnych wyników wyszukiwania dla słowa kluczowego.

sum_paid_traffic_mergedinteger

(10 jednostek) Pole ruchu płatnego zoptymalizowane pod kątem sortowania.

sum_paid_traffic_previnteger or null

(10 jednostek) Ruch płatny w dacie porównawczej.

sum_trafficinteger or null

(10 jednostek) Szacunkowa liczba miesięcznych wizyt, które Twój cel uzyskuje z organicznych wyników wyszukiwania dla słowa kluczowego.

sum_traffic_mergedinteger

(10 jednostek) Pole ruchu zoptymalizowane pod kątem sortowania.

sum_traffic_previnteger or null

(10 jednostek) Ruch na datę porównania.

volumeinteger or null

(10 jednostek) Szacowana liczba wyszukiwań słowa kluczowego w ciągu ostatniego miesiąca.

volume_desktop_pctnumber (float) or null

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

volume_mergedinteger or null

(10 jednostek) Pole Wolumen wyszukiwań zoptymalizowane pod kątem sortowania.

volume_mobile_pctnumber (float) or null

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

volume_previnteger or null

(10 jednostek) Wolumen wyszukiwań na datę porównania.

wordsinteger or null

Liczba słów w słowie kluczowym.

words_mergedinteger

Liczba słów w słowie kluczowym, zoptymalizowana pod kątem sortowania.

words_previnteger or null

Liczba słów w słowie kluczowym na datę porównania.