v0.2.0-beta

OpenAPI 3.1.0

Live: YouTube-Untertitel Advanced

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

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

Live: YouTube-Untertitel Advanced

Gibt die Untertitelspur eines YouTube-Videos bei YouTube synchron zurück. Liefert keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count und items. advanced ist die Standardwahl; nehmen Sie regular, wenn nur die rangierte Liste zählt, und html nur, um zu prüfen, was der Parser verworfen hat. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.02.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- device
  Typ: string | null
  
  Gerätetyp optionales Feld einziger Wert: desktop
- language_code
  Typ: string | null
  
  Sprachcode der Suchmaschine Pflichtfeld, wenn Sie language_name nicht angeben Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/youtube/languages Beispiel: en
- language_name
  Typ: string | null
  
  Vollständiger Name der Sprache der Suchmaschine Pflichtfeld, wenn Sie language_code nicht angeben Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben Die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/youtube/languages Beispiel: English
- location_code
  Typ: integer | null
  
  Standortcode der Suchmaschine Pflichtfeld, wenn Sie location_name nicht angeben Wenn Sie dieses Feld verwenden, müssen Sie location_name nicht angeben Die Liste der verfügbaren Standorte der Suchmaschinen mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/youtube/locations Beispiel: 2840
- location_name
  Typ: string | null
  
  Vollständiger Name des Standorts der Suchmaschine Pflichtfeld, wenn Sie location_code nicht angeben Wenn Sie dieses Feld verwenden, müssen Sie location_code nicht angeben Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/serp/youtube/locations Beispiel: United States
- os
  Typ: string | null
  
  Gerätebetriebssystem optionales Feld wählen Sie aus folgenden Werten: windows, macos Standardwert: windows
- subtitles_language
  Typ: string | null
  
  Sprachcode des Originaltexts Sie erhalten den Sprachcode aus dem Ergebnis von YouTube Video Info
- subtitles_translate_language
  Typ: string | null
  
  Sprachcode des übersetzten Texts mögliche Werte: "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
  
  Benutzerdefinierte Aufgaben-ID Optionales Feld Das Zeichenlimit beträgt 255 Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen Den angegebenen tag-Wert finden Sie im data-Objekt der Antwort
- video_id
  Typ: string
  
  ID des Videos Pflichtfeld Sie finden die Video-ID in der URL oder im Element 'youtube_video' des Ergebnisses von YouTube Organic Beispiel: Y8Wu4rSNJms

Antworten

200
Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

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

Array der Aufgaben

Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

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

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

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

URL-Pfad

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

Array der Ergebnisse

category
Typ: string | null

die Kategorie, zu der das Video gehört. Hinweis: Dieses Feld ist veraltet und gibt immer null zurück

check_url
Typ: string | null

direkte URL zu den Suchmaschinenergebnissen. Sie können sie verwenden, um sicherzustellen, dass wir genaue Ergebnisse geliefert haben

datetime
Typ: string | null

Datum und Uhrzeit des Eingangs des Ergebnisses im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“ Beispiel: 2019-11-15 12:57:46 +00:00

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

Arten von Suchergebnissen in SERP enthält die in SERP gefundenen Arten von Suchergebnissen (items). mögliches Element: youtube_subtitles

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

Elemente der in SERP gefundenen Suchergebnisse

duration_time
Typ: number | null

Dauer der Untertitel in Sekunden

end_time
Typ: number | null

der zweite Untertiteltext endet

rank_absolute
Typ: integer | null

absoluter Rang in SERP für die Zieldomain
absolute Position unter allen Elementen in SERP

rank_group
Typ: integer | null

Gruppenrang in der SERP
Position innerhalb einer Gruppe von Elementen mit identischen type-Werten
Positionen von Elementen mit anderen type-Werten werden aus rank_group ausgelassen

start_time
Typ: number | null

der zweite Untertiteltext beginnt

text
Typ: string | null

in Untertiteln übersetzter Text

type
Typ: string | null

Elementtyp

items_count
Typ: integer | null Format: int64

Anzahl der im items-Array zurückgegebenen Ergebnisse

language_code
Typ: string | null

Sprachcode in einem POST-Array

location_code
Typ: integer | null

Standortcode in einem POST-Array

origin_language
Typ: string | null

Sprachcode des Originaltexts

se_domain
Typ: string | null

Suchmaschinendomäne in einem POST-Array

spell
Typ: object | null · Response36Afe1097B20_SpellInfo

Autokorrektur der Suchmaschine wenn die Suchmaschine Ergebnisse für ein korrigiertes Keyword geliefert hat, geben wir das von der Suchmaschine korrigierte Keyword und die Art der Autokorrektur an

keyword
Typ: string | null

Keyword, das durch die Autokorrektur der Suchmaschine ermittelt wurde die Ergebnisse werden für das korrigierte Keyword bereitgestellt

type
Typ: string | null

Art der Autokorrektur mögliche Werte: did_you_mean, showing_results_for, no_results_found_for, including_results_for Hinweis: Yahoo und Yandex unterstützen nur die folgende Autokorrekturart: including_results_for

subtitles_count
Typ: integer | null Format: int64

Anzahl der Untertitel im Video

title
Typ: string | null

Titel des Videos

translate_language
Typ: string | null

Sprachcode des übersetzten Texts

unsupported_language
Typ: boolean | null

gibt an, ob die Sprache vom System nicht unterstützt wird

video_id
Typ: string | null

ID des in einem POST-Array empfangenen Videos

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

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"
  }
]'

Schema anzeigen

{
  "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
            }
          ]
        }
      ]
    }
  ]
}

Erfolgreicher Vorgang

Live: YouTube-Untertitel Advanced

AuthentifizierungRequired

DataForSEO

Live: YouTube-Untertitel Advanced

Preisreferenz