v0.2.0-beta

OpenAPI 3.1.0

Keyword correlate

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operazioni

post/v1/beta/dataforseo/dataforseo_labs/google/related_keywords/live

Keyword correlate

Percorre il grafo 'searches related to' di Google a partire da una keyword, livello per livello. Paginazione con limit, offset e offset_token; usa il token oltre le prime pagine. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Diverso da entrambi gli endpoint delle idee: segue ciò che Google stessa collega, invece di un modello semantico o di una corrispondenza di sottostringa.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.0156.
Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo

application/json

Tipo: array (object | null)[]
- depth
  Tipo: integer | null
  
  profondità di ricerca delle keyword
  campo facoltativo
  valore predefinito: 1
  
  il numero di risultati restituiti dipende dal valore impostato in questo campo
  è possibile specificare un livello da 0 a 4
  numero stimato di keyword per ogni livello (massimo):
  0 – la keyword impostata nel campo keyword
  1 – 8 keyword
  2 – 72 keyword
  3 – 584 keyword
  4 – 4680 keyword
- filters
  Tipo: array (object | null)[] | null
  
  array di parametri per il filtraggio dei risultati
  campo facoltativo
  è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
  tra le condizioni è necessario impostare un operatore logico and, or
  sono supportati i seguenti operatori:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  con l'operatore % è possibile usare like e not_like, nonché ilike e not_ilike per trovare qualsiasi stringa di zero o più caratteri
  esempio:
  ["keyword_data.keyword_info.search_volume",">",0]
  
  [["keyword_info.search_volume","in",[0,1000]], "and", ["keyword_data.keyword_info.competition_level","=","LOW"]]
  
  [["keyword_data.keyword_info.search_volume",">",100], "and", [["keyword_data.keyword_info.cpc","<",0.5], "or",
  
  ["keyword_info.high_top_of_page_bid","<=",0.5]]]
  per ulteriori informazioni sui filtri, fare riferimento a Dataforseo Labs - Filters o a questa guida del Help Center
  
  Oggetto vuoto
- ignore_synonyms
  Tipo: boolean | null
- include_clickstream_data
  Tipo: boolean | null
- include_seed_keyword
  Tipo: boolean | null
  
  includi i dati per la keyword seed
  campo facoltativo
  se impostato su true, i dati della keyword seed specificata nel campo keyword vengono forniti nell'array seed_keyword_data della risposta
  valore predefinito: false
- include_serp_info
  Tipo: boolean | null
  
  includi i dati della SERP per ogni keyword
  campo facoltativo
  se impostato su true, restituiamo un array serp_info contenente i dati SERP (numero di risultati di ricerca, URL pertinente e funzionalità SERP) per ogni keyword nella risposta
  valore predefinito: false
- keyword
  Tipo: string
  
  keyword
  campo obbligatorio
  codifica UTF-8
  le keyword vengono convertite in minuscolo;
  
  scopri di più su regole e limiti dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center
- language_code
  Tipo: string | null
  
  codice della lingua
  campo obbligatorio se non si specifica language_name
  Nota: è necessario specificare language_name oppure language_code
  l'elenco delle località disponibili con language_code si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  esempio:
  en
- language_name
  Tipo: string
  
  nome completo della lingua
  campo obbligatorio se non si specifica language_code
  Nota: è necessario specificare language_name oppure language_code
  l'elenco delle località disponibili con language_name si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  esempio:
  English
- limit
  Tipo: integer | null
  
  numero massimo di keyword restituite
  campo facoltativo
  valore predefinito: 100
  valore massimo: 1000
- location_code
  Tipo: integer
  
  codice della località
  campo obbligatorio se non si specifica location_name
  Nota: è necessario specificare location_name oppure location_code
  l'elenco delle località disponibili con location_code si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  esempio:
  2840
- location_name
  Tipo: string
  
  nome completo della località
  campo obbligatorio se non si specifica location_code
  Nota: è necessario specificare location_name oppure location_code
  l'elenco delle località disponibili con location_name si ottiene con una richiesta separata a
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  esempio:
  United Kingdom
- offset
  Tipo: integer | null
  
  offset nell'array dei risultati delle keyword restituite
  campo facoltativo
  valore predefinito: 0
  se si specifica il valore 10, le prime dieci keyword nell'array dei risultati vengono saltate e i dati vengono forniti per le keyword successive
- order_by
  Tipo: array string[] | null
  
  regole di ordinamento dei risultati
  campo facoltativo
  è possibile usare gli stessi valori dell'array filters per ordinare i risultati
  tipi di ordinamento possibili:
  asc – i risultati vengono ordinati in ordine crescente
  desc – i risultati vengono ordinati in ordine decrescente
  il tipo di ordinamento si specifica con una virgola
  esempio:
  ["keyword_data.keyword_info.competition,desc"]
  regola predefinita:
  ["keyword_data.keyword_info.search_volume,desc"]
  Nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
  per separare più regole di ordinamento usare una virgola
  esempio:
  ["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"]
- replace_with_core_keyword
  Tipo: boolean | null
  
  restituisci i dati per la keyword principale
  campo facoltativo
  se true, serp_info e related_keywords vengono restituiti per la keyword principale del gruppo a cui appartiene la keyword specificata;
  se false, serp_info e related_keywords vengono restituiti per la keyword specificata (se disponibili);
  fare riferimento a questo articolo del Help Center per maggiori dettagli;
  valore predefinito: false
- tag
  Tipo: string | null
  
  identificatore dell'attività definito dall'utente
  campo facoltativo
  il limite di caratteri è 255
  puoi usare questo parametro per identificare l'attività e associarla al risultato
  il valore tag specificato si trova nell'oggetto data della risposta

Risposte

200
Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelatedKeywordsLiveResponseInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

status_code
Tipo: integer | null

codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

tasks
Tipo: array (object | null)[] | null

array di attività

Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelatedKeywordsLiveTaskInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

data
Tipo: object | null

Contiene gli stessi parametri specificati nella richiesta POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

path
Tipo: array (string | null)[] | null

Percorso URL

result
Tipo: array (object | null)[] | null

array di risultati

items
Tipo: array (object | null)[] | null

contiene keyword e dati correlati

depth
Tipo: integer | null

profondità di ricerca delle keyword

keyword_data
Tipo: object | null · Response36Afe1097B20_KeywordDataInfo

dati delle keyword per la keyword restituita

avg_backlinks_info
Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo
backlinks
Tipo: number | null

numero medio di backlink

dofollow
Tipo: number | null

numero medio di link dofollow

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

main_domain_rank
Tipo: number | null

posizione media del dominio principale
scopri di più sulla metrica e sulla sua formula di calcolo in questo articolo del centro assistenza

rank
Tipo: number | null

rank medio
scopri di più su questa metrica e sulla sua formula di calcolo in questo articolo del Help Center

referring_domains
Tipo: number | null

numero medio di domini di riferimento

referring_main_domains
Tipo: number | null

numero medio di domini principali di riferimento

referring_pages
Tipo: number | null

numero medio di pagine di riferimento

se_type
Tipo: string | null

tipo di motore di ricerca

clickstream_keyword_info
Tipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

dati clickstream per la keyword restituita
per recuperare i risultati per questo campo, il parametro include_clickstream_data deve essere impostato su true

age_distribution
Tipo: object | null

distribuzione delle metriche basate su clickstream per età
scopri di più su come viene calcolata questa metrica in questo articolo del Help Center

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

gender_distribution
Tipo: object | null

distribuzione delle metriche stimate basate su clickstream per sesso
scopri di più su come viene calcolata questa metrica in questo articolo del Help Center

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

monthly_searches
Tipo: array (object | null)[] | null

ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

search_volume
Tipo: integer | null Formato: int64

volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com

keyword
Tipo: string | null

idea di keyword restituita

keyword_info
Tipo: object | null · Response36Afe1097B20_KeywordInfo

dati della keyword per l'idea di keyword restituita

categories
Tipo: array integer[] | null

categorie di prodotti e servizi
puoi scaricare l'elenco completo delle categorie possibili

competition
Tipo: number | null

concorrenza
indica l'intensità relativa della concorrenza per la keyword in questione. Il valore si basa sui dati di Google Ads e può essere compreso tra 0 e 1 (inclusi)

competition_level
Tipo: string | null

livello di concorrenza
indica il livello relativo di concorrenza per la keyword in questione, esclusivamente nella SERP a pagamento;
valori possibili: LOW, MEDIUM, HIGH
se il livello di concorrenza non è noto, il valore è null;
scopri di più sulla metrica in questo articolo dell'Help Center

cpc
Tipo: number | null

costo per clic
indica il costo medio per clic (USD) storicamente pagato per la keyword

high_top_of_page_bid
Tipo: number | null

offerta massima per mostrare l'annuncio in cima alla prima pagina
indica il valore che supera di circa l'80% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
il valore può variare in base alla località specificata in una richiesta POST

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

low_top_of_page_bid
Tipo: number | null

offerta minima per mostrare l'annuncio in cima alla prima pagina
indica il valore che supera di circa il 20% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
il valore può variare in base alla località specificata in una richiesta POST

monthly_searches
Tipo: array (object | null)[] | null

ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

se_type
Tipo: string | null

tipo di motore di ricerca

search_volume
Tipo: integer | null Formato: int64

volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com

search_volume_trend
Tipo: object | null · Response36Afe1097B20_SearchVolumeTrend

variazioni della tendenza di ricerca
indica la variazione percentuale del volume di ricerca rispetto al periodo precedente

monthly
Tipo: integer | null

variazione percentuale del volume di ricerca rispetto al mese precedente

quarterly
Tipo: integer | null

variazione percentuale del volume di ricerca rispetto al trimestre precedente

yearly
Tipo: integer | null

variazione percentuale del volume di ricerca rispetto all'anno precedente

keyword_info_normalized_with_bing
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene il volume di ricerca della keyword normalizzato sul volume di ricerca Bing

is_normalized
Tipo: boolean | null

i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing

last_updated_time
Tipo: string | null

data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00

monthly_searches
Tipo: array (object | null)[] | null

tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

search_volume
Tipo: integer | null

tasso attuale di volume di ricerca di una keyword

keyword_info_normalized_with_clickstream
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene il volume di ricerca della keyword normalizzato sui dati clickstream

is_normalized
Tipo: boolean | null

i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing

last_updated_time
Tipo: string | null

data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00

monthly_searches
Tipo: array (object | null)[] | null

tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

search_volume
Tipo: integer | null

tasso attuale di volume di ricerca di una keyword

keyword_properties
Tipo: object | null · Response36Afe1097B20_KeywordProperties

informazioni aggiuntive sulla keyword

core_keyword
Tipo: string | null

keyword principale in un gruppo
contiene la keyword principale in un gruppo determinata dall'algoritmo di clustering dei sinonimi
se il valore è null, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi di keyword

detected_language
Tipo: string | null

lingua rilevata della keyword
indica la lingua della keyword identificata dal nostro sistema

is_another_language
Tipo: boolean | null

la lingua rilevata della keyword differisce dalla lingua impostata
se il valore è true, la lingua specificata nella richiesta non corrisponde a quella determinata dal nostro sistema per una keyword

keyword_difficulty
Tipo: integer | null

difficoltà di posizionamento nei primi 10 risultati organici per una keyword
indica la probabilità di entrare nei primi 10 risultati organici per una keyword, su una scala logaritmica da 0 a 100;
calcolata, tra l'altro, analizzando i profili di link delle prime 10 pagine nella SERP;
scopri di più sulla metrica in questa guida dell'Help Center

se_type
Tipo: string | null

tipo di motore di ricerca

synonym_clustering_algorithm
Tipo: string | null

l'algoritmo utilizzato per identificare i sinonimi
valori possibili:
keyword_metrics - indica l'algoritmo basato sui parametri di keyword_info
text_processing - indica l'algoritmo basato sul testo
se il valore è null, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi di keyword

words_count
Tipo: integer | null Formato: int64

numero di parole nella keyword
indica da quante parole è composta la keyword

language_code
Tipo: string | null

codice lingua in un array POST

location_code
Tipo: integer | null

codice posizione in un array POST

se_type
Tipo: string | null

tipo di motore di ricerca

search_intent_info
Tipo: object | null · Response36Afe1097B20_SearchIntentInfo
foreign_intent
Tipo: array (string | null)[] | null

intenti di ricerca supplementari
valori possibili: informational, navigational, commercial, transactional

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

main_intent
Tipo: string | null

intento di ricerca principale
valori possibili: informational, navigational, commercial, transactional

se_type
Tipo: string | null

tipo di motore di ricerca

serp_info
Tipo: object | null · Response36Afe1097B20_SerpInfo

dati SERP
il valore sarà null se non hai impostato il campo include_serp_info su true nell'array POST o se non ci sono dati SERP per questa keyword nel nostro database

check_url
Tipo: string | null

URL diretto ai risultati del motore di ricerca
puoi usarlo per verificare che abbiamo fornito risultati accurati

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

previous_updated_time
Tipo: string | null

data e ora precedenti all'ultimo aggiornamento dei dati SERP
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-10-15 12:57:46 +00:00

se_results_count
Tipo: integer | null Formato: int64

numero di risultati di ricerca per la keyword restituita

se_type
Tipo: string | null

tipo di motore di ricerca

serp_item_types
Tipo: array (string | null)[] | null

tipi di risultati di ricerca nella SERP
contiene i tipi di risultati di ricerca (items) trovati nella SERP
tipi di elemento possibili:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
Nota: i risultati effettivi verranno restituiti solo per gli elementi organic, paid, featured_snippet e local_pack

related_keywords
Tipo: array (string | null)[] | null

elenco di keyword correlate
rappresenta l'elenco delle query di ricerca correlate alla keyword restituita nell'array sopra

se_type
Tipo: string | null

tipo di motore di ricerca

items_count
Tipo: integer | null Formato: int64

il numero di risultati restituiti nell'array items

language_code
Tipo: string | null

codice lingua in un array POST

location_code
Tipo: integer | null

codice posizione in un array POST

se_type
Tipo: string | null

tipo di motore di ricerca

seed_keyword
Tipo: string | null

keyword in un array POST

seed_keyword_data
Tipo: object | null · Response36Afe1097B20_KeywordDataInfo

dati delle keyword per la keyword di partenza
i campi dell'array sono identici a quelli di keyword_data

avg_backlinks_info
Tipo: object | null · Response36Afe1097B20_AvgBacklinksInfo

dati sui backlink per la keyword restituita
questo oggetto fornisce il numero medio di backlink, pagine e domini di riferimento, nonché i valori di ranking medi tra le prime 10 pagine web posizionate organicamente per la keyword

backlinks
Tipo: number | null

numero medio di backlink

dofollow
Tipo: number | null

numero medio di link dofollow

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

main_domain_rank
Tipo: number | null

posizione media del dominio principale
scopri di più sulla metrica e sulla sua formula di calcolo in questo articolo del centro assistenza

rank
Tipo: number | null

rank medio
scopri di più su questa metrica e sulla sua formula di calcolo in questo articolo del Help Center

referring_domains
Tipo: number | null

numero medio di domini di riferimento

referring_main_domains
Tipo: number | null

numero medio di domini principali di riferimento

referring_pages
Tipo: number | null

numero medio di pagine di riferimento

se_type
Tipo: string | null

tipo di motore di ricerca

clickstream_keyword_info
Tipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

dati clickstream per la keyword restituita
per recuperare i risultati per questo campo, il parametro include_clickstream_data deve essere impostato su true

age_distribution
Tipo: object | null

distribuzione delle metriche basate su clickstream per età
scopri di più su come viene calcolata questa metrica in questo articolo del Help Center

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

gender_distribution
Tipo: object | null

distribuzione delle metriche stimate basate su clickstream per sesso
scopri di più su come viene calcolata questa metrica in questo articolo del Help Center

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

monthly_searches
Tipo: array (object | null)[] | null

ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

search_volume
Tipo: integer | null Formato: int64

volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com

keyword
Tipo: string | null

idea di keyword restituita

keyword_info
Tipo: object | null · Response36Afe1097B20_KeywordInfo

dati della keyword per l'idea di keyword restituita

categories
Tipo: array integer[] | null

categorie di prodotti e servizi
puoi scaricare l'elenco completo delle categorie possibili

competition
Tipo: number | null

concorrenza
indica l'intensità relativa della concorrenza per la keyword in questione. Il valore si basa sui dati di Google Ads e può essere compreso tra 0 e 1 (inclusi)

competition_level
Tipo: string | null

livello di concorrenza
indica il livello relativo di concorrenza per la keyword in questione, esclusivamente nella SERP a pagamento;
valori possibili: LOW, MEDIUM, HIGH
se il livello di concorrenza non è noto, il valore è null;
scopri di più sulla metrica in questo articolo dell'Help Center

cpc
Tipo: number | null

costo per clic
indica il costo medio per clic (USD) storicamente pagato per la keyword

high_top_of_page_bid
Tipo: number | null

offerta massima per mostrare l'annuncio in cima alla prima pagina
indica il valore che supera di circa l'80% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
il valore può variare in base alla località specificata in una richiesta POST

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

low_top_of_page_bid
Tipo: number | null

offerta minima per mostrare l'annuncio in cima alla prima pagina
indica il valore che supera di circa il 20% le offerte più basse per cui sono stati mostrati gli annunci (sulla base delle statistiche di Google Ads per gli inserzionisti)
il valore può variare in base alla località specificata in una richiesta POST

monthly_searches
Tipo: array (object | null)[] | null

ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

se_type
Tipo: string | null

tipo di motore di ricerca

search_volume
Tipo: integer | null Formato: int64

volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com

search_volume_trend
Tipo: object | null · Response36Afe1097B20_SearchVolumeTrend

variazioni della tendenza di ricerca
indica la variazione percentuale del volume di ricerca rispetto al periodo precedente

monthly
Tipo: integer | null

variazione percentuale del volume di ricerca rispetto al mese precedente

quarterly
Tipo: integer | null

variazione percentuale del volume di ricerca rispetto al trimestre precedente

yearly
Tipo: integer | null

variazione percentuale del volume di ricerca rispetto all'anno precedente

keyword_info_normalized_with_bing
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene il volume di ricerca della keyword normalizzato sul volume di ricerca Bing

is_normalized
Tipo: boolean | null

i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing

last_updated_time
Tipo: string | null

data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00

monthly_searches
Tipo: array (object | null)[] | null

tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

search_volume
Tipo: integer | null

tasso attuale di volume di ricerca di una keyword

keyword_info_normalized_with_clickstream
Tipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

contiene il volume di ricerca della keyword normalizzato sui dati clickstream

is_normalized
Tipo: boolean | null

i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing

last_updated_time
Tipo: string | null

data e ora in cui il set di dati è stato aggiornato nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00

monthly_searches
Tipo: array (object | null)[] | null

tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno

month
Tipo: integer | null

Mese

search_volume
Tipo: integer | null

tasso medio mensile di volume di ricerca

year
Tipo: integer | null

Anno

search_volume
Tipo: integer | null

tasso attuale di volume di ricerca di una keyword

keyword_properties
Tipo: object | null · Response36Afe1097B20_KeywordProperties

informazioni aggiuntive sulla keyword

core_keyword
Tipo: string | null

keyword principale in un gruppo
contiene la keyword principale in un gruppo determinata dall'algoritmo di clustering dei sinonimi
se il valore è null, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi di keyword

detected_language
Tipo: string | null

lingua rilevata della keyword
indica la lingua della keyword identificata dal nostro sistema

is_another_language
Tipo: boolean | null

la lingua rilevata della keyword differisce dalla lingua impostata
se il valore è true, la lingua specificata nella richiesta non corrisponde a quella determinata dal nostro sistema per una keyword

keyword_difficulty
Tipo: integer | null

difficoltà di posizionamento nei primi 10 risultati organici per una keyword
indica la probabilità di entrare nei primi 10 risultati organici per una keyword, su una scala logaritmica da 0 a 100;
calcolata, tra l'altro, analizzando i profili di link delle prime 10 pagine nella SERP;
scopri di più sulla metrica in questa guida dell'Help Center

se_type
Tipo: string | null

tipo di motore di ricerca

synonym_clustering_algorithm
Tipo: string | null

l'algoritmo utilizzato per identificare i sinonimi
valori possibili:
keyword_metrics - indica l'algoritmo basato sui parametri di keyword_info
text_processing - indica l'algoritmo basato sul testo
se il valore è null, il nostro database non contiene keyword che l'algoritmo in questione è riuscito a identificare come sinonimi di keyword

words_count
Tipo: integer | null Formato: int64

numero di parole nella keyword
indica da quante parole è composta la keyword

language_code
Tipo: string | null

codice lingua in un array POST

location_code
Tipo: integer | null

codice posizione in un array POST

se_type
Tipo: string | null

tipo di motore di ricerca

search_intent_info
Tipo: object | null · Response36Afe1097B20_SearchIntentInfo

informazioni sull'intento di ricerca per la keyword restituita
scopri di più sull'intento di ricerca in questo articolo del centro assistenza

foreign_intent
Tipo: array (string | null)[] | null

intenti di ricerca supplementari
valori possibili: informational, navigational, commercial, transactional

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

main_intent
Tipo: string | null

intento di ricerca principale
valori possibili: informational, navigational, commercial, transactional

se_type
Tipo: string | null

tipo di motore di ricerca

serp_info
Tipo: object | null · Response36Afe1097B20_SerpInfo

dati SERP
il valore sarà null se non hai impostato il campo include_serp_info su true nell'array POST o se non ci sono dati SERP per questa keyword nel nostro database

check_url
Tipo: string | null

URL diretto ai risultati del motore di ricerca
puoi usarlo per verificare che abbiamo fornito risultati accurati

last_updated_time
Tipo: string | null

data e ora di aggiornamento dei dati delle keyword
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

previous_updated_time
Tipo: string | null

data e ora precedenti all'ultimo aggiornamento dei dati SERP
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-10-15 12:57:46 +00:00

se_results_count
Tipo: integer | null Formato: int64

numero di risultati di ricerca per la keyword restituita

se_type
Tipo: string | null

tipo di motore di ricerca

serp_item_types
Tipo: array (string | null)[] | null

tipi di risultati di ricerca nella SERP
contiene i tipi di risultati di ricerca (items) trovati nella SERP
tipi di elemento possibili:
answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
Nota: i risultati effettivi verranno restituiti solo per gli elementi organic, paid, featured_snippet e local_pack

total_count
Tipo: integer | null Formato: int64

quantità totale di risultati nel nostro database pertinenti alla tua richiesta

result_count
Tipo: integer | null Formato: int64

Numero di elementi nell'array dei risultati

status_code
Tipo: integer | null

codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

time
Tipo: string | null

Tempo di esecuzione in secondi

tasks_count
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks

tasks_error
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks restituite con un errore

time
Tipo: string | null

tempo di esecuzione totale, secondi

version
Tipo: string | null

La versione corrente dell'API
application/json
400

Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
401

È richiesta una chiave API Felo valida.
402

Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
403

L'account non è autorizzato a eseguire questa operazione.
429

È stato raggiunto un limite di richieste o di spesa.
502

Il servizio non è riuscito a completare la richiesta.
503

L'API o il servizio di fatturazione è temporaneamente non disponibile.
504

Si è verificato un timeout durante l'elaborazione della richiesta.
default

Risposta di errore; le risposte passthrough upstream possono usare formati del provider

application/json

post/v1/beta/dataforseo/dataforseo_labs/google/related_keywords/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/related_keywords/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "phone",
    "language_name": "English",
    "location_code": 2840,
    "limit": 3
  }
]'

Mostra schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "se_type": null,
          "seed_keyword": null,
          "seed_keyword_data": {
            "se_type": null,
            "keyword": null,
            "location_code": null,
            "language_code": null,
            "keyword_info": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
            "clickstream_keyword_info": "[Max Depth Exceeded]",
            "keyword_properties": "[Max Depth Exceeded]",
            "serp_info": "[Max Depth Exceeded]",
            "avg_backlinks_info": "[Max Depth Exceeded]",
            "search_intent_info": "[Max Depth Exceeded]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "avg_backlinks_info": "[Max Depth Exceeded]",
                "search_intent_info": "[Max Depth Exceeded]"
              },
              "depth": null,
              "related_keywords": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Keyword correlate

AutenticazioneRequired

DataForSEO

Keyword correlate

Riferimento prezzi