DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Živý YouTube Video Info Advanced
Synchronně vrací metadata jednoho videa na YouTube. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. advanced je výchozí volba; vezměte regular, když záleží jen na seznamu pořadí, a html jen pro kontrolu, co parser zahodil. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.006.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- deviceTyp: string | null
typ zařízení volitelné pole jediná hodnota: desktop
- languageTyp: string | null
_code kód jazyka vyhledávače povinné pole, pokud nezadáte language_name pokud toto pole použijete, nemusíte zadávat language_name seznam dostupných jazyků vyhledávače s jejich language_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/languages příklad: en
- languageTyp: string | null
_name úplný název jazyka vyhledávače povinné pole, pokud nezadáte language_code pokud toto pole použijete, nemusíte zadávat language_code seznam dostupných jazyků vyhledávače s jejich language_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/languages příklad: English
- locationTyp: integer | null
_code kód lokality vyhledávače povinné pole, pokud nezadáte location_name pokud toto pole použijete, nemusíte zadávat location_name seznam dostupných lokalit vyhledávačů s jejich location_code získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/locations příklad: 2840
- locationTyp: string | null
_name úplný název lokality vyhledávače povinné pole, pokud nezadáte location_code pokud toto pole použijete, nemusíte zadávat location_code seznam dostupných lokalit vyhledávače s jejich location_name získáte samostatným požadavkem na https://api.dataforseo.com/v3/serp/youtube/locations příklad: United States
- osTyp: string | null
operační systém zařízení volitelné pole vyberte z následujících hodnot: windows, macos výchozí hodnota: windows
- tagTyp: string | null
uživatelem definovaný identifikátor úlohy volitelné pole limit znaků je 255 tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem zadanou hodnotu tag najdete v objektu data odpovědi
- videoTyp: string
_id ID videa povinné pole ID videa najdete v URL nebo v položce 'youtube_video' výsledku YouTube Organic příklad: vQXvyV0zIP4
- Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávání můžete ji použít k ověření, že jsme poskytli přesné výsledky
- datetimeTyp: string | null
datum a čas přijetí výsledku ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00” příklad: 2019-11-15 12:57:46 +00:00
- itemTyp: array (string | null)[] | null
_types typy výsledků vyhledávání v SERP obsahuje typy výsledků vyhledávání (items) nalezených v SERP. možná položka: youtube_video_info
- itemsTyp: array (object | null)[] | null
položky výsledků vyhledávání nalezené v SERP
- categoryTyp: string | null
kategorie, do které video patří
- channelTyp: string | null
_id ID kanálu, kde je video zveřejněno
- channelTyp: string | null
_logo adresa URL stránky, na které je hostován obrázek loga kanálu
- channelTyp: string | null
_name název kanálu, ve kterém je video publikováno
- channelTyp: object | null · Response36Afe1097B20_ChannelSubscribersCount
_subscribers _count počet odběratelů kanálu
- countTyp: integer | null Formát: int64
počet odběratelů
- displayedTyp: string | null
_count zobrazený počet odběratelů
počet odběratelů zobrazený na YouTube
- channelTyp: string | null
_url adresa URL kanálu, ve kterém je video publikováno
- commentsTyp: integer | null Formát: int64
_count počet komentářů k videu
- descriptionTyp: string | null
popis videa
- durationTyp: string | null
_time délka videa
- durationTyp: integer | null
_time _seconds délka videa v sekundách
- isTyp: boolean | null
_embeddable označuje, zda lze video vložit
- isTyp: boolean | null
_live označuje, zda je video vysíláno živě
- keywordsTyp: array (string | null)[] | null
klíčová slova související s videem
označovaná také jako „značky YouTube” - likesTyp: integer | null Formát: int64
_count počet lajků u videa
- publicationTyp: string | null
_date datum publikování videa
- rankTyp: integer | null
_absolute absolutní pořadí v SERP pro cílovou doménu
absolutní pozice mezi všemi prvky v SERP - rankTyp: integer | null
_group pořadí skupiny v SERP
pozice ve skupině prvků se shodnými hodnotamitype
pozice prvků s jinými hodnotamitypese vrank_groupvynechávají - streamingTyp: array (object | null)[] | null
_quality pole prvků obsahujících informace o všech možných kvalitách streamování videa
- bitrateTyp: integer | null
- fpsTyp: integer | null
- heightTyp: integer | null
výška videa v pixelech
- labelTyp: string | null
označení prvku kvality
- mimeTyp: string | null
_type - typeTyp: string | null
typ prvku
- widthTyp: integer | null Formát: int64
šířka videa v pixelech
- subtitlesTyp: array (object | null)[] | null
pole prvků popisujících vlastnosti titulků ve videu
- isTyp: boolean | null
_auto _generated určuje, zda jsou titulky generovány automaticky
- isTyp: boolean | null
_translatable určuje, zda lze titulky přeložit
- languageTyp: string | null
jazyk titulků
- thumbnailTyp: string | null
_url adresa URL stránky, na které je hostována miniatura
- timestampTyp: string | null
datum a čas zveřejnění výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2022-11-15 12:57:46 +00:00 - titleTyp: string | null
název videa
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL videa
- videoTyp: string | null
_id ID videa přijaté v poli POST
- viewsTyp: integer | null Formát: int64
_count počet zhlédnutí videa
- itemsTyp: integer | null Formát: int64
_count Počet výsledků vrácených v poli items.
- languageTyp: string | null
_code Kód jazyka v poli POST.
- locationTyp: integer | null
_code Kód lokality v poli POST.
- seTyp: string | null
_domain doména vyhledávače v poli POST
- spellTyp: object | null · Response36Afe1097B20_SpellInfo
automatická oprava vyhledávače pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy
- keywordTyp: string | null
klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo
- typeTyp: string | null
typ automatické opravy možné hodnoty: did_you_mean, showing_results_for, no_results_found_for, including_results_for poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy: including_results_for
- videoTyp: string | null
_id ID videa přijaté v poli POST
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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]"
]
}
]
}
]
}
]
}