Przegląd

API + MCP

GET/v3/keywords-explorer/overview

Filtr regex ma ograniczoną funkcjonalność w tym żądaniu, a jego składnia różni się od innych żądań. Oczekuje symbolu gwiazdki (*) jako znaku wieloznacznego.

Parametry zapytania

timeoutinteger

Ręcznie ustawiany limit czasu w sekundach.

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

order_bystring

Kolumna, według której mają zostać posortowane wyniki. Zobacz schemat odpowiedzi, aby poznać prawidłowe identyfikatory kolumn, z wyjątkiem volume_monthly, który nie jest obsługiwany w order_by dla tego endpointu.

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.

volume_monthly_date_tostring (date)

Data końcowa w formacie YYYY-MM-DD, używana do pobierania historycznych miesięcznych wolumenów wyszukiwań w polu volume_monthly_history. Wymagana tylko, jeśli żądane jest volume_monthly_history.

volume_monthly_date_fromstring (date)

Data początkowa w formacie YYYY-MM-DD, używana do pobierania historycznych miesięcznych wolumenów wyszukiwań w polu volume_monthly_history. Wymagana tylko, jeśli żądane jest volume_monthly_history.

target_modestring

Zakres wskazanego przez Ciebie docelowego adresu URL.

Dozwolone wartości:exactprefixdomainsubdomains

targetstring (url)

Cel wyszukiwania: domena lub adres URL.

target_positionstring

Filtruje słowa kluczowe na podstawie pozycji w rankingu określonego target.

Dozwolone wartości:in_top10in_top100

countrystringWymagane

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordsstring

Oddzielana przecinkami lista słów kluczowych, dla których mają być wyświetlane metryki.

keyword_list_idinteger

Identyfikator istniejącej listy słów kluczowych, dla której mają być wyświetlane metryki.

outputstring

The output format.

Dozwolone wartości:jsonphpxml

Odpowiedzi

keywordsarray<object>

clicksinteger or null

Średnia miesięczna liczba kliknięć wyników wyszukiwania wykonywanych przez użytkowników podczas wyszukiwania targetowanego słowa kluczowego.

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.

cpsnumber (float) or null

Kliknięcia na wyszukanie (lub CPS) 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.

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.

first_seenstring (date-time) or null

Data pierwszego sprawdzenia wyników wyszukiwarki dla słowa kluczowego.

global_volumeinteger or null

(10 units) Ile razy średnio miesięcznie użytkownicy wyszukują targetowane słowo kluczowe we wszystkich krajach w naszej bazie danych.

intentsobject or null

(10 jednostek) Wskazuje cel stojący za zapytaniem użytkownika. Pola obiektu: informational, navigational, commercial, transactional, branded lub local. Wszystkie pola są typu bool i mogą przyjmować wartości true lub false.

keywordstring

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

parent_volumeinteger or null

(10 jednostek) Wolumen wyszukiwań Tematu nadrzędnego.

searches_pct_clicks_organic_and_paidnumber (float) or null

Średni miesięczny odsetek osób, które podczas wyszukiwania targetowanego słowa kluczowego kliknęły zarówno wyniki organiczne, jak i płatne.

searches_pct_clicks_organic_onlynumber (float) or null

Średni miesięczny odsetek osób, które podczas wyszukiwania targetowanego słowa kluczowego kliknęły wyłącznie wyniki organiczne.

searches_pct_clicks_paid_onlynumber (float) or null

Średni miesięczny odsetek osób, które podczas wyszukiwania targetowanego słowa kluczowego kliknęły wyłącznie wyniki płatne.

serp_featuresarray<string>

Wzbogacone wyniki na stronie wyników wyszukiwania (SERP), które nie są tradycyjnymi wynikami organicznymi.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring (date-time) or null

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

traffic_potentialinteger or null

(10 jednostek) Suma ruchu organicznego, który strona rankingowa #1 dla targetowanego słowa kluczowego pozyskuje ze wszystkich słów kluczowych, na które się pozycjonuje.

volumeinteger or null

(10 jednostek) Szacunkowa średnia miesięczna liczba wyszukiwań słowa kluczowego w ciągu ostatnich 12 miesięcy danych.

volume_desktop_pctnumber (float) or null

Procent wyszukiwań słowa kluczowego wykonywanych na urządzeniach stacjonarnych.

volume_mobile_pctnumber (float) or null

Procent wyszukiwań słowa kluczowego wykonywanych na urządzeniach mobilnych.

volume_monthlyinteger or null

(10 jednostek) Szacunkowa liczba wyszukiwań słowa kluczowego w ciągu ostatniego miesiąca. To pole może nie być uwzględnione w parametrze order_by

volume_monthly_historyarray<object>

(2 jednostki za każdy miesiąc historyczny, minimum 50 jednostek) Historyczne miesięczne szacunki wolumenu wyszukiwań słowa kluczowego dla okresu określonego parametrami volume_monthly_date_from i volume_monthly_date_to.