Docs
Cerca nella documentazione...⌘K

Panoramica

API + MCP
GET/v3/keywords-explorer/overview

Il filtro regex ha funzionalità limitate quando viene usato in questa richiesta e la sintassi differisce da quella di altre richieste. Si aspetta un simbolo asterisco (*) come carattere jolly.

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 da quelli riconosciuti dal parametro select).

selectstringObbligatorio

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

volume_monthly_date_tostring (date)

La data di fine in formato YYYY-MM-DD per recuperare i volumi di ricerca mensili storici nel campo volume_monthly_history. Richiesta solo se viene richiesto volume_monthly_history.

volume_monthly_date_fromstring (date)

La data di inizio in formato YYYY-MM-DD per recuperare i volumi di ricerca mensili storici nel campo volume_monthly_history. Richiesta solo se viene richiesto volume_monthly_history.

target_modestring

L'ambito dell'URL di destinazione specificato.

Valori consentiti:exactprefixdomainsubdomains
targetstring (url)

L’oggetto della ricerca: un dominio o un URL.

target_positionstring

Filtra le parole chiave in base alla posizione in classifica del target specificato.

Valori consentiti:in_top10in_top100
countrystringObbligatorio

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

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
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.

outputstring

Il formato di output.

Valori consentiti:jsonphpxml

Risposte

keywordsarray<object>
clicksinteger or null

Il numero medio mensile di clic sui risultati di ricerca che le persone effettuano mentre cercano la parola chiave obiettivo.

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 (float) 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 (date-time) 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.

parent_volumeinteger or null

(10 unità) Il volume di ricerca dell'Argomento principale.

searches_pct_clicks_organic_and_paidnumber (float) or null

La percentuale media mensile di persone che, cercando la parola chiave target, hanno fatto clic sia sui risultati organici sia su quelli a pagamento.

searches_pct_clicks_organic_onlynumber (float) or null

La percentuale media mensile di persone che, cercando la parola chiave target, hanno fatto clic solo sui risultati organici.

searches_pct_clicks_paid_onlynumber (float) or null

La percentuale media mensile di persone che, cercando la parola chiave target, hanno fatto clic solo sui risultati a pagamento.

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 (date-time) 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 (float) or null

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

volume_mobile_pctnumber (float) 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

volume_monthly_historyarray<object>

(2 unità per mese storico, con un minimo di 50 unità) Stime storiche mensili del Volume di ricerca di una parola chiave per il periodo impostato dai parametri volume_monthly_date_from e volume_monthly_date_to.