Impostare le attività live ‘DataForSEO Trends Merged Data’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Impostare le attività live ‘DataForSEO Trends Merged Data’
Dati Explore, demografici e di subregione per gli stessi keywords in un'unica risposta, anziché in tre chiamate. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200. Preferiscilo quando ti serve il quadro completo: gli altri tre costano una chiamata ciascuno e questo restituisce ciò che restituirebbero tutti e tre.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.09.
- 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 specifichi questo campo, verranno usati per impostazione predefinita il giorno e il mese correnti dell'anno precedente
valore minimo per il tipoweb:2004-01-01
valore minimo per altri tipi:2008-01-01
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - dateTipo: string | null
_to data di fine dell'intervallo di tempo
campo facoltativo
se non specifichi questo campo, verrà usata la data odierna per impostazione predefinita
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - keywordsTipo: array string[]
keywords
campo obbligatorio
numero massimo di keywords specificabili: 5
evitare simboli e caratteri speciali (ad es. simboli UTF, emoji);
specificando caratteri non latini, si otterranno dati per i paesi in cui vengono usatiscopri di più su regole e limitazioni dei campi
keywordekeywordsnelle API DataForSEO in questo articolo del Help Center - locationTipo: integer | null
_code codice località del motore di ricerca
campo facoltativo
se non si usa questo campo, si riceveranno risultati globali
se si usa questo campo, non è necessario specificarelocation_name
è possibile ricevere l'elenco delle località disponibili dei motori di ricerca con il relativolocation_codeeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
nota che i dati verranno forniti per il paese a cui appartiene illocation_codespecificato;
esempio:2840 - locationTipo: string | null
_name nome completo della località del motore di ricerca
campo facoltativo
se non si usa questo campo, si riceveranno risultati globali
se si usa questo campo, non è necessario specificarelocation_code
è possibile ricevere l'elenco delle località disponibili del motore di ricerca con il relativolocation_nameeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
nota che i dati verranno forniti per il paese a cui appartiene illocation_namespecificato;
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 - timeTipo: string | null
_range intervalli temporali preimpostati
campo facoltativo
se si specificano i parametridate_fromodate_to, questo campo viene ignorato durante l'impostazione di un'attività
possibili valori per tutti i parametritype:past_4_hours,past_day,past_7_days,past_30_days,past_90_days,past_12_months,past_5_years - typeTipo: string | null
tipo di elemento
- Tipo: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsMergedDataLiveResponseInfo200
- 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_KeywordsDataDataforseoTrendsMergedDataLiveTaskInfo
- 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
- datetimeTipo: string | null
data e ora di ricezione del risultato
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2019-11-15 12:57:46 +00:00 - itemsTipo: array (object | null)[] | null
contiene la popolarità delle keyword e i dati correlati
- keywordsTipo: array (string | null)[] | null
keyword in un array POST
- positionTipo: integer | null
l'allineamento dell'elemento
può assumere i seguenti valori:1,2,3,4, ecc. - typeTipo: string | null
tipo di elemento
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - keywordsTipo: array (string | null)[] | null
keyword in un array POST
- 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 - typeTipo: string | null
tipo di elemento
- 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/keywords_data/dataforseo_trends/merged_data/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"rugby",
"cricket"
],
"date_from": "2023-01-01",
"date_to": "2024-01-01",
"type": "web",
"location_name": "United States"
}
]'
{
"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": [
{
"keywords": [
null
],
"type": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"type": null,
"position": null,
"keywords": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}