Pasujące hasła

API + MCP

GET/v3/keywords-explorer/matching-terms

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

cpc: Koszt za kliknięcie pokazuje średnią cenę, jaką reklamodawcy płacą za każde kliknięcie reklamy w płatnych wynikach wyszukiwania dla słowa kluczowego, w centach USD.
type: integer nullable

cps: 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.
type: float nullable

difficulty (10 units): Szacunek tego, jak trudno jest uzyskać pozycję w top 10 organicznych wyników wyszukiwania dla słowa kluczowego w 100-punktowej skali.
type: integer nullable

first_seen: Data, kiedy po raz pierwszy sprawdziliśmy wyniki wyszukiwarki dla słowa kluczowego.
type: datetime nullable

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

intents (10 units): 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.
type: object nullable

keyword:
type: string

parent_topic: Temat nadrzędny określa, czy możesz rankować na docelowe słowo kluczowe, jednocześnie targetując na stronie bardziej ogólny temat. Aby zidentyfikować Temat nadrzędny, bierzemy stronę na #1 pozycji dla Twojego słowa kluczowego i znajdujemy słowo kluczowe, które odpowiada za wygenerowanie największego ruchu na tę stronę.
type: string nullable

serp_domain_rating_top10_min: Słowo kluczowe musi mieć co najmniej jedną pozycję w rankingu w top 10 wyników z DR do tej wartości.
type: float nullable

serp_domain_rating_top5_min: Słowo kluczowe musi mieć co najmniej jedną pozycję w rankingu w top 5 wyników z DR do tej wartości.
type: float nullable

serp_features: Rozszerzone wyniki na stronie wyników wyszukiwarki (SERP), które nie są tradycyjnymi organicznymi wynikami.
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"

serp_last_update: Data, kiedy ostatnio sprawdziliśmy wyniki wyszukiwarki dla słowa kluczowego.
type: datetime nullable

traffic_potential (10 units): Suma ruchu organicznego, jaki otrzymuje strona na #1 pozycji dla Twojego docelowego słowa kluczowego ze wszystkich słów kluczowych, na które się pozycjonuje.
type: integer nullable

volume (10 units): Szacunek średniej miesięcznej liczby wyszukiwań słowa kluczowego na podstawie ostatnich znanych danych z 12 miesięcy.
type: integer nullable

volume_desktop_pct: Procent wyszukiwań słowa kluczowego wykonywanych na urządzeniach desktopowych.
type: float nullable

volume_mobile_pct: Procent wyszukiwań słowa kluczowego wykonywanych na urządzeniach mobilnych.
type: float nullable

word_count:
type: integer

selectstringWymagane

Lista kolumn zwracanych w odpowiedzi, rozdzielona przecinkami. Prawidłowe identyfikatory kolumn znajdziesz w schemacie odpowiedzi.

countrystringWymagane

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

search_enginestring

[Wycofane 5 sierpnia 2024].

Dozwolone wartości:google

Domyślne:google

keywordsstring

Lista słów kluczowych oddzielonych przecinkami, dla których mają zostać wyświetlone metryki.

keyword_list_idinteger

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

match_modestring

Pomysły na słowa kluczowe zawierają słowa z Twojego zapytania w dowolnej kolejności (tryb terms) lub w dokładnie takiej kolejności, w jakiej zostały wpisane (tryb phrase).

Dozwolone wartości:termsphrase

Domyślne:terms

termsstring

Wszystkie pomysły na słowa kluczowe lub pomysły na słowa kluczowe sformułowane jako pytania.

Dozwolone wartości:allquestions

Domyślne:all

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

keywordsarray<object>

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

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

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

volume_mobile_pctnumber 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