DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Stima storica del traffico in blocco
Traffico organico stimato per molti domini in ogni punto della cronologia disponibile: la serie temporale dietro post_dataforseo_labs_google_bulk_traffic_estimation_live. 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. ⚠️ La dimensione della risposta moltiplica i domini per le date; tenere entrambe le liste corte. Le date disponibili provengono da get_dataforseo_labs_google_available_history.
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)[]
- 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 12 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 sutruevengono restituite solo le keyword principali, tutte le keyword molto simili vengono escluse;
valore predefinito:false - itemTipo: array string[] | null
_types mostra i risultati per tipo di elemento
campo facoltativo
indica il tipo di risultati di ricerca inclusi nella risposta;
Nota: se l'arrayitem_typescontiene tipi di elemento diversi daorganic, i risultati vengono ordinati in base al primo tipo di elemento nell'array;
valori possibili:["organic", "paid", "featured_snippet", "local_pack"]
valore predefinito:["organic", "paid"] - languageTipo: string | null
_code codice della lingua
se si usa questo campo, non è necessario specificarelanguage_name
l'elenco delle lingue disponibili conlanguage_codesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorare questo campo per ottenere i risultati per tutte le lingue disponibili
esempio:en - languageTipo: string | null
_name nome completo della lingua
se si usa questo campo, non è necessario specificarelanguage_code
l'elenco delle lingue disponibili conlanguage_namesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorare questo campo per ottenere i risultati per tutte le lingue disponibili
esempio:English - locationTipo: integer | null
_code codice della località
se si usa questo campo, non è necessario specificarelocation_name
l'elenco delle località disponibili conlocation_codesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorare questo campo per ottenere i risultati per tutte le località disponibili
esempio:2840 - locationTipo: string | null
_name nome completo della località
se si usa questo campo, non è necessario specificarelocation_code
l'elenco delle località disponibili conlocation_namesi ottiene con una richiesta separata ahttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorare questo campo per ottenere i risultati per tutte le località disponibili
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 - targetsTipo: array string[]
domini e sottodomini di destinazione
campo obbligatorio
in questo campo è possibile specificare domini e sottodomini;
i domini e i sottodomini vanno specificati senzahttps://ewww.;
è possibile impostare fino a 1000 domini o sottodomini
- Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveResponseInfo200
- 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_DataforseoLabsGoogleHistoricalBulkTrafficEstimationLiveTaskInfo
- 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
array di elementi con dati di stima del traffico pertinenti
- metricsTipo: object | null · Response36Afe1097B20_HistoricalMetricsBundleInfo
dati di traffico relativi al dominio specificato
- featuredTipo: array (object | null)[] | null
_snippet dati di traffico dai risultati featured snippet nella SERP di Google
- countTipo: integer | null Formato: int64
numero totale di SERP organiche che contengono il dominio
- etvTipo: number | null
- monthTipo: integer | null
mese per cui vengono forniti i dati
- yearTipo: integer | null
anno per cui vengono forniti i dati
- localTipo: array (object | null)[] | null
_pack dati di traffico dai risultati local pack nella SERP
- countTipo: integer | null Formato: int64
numero totale di SERP organiche che contengono il dominio
- etvTipo: number | null
- monthTipo: integer | null
mese per cui vengono forniti i dati
- yearTipo: integer | null
anno per cui vengono forniti i dati
- organicTipo: array (object | null)[] | null
dati di traffico dalla ricerca organica
- countTipo: integer | null Formato: int64
numero totale di SERP organiche che contengono il dominio
- etvTipo: number | null
- monthTipo: integer | null
mese per cui vengono forniti i dati
- yearTipo: integer | null
anno per cui vengono forniti i dati
- paidTipo: array (object | null)[] | null
dati di traffico dalla ricerca a pagamento
- countTipo: integer | null Formato: int64
numero totale di SERP organiche che contengono il dominio
- etvTipo: number | null
- monthTipo: integer | null
mese per cui vengono forniti i dati
- yearTipo: integer | null
anno per cui vengono forniti i dati
- seTipo: string | null
_type tipo di motore di ricerca
- targetTipo: string | null
dominio di destinazione in un array POST
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - languageTipo: string | null
_code codice lingua in un array POST
se non ci sono dati, il valore ènull - locationTipo: integer | null
_code codice località in un array POST
se non ci sono dati, il valore ènull - 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/historical_bulk_traffic_estimation/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"targets": [
"dataforseo.com",
"cnn.com",
"forbes.com"
],
"location_code": 2840,
"language_code": "en",
"date_from": "2021-01-01",
"date_to": "2021-03-29",
"item_types": [
"organic",
"paid"
]
}
]'
{
"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,
"items": [
{
"se_type": null,
"target": null,
"metrics": "[Max Depth Exceeded]"
}
]
}
]
}
]
}