v0.2.0-beta

OpenAPI 3.1.0

Titulky YouTube naživo – pokročilé

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operace

post/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced

Titulky YouTube naživo – pokročilé

Vrací stopu titulků jednoho videa YouTube, synchronně. 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; regular zvolte, když záleží jen na seřazeném seznamu, a html jen pro kontrolu, co parser vynechal. Obaleno obálkou 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.02.
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.

Tělo

application/json

Typ: array (object | null)[]
- device
  Typ: string | null
  
  typ zařízení volitelné pole jediná hodnota: desktop
- language_code
  Typ: string | null
  
  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
- language_name
  Typ: string | null
  
  ú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
- location_code
  Typ: integer | null
  
  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
- location_name
  Typ: string | null
  
  ú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
- os
  Typ: string | null
  
  operační systém zařízení volitelné pole vyberte z následujících hodnot: windows, macos výchozí hodnota: windows
- subtitles_language
  Typ: string | null
  
  kód jazyka původního textu kód jazyka získáte z výsledku YouTube Video Info
- subtitles_translate_language
  Typ: string | null
  
  kód jazyka přeloženého textu možné hodnoty: "az", "ay", "ak", "sq", "am", "en", "ar", "hy", "as", "af", "eu", "be", "bn", "my", "bg", "bs", "bho", "cy", "hu", "vi", "haw", "ht", "gl", "lg", "el", "ka", "gn", "gu", "gd", "da", "fy", "zu", "iw", "ig", "yi", "id", "ga", "is", "es", "it", "yo", "kk", "kn", "ca", "qu", "rw", "ky", "zh-Hant", "zh-Hans", "ko", "co", "xh", "ku", "km", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "dv", "mt", "mi", "mr", "mn", "und", "de", "ne", "nl", "no", "ny", "or", "om", "pa", "fa", "pl", "pt", "ps", "ro", "ru", "sm", "sa", "ceb", "nso", "sr", "si", "sd", "sk", "sl", "so", "sw", "su", "tg", "th", "ta", "tt", "te", "ti", "ts", "tr", "tk", "uz", "ug", "uk", "ur", "fil", "fi", "fr", "ha", "hi", "hmn", "hr", "cs", "sv", "sn", "ee", "eo", "et", "st", "jv", "ja", "kri"
- tag
  Typ: 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
- video_id
  Typ: string
  
  ID videa povinné pole ID videa najdete v URL nebo v položce 'youtube_video' výsledku YouTube Organic příklad: Y8Wu4rSNJms

Odpovědi

200
Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

tasks
Typ: array (object | null)[] | null

pole úloh

Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

propertyName
Typ: object | null
id
Typ: string | null

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

path
Typ: array (string | null)[] | null

cesta URL

result
Typ: array (object | null)[] | null

pole výsledků

category
Typ: string | null

kategorie, do které video patří. Poznámka: toto pole je zastaralé a vždy vrací null

check_url
Typ: string | null

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

datetime
Typ: 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

item_types
Typ: array (string | null)[] | null

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_subtitles

items
Typ: array (object | null)[] | null

položky výsledků vyhledávání nalezené v SERP

duration_time
Typ: number | null

délka titulků v sekundách

end_time
Typ: number | null

sekunda, kdy text titulků končí

rank_absolute
Typ: integer | null

absolutní pořadí v SERP pro cílovou doménu
absolutní pozice mezi všemi prvky v SERP

rank_group
Typ: integer | null

pořadí skupiny v SERP
pozice ve skupině prvků se shodnými hodnotami type
pozice prvků s jinými hodnotami type se v rank_group vynechávají

start_time
Typ: number | null

sekunda, kdy text titulků začíná

text
Typ: string | null

text přeložený v titulcích

type
Typ: string | null

typ prvku

items_count
Typ: integer | null Formát: int64

Počet výsledků vrácených v poli items.

language_code
Typ: string | null

Kód jazyka v poli POST.

location_code
Typ: integer | null

Kód lokality v poli POST.

origin_language
Typ: string | null

kód jazyka původního textu

se_domain
Typ: string | null

doména vyhledávače v poli POST

spell
Typ: 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

keyword
Typ: string | null

klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo

type
Typ: 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

subtitles_count
Typ: integer | null Formát: int64

počet titulků ve videu

title
Typ: string | null

název videa

translate_language
Typ: string | null

kód jazyka přeloženého textu

unsupported_language
Typ: boolean | null

označuje, zda jazyk není systémem podporován

video_id
Typ: string | null

ID videa přijaté v poli POST

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

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

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

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

post/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "Y8Wu4rSNJms"
  }
]'

Zobrazit schéma

{
  "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
          ],
          "unsupported_language": null,
          "translate_language": null,
          "origin_language": null,
          "category": null,
          "subtitles_count": null,
          "title": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "text": null,
              "start_time": null,
              "end_time": null,
              "duration_time": null
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Titulky YouTube naživo – pokročilé

OvěřováníRequired

DataForSEO

Titulky YouTube naživo – pokročilé

Cenová reference