Docs
Cerca nella documentazione...⌘K

Termini corrispondenti

API + MCP
GET/v3/keywords-explorer/matching-terms

Parametri della query

timeoutinteger

Una durata di timeout manuale in secondi.

limitinteger

Il numero di risultati da restituire.

Predefinita:1000
order_bystring

Una colonna in base a cui ordinare i risultati. Consulta lo Schema della risposta per gli identificatori di colonna validi, ad eccezione di volume_monthly, che non è supportato in order_by per questo endpoint.

Example:field_a,field_b:asc,field_c:desc
wherestring

L'espressione del filtro. Sono riconosciuti i seguenti identificatori di colonna (che differiscono dagli identificatori riconosciuti dal parametro select).

cpc: Costo per clic mostra il prezzo medio che gli inserzionisti pagano per ogni clic sull'annuncio nei risultati di ricerca a pagamento per una parola chiave, in centesimi di USD.
type: integer nullable

cps: Clic per ricerca (o CPS) è il rapporto tra i Clic e il Volume di ricerca della parola chiave. Mostra quanti risultati di ricerca diversi ricevono un clic, in media, quando le persone cercano la parola chiave obiettivo in un determinato paese.
type: float nullable

difficulty (10 units): Una stima di quanto sia difficile posizionarsi tra i primi 10 risultati di ricerca organici per una parola chiave, su una scala di 100 punti.
type: integer nullable

first_seen: La data in cui abbiamo controllato per la prima volta i risultati del motore di ricerca per una parola chiave.
type: datetime nullable

global_volume (10 units): Quante volte al mese, in media, le persone cercano la parola chiave obiettivo in tutti i Paesi del nostro database.
type: integer nullable

intents (10 units): Indica lo scopo alla base della query di ricerca dell'utente. Campi dell'oggetto: informational, navigational, commercial, transactional, branded o local. Tutti i campi sono di tipo bool, con valori possibili true o false.
type: object nullable

keyword:
type: string

parent_topic: Argomento principale determina se puoi posizionarti per la parola chiave obiettivo puntando invece a un argomento più generale nella pagina. Per identificare l'Argomento principale, prendiamo la pagina con ranking #1 per la tua parola chiave e troviamo la parola chiave responsabile dell'invio del maggior traffico a quella pagina.
type: string nullable

serp_domain_rating_top10_min: La parola chiave deve avere almeno una posizione in classifica nei primi 10 risultati con un DR fino a questo valore.
type: float nullable

serp_domain_rating_top5_min: La parola chiave deve avere almeno una posizione in classifica nei primi 5 risultati con un DR fino a questo valore.
type: float nullable

serp_features: I risultati arricchiti in una pagina dei risultati del motore di ricerca (SERP) che non sono risultati organici tradizionali.
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: La data in cui abbiamo controllato per l'ultima volta i risultati del motore di ricerca per una parola chiave.
type: datetime nullable

traffic_potential (10 units): La somma del Traffico organico che la pagina con ranking #1 per la parola chiave obiettivo riceve da tutte le parole chiave per cui si posiziona.
type: integer nullable

volume (10 units): Una stima del numero medio mensile di ricerche per una parola chiave negli ultimi 12 mesi di dati disponibili.
type: integer nullable

volume_desktop_pct: La percentuale di ricerche per una parola chiave effettuate su dispositivi desktop.
type: float nullable

volume_mobile_pct: La percentuale di ricerche per una parola chiave effettuate su dispositivi mobili.
type: float nullable

word_count:
type: integer

selectstringObbligatorio

Un elenco di colonne separate da virgole da restituire. Consulta lo schema di risposta per gli identificatori di colonna validi.

countrystringObbligatorio

Un codice paese a due lettere (ISO 3166-1 alpha-2).

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
search_enginestring

[Deprecato il 5 Aug 2024].

Valori consentiti:google
Predefinita:google
keywordsstring

Un elenco di parole chiave separate da virgole per cui mostrare le metriche.

keyword_list_idinteger

L'id di un elenco di parole chiave esistente per cui mostrare le metriche.

match_modestring

Le idee di parole chiave contengono le parole della tua query in qualsiasi ordine (modalità termini) oppure nell'ordine esatto in cui sono scritte (modalità frase).

Valori consentiti:termsphrase
Predefinita:terms
termsstring

Tutte le idee di parole chiave oppure le idee di parole chiave formulate come domande.

Valori consentiti:allquestions
Predefinita:all
outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

keywordsarray<object>
cpcinteger or null

Il Costo per clic mostra il prezzo medio che gli inserzionisti pagano per ogni clic su un annuncio nei risultati di ricerca a pagamento per una parola chiave, in centesimi di dollaro USA.

cpsnumber or null

Clic per ricerca (o CPS) è il rapporto tra i Clic e il Volume di ricerca della parola chiave. Mostra quanti risultati di ricerca diversi ricevono un clic, in media, quando gli utenti cercano la parola chiave obiettivo in un determinato paese.

difficultyinteger or null

(10 unità) Stima di quanto sia difficile posizionarsi tra i primi 10 risultati di ricerca organici per una parola chiave su una scala di 100 punti.

first_seenstring or null

La data in cui abbiamo controllato per la prima volta i risultati del motore di ricerca per una parola chiave.

global_volumeinteger or null

(10 unità) Quante volte al mese, in media, le persone cercano la parola chiave obiettivo in tutti i Paesi del nostro database.

intentsobject or null

(10 unità) Indica l'intento alla base della query di ricerca dell'utente. Campi dell'oggetto: informational, navigational, commercial, transactional, branded o local. Tutti i campi sono di tipo bool, con valori possibili true o false.

keywordstring
parent_topicstring or null

L'Argomento principale determina se puoi posizionare la tua parola chiave target puntando invece a un argomento più generale sulla tua pagina. Per identificare l'Argomento principale, prendiamo la pagina che si posiziona n. 1 per la tua parola chiave e troviamo la parola chiave responsabile dell'invio della maggior parte del traffico a quella pagina.

serp_featuresarray<string>

I risultati di ricerca estesi su una pagina dei risultati di un motore di ricerca (SERP) che non sono risultati organici tradizionali.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping
serp_last_updatestring or null

La data in cui abbiamo controllato per l'ultima volta i risultati del motore di ricerca per una parola chiave.

traffic_potentialinteger or null

(10 unità) La somma del traffico organico che la pagina posizionata n. 1 per la tua parola chiave target riceve da tutte le parole chiave per cui si posiziona.

volumeinteger or null

(10 unità) Una stima del numero medio mensile di ricerche di una parola chiave negli ultimi 12 mesi noti di dati.

volume_desktop_pctnumber or null

La percentuale di ricerche per una parola chiave effettuate su dispositivi desktop.

volume_mobile_pctnumber or null

La percentuale di ricerche per una parola chiave effettuate su dispositivi mobili.

volume_monthlyinteger or null

(10 unità) Una stima del numero di ricerche per una parola chiave nell'ultimo mese. Questo campo potrebbe non essere incluso nel parametro order_by