Impostare le attività live ‘Bulk Clickstream Search Volume’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Impostare le attività live ‘Bulk Clickstream Search Volume’
Volume di ricerca clickstream per molte keywords in un'unica chiamata, senza la dimensione della lingua. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. La variante per keyword con lingua è post_dataforseo_keywords_clickstream_search_volume_live. Poiché il prezzo è per chiamata e non per keyword, questa è quella da usare per un elenco.
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 - locationTipo: integer
_code codice località
campo obbligatorio se non specifichilocation_name
Nota: è necessario specificarelocation_nameoppurelocation_code
puoi ottenere l'elenco delle località disponibili con il relativolocation_codeeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
esempio:2840 - locationTipo: string
_name nome completo della località
campo obbligatorio se non specifichilocation_code
Nota: è necessario specificarelocation_nameoppurelocation_code
puoi ottenere l'elenco delle località disponibili con il relativolocation_nameeffettuando una richiesta separata ahttps://api.dataforseo.com/v3/keywords_data/clickstream_data/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
- Tipo: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo200
- 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_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo
- 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
- keywordTipo: string | null
keyword specificata nell'array POST
- 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 Formato: int64
_volume tasso attuale di volume di ricerca di una keyword
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - locationTipo: integer | null
_code codice posizione in un array POST
- 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/bulk_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"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": [
{
"location_code": null,
"items_count": null,
"items": [
{
"keyword": null,
"search_volume": null,
"monthly_searches": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}