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 filtrowania. Rozpoznawane są następujące identyfikatory kolumn (różnią się one od identyfikatorów rozpoznawanych przez parametr select).

selectstringWymagane

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

keyword_list_idinteger

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

keywordsstring

Lista słów kluczowych rozdzielona przecinkami, dla której mają być wyświetlane metryki.

countrystringWymagane

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

Dozwolone wartości:adaeafagaialamaoarasatauawazba…

target_positionstring

Filtruje słowa kluczowe na podstawie pozycji rankingowej wskazanego target.

Dozwolone wartości:in_top10in_top100

targetstring (url)

Cel wyszukiwania: domena lub adres URL.

modestring

Zakres celu.

Dozwolone wartości:exactprefixdomainsubdomains

volume_monthly_date_fromstring (date)

Data początkowa w formacie RRRR-MM-DD służąca do pobierania historycznego miesięcznego wolumenu wyszukiwań w polu volume_monthly_history. Wymagana tylko wtedy, gdy żądane jest volume_monthly_history.

volume_monthly_date_tostring (date)

Data końcowa w formacie YYYY-MM-DD służąca do pobierania historycznych danych o miesięcznym wolumenie wyszukiwań w polu volume_monthly_history. Wymagana tylko wtedy, gdy zażądano pola volume_monthly_history.

outputstring

Format wyjściowy.

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.

Dozwolone wartości:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_card…

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.