DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Panoramica storica del ranking
La panoramica del ranking di un dominio come si presentava in ogni punto della cronologia disponibile. Questo endpoint non ha un parametro limit, ma viene fatturato per chiamata anziché per elemento: inviare quindi l'intera lista in una sola volta. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Controllare prima get_dataforseo_labs_google_available_history: indica le date esistenti, e una data fuori da esse non restituisce nulla invece di un errore. Lo snapshot attuale è post_dataforseo_labs_google_domain_rank_overview_live.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.1356.
- Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- correlateTipo: boolean | null
correla i dati con i set di dati ottenuti in precedenza
campo facoltativo
valore predefinito:true
se si usa questo parametro, il nostro sistema correla i dati ottenuti ora con i set di dati ottenuti in precedenza
questo parametro serve a ridurre le incoerenze che possono derivare da modifiche al nostro database
consigliamo di impostare semprecorrelatesutrue - dateTipo: string | null
_from data di inizio dell'intervallo di tempo
campo facoltativo
se non si specifica questo campo, i dati vengono forniti per i 6 mesi precedenti
valore minimo possibile:2020-10-01
formato data:"yyyy-mm-dd" - dateTipo: string | null
_to data di fine dell'intervallo di tempo
campo facoltativo
se non si specifica questo campo, per impostazione predefinita viene usata la data odierna
formato data:"yyyy-mm-dd"
esempio:"2021-04-01" - ignoreTipo: boolean | null
_synonyms ignora keyword molto simili
campo facoltativo
se impostato sutrue, vengono restituiti solo i dati basati sulle keyword principali, i dati di tutte le keyword molto simili vengono esclusi;
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_etv,clickstream_gender_distributioneclickstream_age_distributioncon i dati clickstream;
valore predefinito:false;Nota: i dati clickstream storici sono disponibili da 2024/05 (maggio 2024);
con questo parametro abilitato viene addebitato il doppio del prezzo per la richiesta;
scopri di più su come vengono calcolate le metriche basate su clickstream in questo articolo del Help Center - 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 - 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 - 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 - targetTipo: string
dominio
campo obbligatorio
il nome del dominio del sito web di destinazione
il dominio va specificato senzahttps://ewww.
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo200
- 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_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
- 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 dati storici di ranking e di traffico
- metricsTipo: object | null
dati di ranking relativi al dominio specificato
- propertyTipo: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamTipo: object | null
_age _distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- clickstreamTipo: number | null Formato: double
_etv volume di traffico stimato basato sui dati clickstream
calcolato come il prodotto del click-through rate e dei valori di volume di ricerca clickstream di tutte le keyword per cui il dominio si posiziona
per ottenere risultati per questo campo, il parametroinclude_clickstream_datadeve essere impostato sutrue
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center - clickstreamTipo: object | null
_gender _distribution - propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- countTipo: integer | null Formato: int64
numero totale di SERP organici che contengono il dominio o sottodominio
- estimatedTipo: number | null
_paid _traffic _cost costo stimato per convertire il traffico organico in traffico a pagamento
rappresenta il costo mensile stimato (USD) per la pubblicità di tutte le keyword nella categoria per cui il dominio o sottodominio si posiziona
la metrica viene calcolata come il prodotto dei valori organicietve dei valori a pagamentocpce indica il costo per generare il volume stimato di traffico organico mensile tramite pubblicità PPC su Google Search
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center - etvTipo: number | null
volume di traffico stimato
traffico organico mensile stimato verso il dominio o sottodominio
calcolato come il prodotto dei valori CTR (click-through rate) e volume di ricerca di tutte le keyword nella categoria per cui il dominio o sottodominio si posiziona
scopri di più su come viene calcolata la metrica in questo articolo dell'Help Center - isTipo: integer | null
_down posizione diminuita
indica quanti elementi posizionati del target indicato sono diminuiti - isTipo: integer | null
_lost elementi posizionati persi
indica quanti elementi posizionati del target indicato erano precedentemente presenti nei SERP ma non sono stati trovati durante l'ultimo controllo - isTipo: integer | null
_new numero di nuovi elementi posizionati
indica quanti nuovi elementi posizionati sono stati trovati per il target indicato - isTipo: integer | null
_up posizione aumentata
indica quanti elementi posizionati del target indicato sono aumentati - posTipo: integer | null
_1 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 1
- posTipo: integer | null
_11 _20 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 11-20
- posTipo: integer | null
_2 _3 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 2-3
- posTipo: integer | null
_21 _30 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 21-30
- posTipo: integer | null
_31 _40 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 31-40
- posTipo: integer | null
_4 _10 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 4-10
- posTipo: integer | null
_41 _50 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 41-50
- posTipo: integer | null
_51 _60 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 51-60
- posTipo: integer | null
_61 _70 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 61-70
- posTipo: integer | null
_71 _80 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 71-80
- posTipo: integer | null
_81 _90 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 81-90
- posTipo: integer | null
_91 _100 numero di SERP organici in cui il dominio o sottodominio si posiziona al n. 91-100
- monthTipo: integer | null
mese per cui vengono forniti i dati
- seTipo: string | null
_type tipo di motore di ricerca
- yearTipo: integer | null
anno per cui vengono forniti i dati
- 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
- seTipo: string | null
_type tipo di motore di ricerca
- targetTipo: string | null
dominio di destinazione in un array POST
- 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/historical_rank_overview/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29"
}
]'
{
"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,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"year": null,
"month": null,
"metrics": null
}
]
}
]
}
]
}