DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Ricerche principali
Le keyword con il volume più alto in una località, senza filtro su seed o sito. 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. È l'estremità di scoperta della famiglia: usalo quando non c'è ancora una keyword seed, poi restringi con post_dataforseo_labs_google_keyword_ideas_live.
Riferimento prezzi
- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.1356.
- 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.
- Tipo: array (object | null)[]
- filtersTipo: 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 logicoand,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 usarelikeenot_like,ilikeenot_ilikeper trovare qualsiasi stringa di zero o più caratteri
esempio:["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["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 CenterOggetto vuoto - ignoreTipo: boolean | null
_synonyms ignora keyword molto simili
campo facoltativo
se impostato sutruevengono restituite solo le keyword principali, tutte le keyword molto simili vengono escluse;
valore predefinito:false - includeTipo: boolean | null
_clickstream _data includi o escludi i dati delle metriche basate su clickstream nel risultato
campo facoltativo
se il parametro è impostato sutrue, nella risposta si ricevono i campiclickstream_keyword_info,keyword_info_normalized_with_clickstreamekeyword_info_normalized_with_bing
valore predefinito:false
con questo parametro abilitato viene addebitato il doppio del prezzo per la richiestascopri di più su come vengono calcolate le metriche basate su clickstream in questo articolo del Help Center
- includeTipo: boolean | null
_serp _info includi i dati della SERP per ogni keyword
campo facoltativo
se impostato sutrue, restituiamo un arrayserp_infocontenente i dati SERP (numero di risultati di ricerca, URL pertinente e funzionalità SERP) per ogni keyword nella risposta
valore predefinito:false - languageTipo: string | null
_code codice della lingua
campo obbligatorio se non si specificalanguage_name
Nota: è necessario specificarelanguage_nameoppurelanguage_code
l'elenco delle località disponibili conlanguage_codesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:en - languageTipo: string
_name nome completo della lingua
campo obbligatorio se non si specificalanguage_code
Nota: è necessario specificarelanguage_nameoppurelanguage_code
l'elenco delle località disponibili conlanguage_namesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:English - limitTipo: integer | null
numero massimo di keyword restituite
campo facoltativo
Nota: è possibile ottenere più di 1000 risultati usando il codiceoffset_tokenfornito nella risposta a ogni richiesta successiva
valore predefinito:1000
valore massimo:1000 - locationTipo: integer
_code codice della località
campo obbligatorio se non si specificalocation_name
Nota: è necessario specificarelocation_nameoppurelocation_code
l'elenco delle località disponibili conlocation_codesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:2840 - locationTipo: string
_name nome completo della località
campo obbligatorio se non si specificalocation_code
Nota: è necessario specificarelocation_nameoppurelocation_code
l'elenco delle località disponibili conlocation_namesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
esempio:United Kingdom - offsetTipo: integer | null
offset nell'array dei risultati delle keyword restituite
campo facoltativo
valore predefinito:0
se si specifica il valore10, le prime dieci keyword nell'array dei risultati vengono omesse e i dati vengono forniti per le keyword successive
Nota: si consiglia di usare questo parametro solo quando si recuperano fino a 10.000 risultati
per recuperare più di 10.000 risultati, usare inveceoffset_token. - offsetTipo: string | null
_token token di offset per le richieste successive
campo facoltativo
fornito nell'identico campo della risposta a ogni richiesta;
usare questo parametro per evitare timeout durante il recupero di oltre 10.000 risultati in un'unica richiesta;
specificando il valore univocooffset_tokendall'array della risposta, si ottengono i risultati successivi dell'attività iniziale;
i valori dioffset_tokensono univoci per ogni attività successiva
Nota: seoffset_tokenè specificato nella richiesta, tutti gli altri parametri trannelimitnon vengono considerati durante l'elaborazione di un'attività.
scopri di più su questo parametro nel nostro Help Center - orderTipo: array string[] | null
_by regole di ordinamento dei risultati
campo facoltativo
è possibile usare gli stessi valori dell'arrayfiltersper ordinare i risultati
tipi di ordinamento possibili:asc– i risultati vengono ordinati in ordine crescentedesc– i risultati vengono ordinati in ordine decrescente
il tipo di ordinamento si specifica con una virgola
esempio:["keyword_info.competition,desc"]
regola predefinita:["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_info.search_volume,desc","keyword_info.cpc,desc"] - tagTipo: 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 valoretagspecificato si trova nell'oggettodatadella risposta
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResponseInfo200
- Tipo: number | null Formato: doublecost
Costo totale delle attività, USD
- Tipo: integer | nullstatus
_code codice di stato generale l'elenco completo dei codici di risposta è disponibile qui
- Tipo: string | nullstatus
_message messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui
- Tipo: array (object | null)[] | nulltasks
array di attività
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveTaskInfo
- costTipo: number | null Formato: double
Costo totale delle attività, USD
- dataTipo: object | null
Contiene gli stessi parametri specificati nella richiesta POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID
- pathTipo: array (string | null)[] | null
Percorso URL
- resultTipo: array (object | null)[] | null
array di risultati
- itemsTipo: array (object | null)[] | null
contiene keyword e dati correlati
- avgTipo: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info 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- backlinksTipo: number | null
numero medio di backlink
- dofollowTipo: number | null
numero medio di link dofollow
- lastTipo: string | null
_updated _time 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 - mainTipo: number | null
_domain _rank - rankTipo: number | null
- referringTipo: number | null
_domains numero medio di domini di riferimento
- referringTipo: number | null
_main _domains numero medio di domini principali di riferimento
- referringTipo: number | null
_pages numero medio di pagine di riferimento
- seTipo: string | null
_type tipo di motore di ricerca
- clickstreamTipo: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info dati clickstream per la keyword restituita
per recuperare i risultati per questo campo, il parametroinclude_clickstream_datadeve essere impostato sutrue- ageTipo: object | null
_distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- genderTipo: object | null
_distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- lastTipo: string | null
_updated _time 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 - monthlyTipo: array (object | null)[] | null
_searches ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- searchTipo: integer | null Formato: int64
_volume volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com
- keywordTipo: string | null
idea di keyword restituita
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfo
_info dati della keyword per l'idea di keyword restituita
- categoriesTipo: array integer[] | null
- competitionTipo: 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) - competitionTipo: string | null
_level - cpcTipo: number | null
costo per clic
indica il costo medio per clic (USD) storicamente pagato per la keyword - highTipo: number | null
_top _of _page _bid 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 - lastTipo: string | null
_updated _time 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 - lowTipo: number | null
_top _of _page _bid 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 - monthlyTipo: array (object | null)[] | null
_searches ricerche mensili
rappresenta il numero (approssimativo) di ricerche su questa idea di keyword (disponibile per gli ultimi dodici mesi), indirizzate alle località geografiche specificate- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- seTipo: string | null
_type tipo di motore di ricerca
- searchTipo: integer | null Formato: int64
_volume volume di ricerca medio mensile
rappresenta il numero (approssimativo) di ricerche per la data idea di keyword su google.com - searchTipo: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend variazioni della tendenza di ricerca
indica la variazione percentuale del volume di ricerca rispetto al periodo precedente- monthlyTipo: integer | null
variazione percentuale del volume di ricerca rispetto al mese precedente
- quarterlyTipo: integer | null
variazione percentuale del volume di ricerca rispetto al trimestre precedente
- yearlyTipo: integer | null
variazione percentuale del volume di ricerca rispetto all'anno precedente
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing contiene il volume di ricerca della keyword normalizzato sul volume di ricerca Bing
- isTipo: boolean | null
_normalized i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing
- lastTipo: string | null
_updated _time 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
- monthlyTipo: array (object | null)[] | null
_searches tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno
- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- searchTipo: integer | null
_volume tasso attuale di volume di ricerca di una keyword
- keywordTipo: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream contiene il volume di ricerca della keyword normalizzato sui dati clickstream
- isTipo: boolean | null
_normalized i dati delle keyword sono normalizzati se true, i valori vengono normalizzati con i dati di Bing
- lastTipo: string | null
_updated _time 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
- monthlyTipo: array (object | null)[] | null
_searches tassi mensili di volume di ricerca array di oggetti contenenti i tassi di volume di ricerca in un determinato mese di un anno
- monthTipo: integer | null
Mese
- searchTipo: integer | null
_volume tasso medio mensile di volume di ricerca
- yearTipo: integer | null
Anno
- searchTipo: integer | null
_volume tasso attuale di volume di ricerca di una keyword
- keywordTipo: object | null · Response36Afe1097B20_KeywordProperties
_properties informazioni aggiuntive sulla keyword
- coreTipo: string | null
_keyword 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 dikeyword - detectedTipo: string | null
_language lingua rilevata della keyword
indica la lingua della keyword identificata dal nostro sistema - isTipo: boolean | null
_another _language 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 - keywordTipo: integer | null
_difficulty 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 - seTipo: string | null
_type tipo di motore di ricerca
- synonymTipo: string | null
_clustering _algorithm l'algoritmo utilizzato per identificare i sinonimi
valori possibili:keyword_metrics- indica l'algoritmo basato sui parametri dikeyword_infotext_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 dikeyword - wordsTipo: integer | null Formato: int64
_count numero di parole nella keyword
indica da quante parole è composta la keyword
- languageTipo: string | null
_code codice lingua in un array POST
- locationTipo: integer | null
_code codice posizione in un array POST
- seTipo: string | null
_type tipo di motore di ricerca
- searchTipo: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignTipo: array (string | null)[] | null
_intent intenti di ricerca supplementari
valori possibili:informational,navigational,commercial,transactional - lastTipo: string | null
_updated _time 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 - mainTipo: string | null
_intent intento di ricerca principale
valori possibili:informational,navigational,commercial,transactional - seTipo: string | null
_type tipo di motore di ricerca
- serpTipo: object | null · Response36Afe1097B20_SerpInfo
_info dati SERP
il valore sarànullse non hai impostato il campoinclude_serp_infosutruenell'array POST o se non ci sono dati SERP per questa keyword nel nostro database- checkTipo: string | null
_url URL diretto ai risultati del motore di ricerca
puoi usarlo per verificare che abbiamo fornito risultati accurati - lastTipo: string | null
_updated _time 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 - previousTipo: string | null
_updated _time 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 - seTipo: integer | null Formato: int64
_results _count numero di risultati di ricerca per la keyword restituita
- seTipo: string | null
_type tipo di motore di ricerca
- serpTipo: array (string | null)[] | null
_item _types 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 elementiorganic,paid,featured_snippetelocal_pack
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - languageTipo: string | null
_code codice lingua in un array POST
- locationTipo: integer | null
_code codice posizione in un array POST
- offsetTipo: integer | null
valore di offset corrente
- offsetTipo: string | null
_token token di offset per le richieste successive
puoi usare la stringa fornita in questo campo per ottenere i risultati successivi dell'attività iniziale;
nota: i valori dioffset_tokensono univoci per ogni attività successiva - seTipo: string | null
_type tipo di motore di ricerca
- totalTipo: integer | null Formato: int64
_count quantità totale di risultati nel nostro database pertinenti alla tua richiesta
- resultTipo: integer | null Formato: int64
_count Numero di elementi nell'array dei risultati
- statusTipo: integer | null
_code codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui
- statusTipo: string | null
_message messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui
- timeTipo: string | null
Tempo di esecuzione in secondi
- Tipo: integer | null Formato: int64tasks
_count Il numero di attività nell'array tasks
- Tipo: integer | null Formato: int64tasks
_error Il numero di attività nell'array tasks restituite con un errore
- Tipo: string | nulltime
tempo di esecuzione totale, secondi
- Tipo: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/top_searches/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_name": "English",
"location_code": 2840,
"limit": 3
}
]'
{
"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,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"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]"
}
]
}
]
}
]
}