Panoramica
API + MCPLe richieste a questo endpoint sono gratuite e non consumano alcuna unità API.
Parametri della query
Una durata di timeout manuale in secondi.
Il numero di risultati da restituire.
Un elenco di colonne separate da virgole per ordinare i risultati, con direzione facoltativa. Consulta lo schema di risposta per gli identificatori di colonna validi.
L’espressione del filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).
best_position_has_thumbnail: La posizione migliore (o quella dell’URL target, se impostato) ha una miniatura.
type: boolean nullable
best_position_has_thumbnail_previous: La posizione migliore (o quella dell’URL target, se impostato) aveva una miniatura alla data di confronto.
type: boolean nullable
best_position_has_video_preview: La posizione migliore (o quella dell’URL target, se impostato) ha un’anteprima video.
type: boolean nullable
best_position_has_video_preview_previous: La posizione migliore (o quella dell’URL target, se impostato) aveva un’anteprima video alla data di confronto.
type: boolean nullable
best_position_kind: Il tipo di posizione migliore (o quella dell’URL target, se impostato): organica, a pagamento oppure una funzionalità SERP.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_kind_previous: Il tipo di posizione migliore (o quella dell’URL target, se impostato) alla data di confronto.
type: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
clicks: La metrica Clic si riferisce al numero medio mensile di clic sui risultati di ricerca effettuati dagli utenti quando cercano la keyword target. Alcune ricerche generano clic su più risultati, mentre altre potrebbero non generare alcun clic.
type: integer nullable
clicks_per_search: Clic per ricerca è il rapporto tra Clic e Volume di ricerca della keyword. Mostra quanti risultati di ricerca diversi, in media, ricevono clic quando gli utenti cercano la keyword target in un determinato paese.
type: float nullable
cost_per_click: Costo per clic indica il prezzo medio che gli inserzionisti pagano per ogni clic sugli annunci nei risultati di ricerca a pagamento per una keyword.
type: integer nullable
country: Il paese in cui viene monitorata una determinata keyword. Un codice paese di due lettere (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
country_prev: Il paese in cui veniva monitorata una determinata keyword alla data di confronto. Un codice paese di due lettere (ISO 3166-1 alpha-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
created_at: La data in cui una keyword è stata aggiunta al Progetto.
type: datetime
is_branded: Intento utente: branded. L’utente sta cercando un brand specifico o il nome di un’azienda.
type: boolean
is_commercial: Intento utente: commerciale. L’utente sta confrontando prodotti o servizi prima di decidere un acquisto.
type: boolean
is_informational: Intento utente: informazionale. L’utente cerca informazioni o una risposta a una domanda specifica.
type: boolean
is_local: Intento utente: locale. L’utente cerca informazioni rilevanti per una località specifica o servizi nelle vicinanze.
type: boolean
is_main_position: Esclude le posizioni in AI Overview, Sitelink, Top stories, Image pack, Video, Discussioni e forum e i post su X (Twitter).
type: boolean
is_main_position_prev: Esclude le posizioni in AI Overview, Sitelink, Top stories, Image pack, Video, Discussioni e forum e i post su X (Twitter) alla data di confronto.
type: boolean
is_navigational: Intento utente: navigazionale. L’utente sta cercando un sito web o una pagina web specifici.
type: boolean
is_transactional: Intento utente: transazionale. L’utente è pronto a completare un’azione, spesso un acquisto.
type: boolean
keyword: La keyword per cui si posiziona il tuo target.
type: string
keyword_difficulty: Una stima, su una scala da 100 punti, di quanto sia difficile posizionarsi tra i primi 10 risultati organici per una keyword.
type: integer nullable
keyword_has_data: Restituisce false se la keyword è ancora in elaborazione e non è stata ancora recuperata alcuna SERP.
type: boolean
keyword_is_frozen: Indica se una keyword ha superato il limite di keyword monitorate previsto dal tuo piano. Queste keyword sono "congelate", cioè non vengono aggiornate nelle classifiche.
type: boolean
keyword_prev: La keyword per cui si posizionava il tuo target alla data di confronto.
type: string
keyword_words: Il numero di parole in una keyword.
type: integer
keyword_words_prev: Il numero di parole in una keyword alla data di confronto.
type: integer
language: La lingua della SERP per cui viene monitorata una determinata keyword.
type: string
language_prev: La lingua della SERP alla data di confronto.
type: string
location: La località (paese, stato/provincia o città) in cui viene monitorata una determinata keyword.
type: string
location_prev: La località (paese, stato/provincia o città) in cui veniva monitorata una determinata keyword alla data di confronto.
type: string
parent_topic: Argomento principale determina se puoi posizionarti per la keyword target puntando invece a un argomento più generale nella pagina. Per identificare l’Argomento principale, prendiamo la pagina in posizione #1 per la tua keyword e troviamo la keyword responsabile dell’invio del maggior traffico a quella pagina.
type: string nullable
position: La posizione migliore (o quella dell’URL target, se impostato) nella ricerca organica.
type: integer nullable
position_diff: La variazione della posizione migliore (o quella dell’URL target, se impostato) tra le date selezionate.
type: integer nullable
position_prev: La posizione migliore (o quella dell’URL target, se impostato) alla data di confronto.
type: integer nullable
search_type_image: Il tipo di ricerca Immagini mostra la percentuale di ricerche per una keyword effettuate su immagini, evidenziando l’interesse per i contenuti visivi.
type: float nullable
search_type_news: Il tipo di ricerca News mostra la percentuale di ricerche per una keyword effettuate su articoli di notizie.
type: float nullable
search_type_video: Il tipo di ricerca Video mostra la percentuale di ricerche per una keyword effettuate su video, riflettendo l’interesse per i contenuti video.
type: float nullable
search_type_web: Il tipo di ricerca Web mostra la percentuale di ricerche per una keyword effettuate sul web generale, indicando interesse per un’ampia gamma di informazioni.
type: float nullable
serp_features: Le Funzionalità SERP che compaiono nei risultati di ricerca per una keyword.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_features_prev: Le Funzionalità SERP che compaiono nei risultati di ricerca per una keyword alla data di confronto.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_updated: La data in cui abbiamo controllato l’ultima volta i risultati dei motori di ricerca per una keyword.
type: datetime nullable
serp_updated_prev: La data in cui abbiamo controllato i risultati dei motori di ricerca fino alla data di confronto.
type: datetime nullable
tags: Un elenco di tag assegnati a una determinata keyword.
type: array(string)
tags_prev: Un elenco di tag assegnati a una determinata keyword alla data di confronto.
type: array(string)
target_positions_count: Il numero di URL target che si posizionano per una keyword.
type: integer
traffic: Una stima del numero di visite mensili che una pagina riceve dalla ricerca organica nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
type: integer nullable
traffic_diff: La variazione del traffico tra le date selezionate.
type: integer nullable
traffic_prev: Una stima del numero di visite mensili che una pagina riceve dalla ricerca organica nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
type: integer nullable
url: L’URL in prima posizione (o l’URL target, se impostato) nella ricerca organica.
type: string nullable
url_prev: L’URL in prima posizione (o l’URL target, se impostato) alla data di confronto.
type: string nullable
volume: Una stima del Volume di ricerca medio mensile per una keyword nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
type: integer nullable
volume_desktop_pct: La percentuale del Volume di ricerca totale che proviene da dispositivi desktop.
type: float nullable
volume_mobile_pct: La percentuale del Volume di ricerca totale che proviene da dispositivi mobili.
type: float nullable
Un elenco di colonne separate da virgole da restituire. Consulta lo schema di risposta per gli identificatori di colonna validi.
Una data con cui confrontare le metriche, in formato YYYY-MM-DD.
Una data per il Report delle metriche nel formato YYYY-MM-DD.
Scegli tra classifiche mobile e desktop.
L'identificatore univoco del progetto. Puoi trovarlo nell'URL del tuo progetto Rank Tracker in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#
La modalità di calcolo del Volume di ricerca: mensile o media. Influisce su volume, traffico e Valore del traffico.
Il formato di output.
Risposte
La posizione migliore (o quella dell’URL target, se impostato) ha una miniatura.
La posizione migliore (o quella dell’URL target, se impostato) aveva una miniatura alla data di confronto.
La posizione migliore (o quella dell’URL target, se impostato) ha un’anteprima video.
La posizione migliore (o quella dell’URL target, se impostato) aveva un’anteprima video alla data di confronto.
Il tipo di posizione migliore (o quella dell’URL target, se impostato): organica, a pagamento oppure una funzionalità SERP.
Il tipo di posizione migliore (o di URL target, se impostati) alla data di confronto.
La metrica Clic si riferisce al numero medio mensile di clic sui risultati di ricerca da parte degli utenti che cercano la parola chiave obiettivo. Alcune ricerche generano clic su più di un risultato, mentre altre potrebbero non comportare alcun clic.
Clic per Ricerca è il rapporto tra il numero di 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.
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.
Il Paese in cui viene monitorata una determinata keyword. Un codice Paese di due lettere (ISO 3166-1 alpha-2).
Il Paese in cui viene monitorata una determinata keyword alla data di confronto. Un codice Paese di due lettere (ISO 3166-1 alpha-2).
La data in cui una parola chiave è stata aggiunta al progetto.
Intento dell'utente: specifico del brand. L'utente sta cercando il nome di un marchio o di un'azienda specifica.
Intento dell'utente: commerciale. L'utente confronta prodotti o servizi prima di prendere una decisione di acquisto.
Intento dell'utente: informativo. L'utente sta cercando informazioni o una risposta a una domanda specifica.
Intento dell'utente: locale. L'utente sta cercando informazioni riguardanti una posizione geografica specifica o servizi nelle vicinanze.
Intento dell'utente: di navigazione. L'utente sta cercando un sito o una pagina web specifica.
Intento dell'utente: transazionale. L'utente è pronto a completare un'azione, spesso un acquisto.
La parola chiave per la quale si posiziona il tuo target.
Una stima di quanto sia difficile posizionarsi tra i primi 10 risultati di ricerca organici per una parola chiave, su una scala a 100 punti.
Restituirà false se la keyword è ancora in elaborazione e non è stata ancora recuperata alcuna SERP.
Indica se una keyword ha superato il limite di keyword monitorate previsto dal tuo piano. Queste keyword sono "congelate", cioè non viene aggiornato il loro posizionamento.
La parola chiave per la quale si posiziona il tuo target alla data di confronto.
La lingua della SERP per cui viene monitorata una determinata keyword.
La lingua della SERP alla data di confronto.
La località (Paese, stato/provincia o città) in cui viene monitorata una determinata keyword.
La località (Paese, stato/provincia o città) in cui viene monitorata una determinata keyword alla data di confronto.
L'argomento principale determina se puoi posizionare la tua parola chiave target mentre scegli come target 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.
La posizione più alta (o gli URL target, se impostati) nella ricerca organica.
La variazione della posizione più alta (o degli URL target, se impostati) tra le date selezionate.
La posizione più alta (o gli URL target, se impostati) alla data di confronto.
Tipo di ricerca Immagine mostra la percentuale delle ricerche di una parola chiave effettuate per immagini, ed evidenzia l'interesse per i contenuti visivi.
Tipo di ricerca Notizie mostra la percentuale di ricerche per una parola chiave effettuate per articoli di giornale.
Il tipo di ricerca Video mostra la percentuale di ricerche per una parola chiave effettuate per video, e rispecchia l'interesse per i contenuti video.
Tipo di ricerca Web mostra la percentuale di ricerche per una parola chiave effettuate per contenuti web generali, e indica l'interesse per una vasta gamma di informazioni.
Le funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave.
Le funzionalità SERP che compaiono nei risultati di ricerca per una parola chiave alla data di confronto.
La data in cui abbiamo controllato per l'ultima volta i risultati del motore di ricerca per una parola chiave.
La data in cui abbiamo controllato i risultati del motore di ricerca fino alla data di confronto.
Un elenco di tag assegnati a una determinata parola chiave.
Un elenco di tag assegnati a una determinata parola chiave alla data di confronto.
Il numero di URL target posizionati per una parola chiave.
Una stima del numero di visite mensili che una pagina riceve dalla ricerca organica nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
La variazione del traffico tra le date selezionate.
Una stima del numero di visite mensili che una pagina riceve dalla ricerca organica nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
L’URL con il miglior posizionamento (o l’URL target, se impostato) nella ricerca organica.
L’URL con il miglior posizionamento (o l’URL target, se impostato) alla data di confronto.
Una stima del numero medio mensile di ricerche per una parola chiave nell’ultimo mese o negli ultimi 12 mesi di dati noti, a seconda del parametro "volume_mode".
La percentuale del volume di ricerca totale che proviene da dispositivi desktop.
La percentuale del volume di ricerca totale che proviene da dispositivi mobili.