DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: YouTube Video Info avanzato
Restituisce in modo sincrono i metadati di un video YouTube. Restituisce keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count e items. advanced è la scelta predefinita; usa regular quando conta solo l'elenco classificato e html solo per verificare cosa ha scartato il parser. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200.
Riferimento prezzi
- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.006.
- 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)[]
- deviceTipo: string | null
tipo di dispositivo campo opzionale unico valore: desktop
- languageTipo: string | null
_code codice lingua del motore di ricerca campo obbligatorio se non specifichi language_name se usi questo campo, non devi specificare language_name puoi ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/youtube/languages esempio: en
- languageTipo: string | null
_name nome completo della lingua del motore di ricerca campo obbligatorio se non specifichi language_code se usi questo campo, non devi specificare language_code puoi ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/youtube/languages esempio: English
- locationTipo: integer | null
_code codice località del motore di ricerca campo obbligatorio se non specifichi location_name se usi questo campo, non devi specificare location_name puoi ricevere l'elenco delle località disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/youtube/locations esempio: 2840
- locationTipo: string | null
_name nome completo della località del motore di ricerca campo obbligatorio se non specifichi location_code se usi questo campo, non devi specificare location_code puoi ricevere l'elenco delle località disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/youtube/locations esempio: United States
- osTipo: string | null
sistema operativo del dispositivo campo opzionale scegli tra i seguenti valori: windows, macos valore predefinito: windows
- tagTipo: string | null
identificatore dell'attività definito dall'utente campo facoltativo il limite di caratteri è 255 è possibile usare questo parametro per identificare l'attività e abbinarla al risultato il valore tag specificato si trova nell'oggetto data della risposta
- videoTipo: string
_id ID del video campo obbligatorio puoi trovare l'ID del video nell'URL o nell'elemento 'youtube_video' del risultato YouTube Organic esempio: vQXvyV0zIP4
- Tipo: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedResponseInfo200
- 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_SerpYoutubeVideoInfoLiveAdvancedTaskInfo
- 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
- checkTipo: string | null
_url URL diretto ai risultati del motore di ricerca consente di verificare che abbiamo fornito risultati esatti
- datetimeTipo: string | null
data e ora in cui il risultato è stato ricevuto nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00
- itemTipo: array (string | null)[] | null
_types tipi di risultati di ricerca nella SERP contiene i tipi di risultati di ricerca (items) trovati nella SERP. tipo di elemento possibile: youtube_video_info
- itemsTipo: array (object | null)[] | null
elementi dei risultati di ricerca trovati nella SERP
- categoryTipo: string | null
la categoria a cui appartiene il video
- channelTipo: string | null
_id l'ID del canale in cui è pubblicato il video
- channelTipo: string | null
_logo l'URL della pagina in cui è ospitata l'immagine del logo del canale
- channelTipo: string | null
_name il nome del canale in cui è pubblicato il video
- channelTipo: object | null · Response36Afe1097B20_ChannelSubscribersCount
_subscribers _count numero di iscritti al canale
- countTipo: integer | null Formato: int64
numero di iscritti
- displayedTipo: string | null
_count numero di iscritti visualizzato
numero di iscritti come visualizzato su YouTube
- channelTipo: string | null
_url l'URL del canale in cui è pubblicato il video
- commentsTipo: integer | null Formato: int64
_count numero di commenti al video
- descriptionTipo: string | null
descrizione del video
- durationTipo: string | null
_time durata del video
- durationTipo: integer | null
_time _seconds durata del video in secondi
- isTipo: boolean | null
_embeddable indica se il video può essere incorporato
- isTipo: boolean | null
_live indica se il video è in diretta
- keywordsTipo: array (string | null)[] | null
keyword pertinenti al video
note anche come 'tag di YouTube' - likesTipo: integer | null Formato: int64
_count numero di like al video
- publicationTipo: string | null
_date la data in cui il video viene pubblicato
- rankTipo: integer | null
_absolute posizione assoluta nella SERP per il dominio di destinazione
posizione assoluta tra tutti gli elementi della SERP - rankTipo: integer | null
_group posizione di gruppo nella SERP
posizione all'interno di un gruppo di elementi con valoritypeidentici
le posizioni degli elementi con valoritypediversi vengono omesse darank_group - streamingTipo: array (object | null)[] | null
_quality array di elementi che contengono informazioni su tutte le possibili qualità di streaming del video
- bitrateTipo: integer | null
- fpsTipo: integer | null
- heightTipo: integer | null
altezza del video in pixel
- labelTipo: string | null
etichetta dell'elemento di qualità
- mimeTipo: string | null
_type - typeTipo: string | null
tipo di elemento
- widthTipo: integer | null Formato: int64
larghezza del video in pixel
- subtitlesTipo: array (object | null)[] | null
array di elementi che descrivono le proprietà dei sottotitoli nel video
- isTipo: boolean | null
_auto _generated indica se i sottotitoli sono generati automaticamente
- isTipo: boolean | null
_translatable indica se i sottotitoli sono traducibili
- languageTipo: string | null
lingua dei sottotitoli
- thumbnailTipo: string | null
_url l'URL della pagina in cui è ospitata la miniatura
- timestampTipo: string | null
data e ora in cui il risultato viene pubblicato
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2022-11-15 12:57:46 +00:00 - titleTipo: string | null
titolo del video
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL del video
- videoTipo: string | null
_id ID del video ricevuto in un array POST
- viewsTipo: integer | null Formato: int64
_count numero di visualizzazioni del video
- 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
_domain dominio del motore di ricerca in un array POST
- spellTipo: object | null · Response36Afe1097B20_SpellInfo
correzione automatica del motore di ricerca se il motore di ricerca ha fornito risultati per una keyword corretta, indichiamo la keyword corretta dal motore di ricerca e il tipo di correzione automatica
- keywordTipo: string | null
keyword ottenuta a seguito della correzione automatica del motore di ricerca i risultati saranno forniti per la keyword corretta
- typeTipo: string | null
tipo di correzione automatica valori possibili: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo e Yandex supportano solo il seguente tipo di correzione automatica: including_results_for
- videoTipo: string | null
_id ID del video ricevuto 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/serp/youtube/video_info/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"video_id": "vQXvyV0zIP4"
}
]'
{
"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": [
{
"video_id": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"video_id": null,
"title": null,
"url": null,
"thumbnail_url": null,
"channel_id": null,
"channel_name": null,
"channel_url": null,
"channel_logo": null,
"description": null,
"views_count": null,
"likes_count": null,
"comments_count": null,
"channel_subscribers_count": "[Max Depth Exceeded]",
"publication_date": null,
"timestamp": null,
"keywords": [
"[Max Depth Exceeded]"
],
"category": null,
"is_live": null,
"is_embeddable": null,
"duration_time": null,
"duration_time_seconds": null,
"subtitles": [
"[Max Depth Exceeded]"
],
"streaming_quality": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}