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 dagli identificatori riconosciuti dal parametro select).

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

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

parent_volume (10 units): Il volume di ricerca dell'argomento principale.
type: integer 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.

volume_monthly_date_tostring

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

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

Il target 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
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.

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

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

parent_volumeinteger or null

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

searches_pct_clicks_organic_and_paidnumber 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 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 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 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

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.