Impostare le attività live ‘Clickstream Global Search Volume’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Impostare le attività live ‘Clickstream Global Search Volume’
Volume di ricerca clickstream per keywords in tutto il mondo, senza alcun argomento di località – il totale globale e la sua ripartizione per paese. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Usalo per decidere quali mercati meritano una chiamata per località; la variante localizzata è post_dataforseo_keywords_clickstream_search_volume_live.
Riferimento prezzi
- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.09.
- 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)[]
- keywordsTipo: array string[]
keyword di destinazione
campo obbligatorio
codifica UTF-8
numero massimo di keyword specificabili in questo array: 1000;
ogni keyword deve contenere almeno 3 caratteri;
le keyword verranno convertite in minuscolo;
Nota: alcuni simboli e caratteri (ad es. simboli UTF, emoji) non sono consentiti
per saperne di più su quali simboli e caratteri possono essere usati, consulta questo articoloscopri di più su regole e limiti dei campi
keywordekeywordsnelle API DataForSEO in questo articolo del Help Center - 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_KeywordsDataClickstreamDataGlobalSearchVolumeLiveResponseInfo200
- 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_KeywordsDataClickstreamDataGlobalSearchVolumeLiveTaskInfo
- 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
- countryTipo: array (object | null)[] | null
_distribution distribuzione del clickstream per paese
rappresenta il volume di ricerca basato sul clickstream nei paesi disponibili, nonché la rispettiva percentuale del volume di ricerca globale- countryTipo: string | null
_iso _code codice ISO del paese
- percentageTipo: number | null
percentuale del volume di ricerca globale
- searchTipo: integer | null Formato: int64
_volume volume di ricerca medio mensile basato sul clickstream
rappresenta il numero (approssimativo) di ricerche per l'idea di keyword in base al clickstream
scopri di più sul volume di ricerca basato sul clickstream in questo articolo dell'Help Center
- keywordTipo: string | null
keyword
la keyword viene restituita con %## decodificato (il carattere più '+' viene decodificato in uno spazio) - searchTipo: integer | null Formato: int64
_volume volume di ricerca medio mensile basato sul clickstream
rappresenta il numero (approssimativo) di ricerche per l'idea di keyword in base al clickstream
scopri di più sul volume di ricerca basato sul clickstream in questo articolo dell'Help Center
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items
- 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/clickstream_data/global_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"tag": "test-tag",
"keywords": [
"you tube",
"youtube",
"youtub"
]
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"keyword": null,
"search_volume": null,
"country_distribution": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}