DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Napisy YouTube na żywo — Advanced
Zwraca ścieżkę napisów jednego filmu YouTube, synchronicznie. Zwraca keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count oraz items. advanced jest opcją domyślną; wybierz regular, gdy liczy się tylko lista rankingowa, a html tylko po to, by sprawdzić, co pominął parser. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200.
Cennik referencyjny
- Rozliczanie: zgłoszony koszt odpowiedzi.
- Szacunek referencyjny dla żądania: USD 0.02.
- Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.
- Typ: array (object | null)[]
- deviceTyp: string | null
typ urządzenia pole opcjonalne jedyna wartość: desktop
- languageTyp: string | null
_code kod języka wyszukiwarki pole wymagane, jeśli nie podasz language_name jeśli używasz tego pola, nie musisz podawać language_name listę dostępnych języków wyszukiwarki wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/youtube/languages przykład: en
- languageTyp: string | null
_name pełna nazwa języka wyszukiwarki pole wymagane, jeśli nie podasz language_code jeśli używasz tego pola, nie musisz podawać language_code listę dostępnych języków wyszukiwarki wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/youtube/languages przykład: English
- locationTyp: integer | null
_code kod lokalizacji wyszukiwarki pole wymagane, jeśli nie podasz location_name jeśli używasz tego pola, nie musisz podawać location_name listę dostępnych lokalizacji wyszukiwarek wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/youtube/locations przykład: 2840
- locationTyp: string | null
_name pełna nazwa lokalizacji wyszukiwarki pole wymagane, jeśli nie podasz location_code jeśli używasz tego pola, nie musisz podawać location_code listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/youtube/locations przykład: United States
- osTyp: string | null
system operacyjny urządzenia pole opcjonalne wybierz spośród następujących wartości: windows, macos wartość domyślna: windows
- subtitlesTyp: string | null
_language kod języka oryginalnego tekstu kod języka znajdziesz w wyniku YouTube Video Info
- subtitlesTyp: string | null
_translate _language kod języka przetłumaczonego tekstu możliwe wartości: "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"
- tagTyp: string | null
identyfikator zadania zdefiniowany przez użytkownika pole opcjonalne limit znaków: 255 tego parametru możesz użyć do identyfikacji zadania i dopasowania go do wyniku podaną wartość tag znajdziesz w obiekcie data odpowiedzi
- videoTyp: string
_id identyfikator filmu pole wymagane identyfikator filmu znajdziesz w adresie URL lub w elemencie 'youtube_video' wyniku YouTube Organic przykład: Y8Wu4rSNJms
- Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo200
- Typ: number | null Format: doublecost
łączny koszt zadań, USD
- Typ: integer | nullstatus
_code ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj
- Typ: string | nullstatus
_message ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- Typ: array (object | null)[] | nulltasks
tablica zadań
- Typ: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
- costTyp: number | null Format: double
łączny koszt zadań, USD
- dataTyp: object | null
zawiera te same parametry, które podano w żądaniu POST
- propertyTyp: object | null
Name
- idTyp: string | null
identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID
- pathTyp: array (string | null)[] | null
ścieżka URL
- resultTyp: array (object | null)[] | null
tablica wyników
- categoryTyp: string | null
kategoria, do której należy wideo. Uwaga: to pole jest przestarzałe i zawsze zwraca null
- checkTyp: string | null
_url bezpośredni URL do wyników wyszukiwania. Możesz go użyć, aby upewnić się, że udostępniliśmy dokładne wyniki
- datetimeTyp: string | null
data i godzina otrzymania wyniku w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”, przykład: 2019-11-15 12:57:46 +00:00
- itemTyp: array (string | null)[] | null
_types typy wyników wyszukiwania w SERP. Zawiera typy wyników wyszukiwania (items) znalezionych w SERP. Możliwy element: youtube_subtitles
- itemsTyp: array (object | null)[] | null
elementy wyników wyszukiwania znalezione w SERP
- durationTyp: number | null
_time czas trwania napisów w sekundach
- endTyp: number | null
_time sekunda, w której kończy się tekst napisów
- rankTyp: integer | null
_absolute bezwzględny ranking w SERP dla domeny docelowej
bezwzględna pozycja wśród wszystkich elementów w SERP - rankTyp: integer | null
_group ranking grupy w SERP
pozycja w grupie elementów o identycznych wartościachtype
pozycje elementów o innych wartościachtypesą pomijane wrank_group - startTyp: number | null
_time sekunda, w której zaczyna się tekst napisów
- textTyp: string | null
tekst przetłumaczony w napisach
- typeTyp: string | null
typ elementu
- itemsTyp: integer | null Format: int64
_count Liczba wyników zwróconych w tablicy items.
- languageTyp: string | null
_code Kod języka w tablicy POST.
- locationTyp: integer | null
_code Kod lokalizacji w tablicy POST.
- originTyp: string | null
_language kod języka tekstu oryginalnego
- seTyp: string | null
_domain domena wyszukiwarki w tablicy POST
- spellTyp: object | null · Response36Afe1097B20_SpellInfo
autokorekta wyszukiwarki. Jeśli wyszukiwarka zwróciła wyniki dla poprawionego słowa kluczowego, podamy słowo kluczowe poprawione przez wyszukiwarkę oraz typ autokorekty
- keywordTyp: string | null
słowo kluczowe uzyskane w wyniku autokorekty wyszukiwarki wyniki zostaną udostępnione dla poprawionego słowa kluczowego
- typeTyp: string | null
typ autokorekty możliwe wartości: did_you_mean, showing_results_for, no_results_found_for, including_results_for uwaga: Yahoo i Yandex obsługują tylko następujący typ autokorekty: including_results_for
- subtitlesTyp: integer | null Format: int64
_count liczba napisów w wideo
- titleTyp: string | null
tytuł wideo
- translateTyp: string | null
_language kod języka przetłumaczonego tekstu
- unsupportedTyp: boolean | null
_language wskazuje, czy język nie jest obsługiwany przez system
- videoTyp: string | null
_id identyfikator wideo otrzymany w tablicy POST
- resultTyp: integer | null Format: int64
_count liczba elementów w tablicy result
- statusTyp: integer | null
_code kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj
- statusTyp: string | null
_message komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- timeTyp: string | null
czas wykonania, sekundy
- Typ: integer | null Format: int64tasks
_count liczba zadań w tablicy tasks
- Typ: integer | null Format: int64tasks
_error liczba zadań w tablicy tasks zwróconych z błędem
- Typ: string | nulltime
łączny czas wykonania, sekundy
- Typ: string | nullversion
bieżąca wersja interfejsu API
application/json - 400
Nie można przetworzyć żądania. Sprawdź parametry żądania.
- 401
Wymagany jest prawidłowy klucz API Felo.
- 402
Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
- 403
Konto nie ma uprawnień do wykonania tej operacji.
- 429
Osiągnięto limit żądań lub wydatków.
- 502
Usługa nie mogła ukończyć żądania.
- 503
API lub usługa rozliczeniowa jest tymczasowo niedostępna.
- 504
Upłynął limit czasu usługi podczas przetwarzania żądania.
- default
Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy
application/json
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"
}
]'
{
"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
}
]
}
]
}
]
}