Переглянути документацію
Довідник API
YouTube Відео Метадані API
Перегляд відео метаданих YouTube відео ID, включаючи деталі каналів, кількість залучень, ескізи, доступні формати та розділи.
Створити запит
11-character ID з відео URL, не повний URL.
https://data.flashdata.dev/v1/queries/realtimeПараметри
Відправити source і video_id на рівні вершини. Параметри джерела відносяться до params. Додаткові поля можуть бути використані.
Тіло запиту
sourcestring / Обов’язково- Набір до youtube_metadata.
video_idstring / Обов’язково- 11-character YouTube відео ID, такі як FUfGcZ092b0. Приймає листи, номери, низи і гіфени.Точно 11 ЗіркиЗа замовчуванням:
Не встановитиПрийнятий формат
^[A-Za-z0-9_-]{11}$ paramsobject / Необов’язково- Settings для цього запиту.За замовчуванням:
{} callback_urlstring · nullable / Необов’язково- Async і партії тільки. Public HTTPS завершена URL на порту 443, до 2,048 символів. Немає облікових даних користувача або фрагмента URL. Omit, використовуйте null або порожній рядок для повідомлення. У партії, встановивши це на кожному запиту, за межами парам.За замовчуванням:
Не встановити
Параметри відповіді
params.include_formatsboolean / Необов’язково- У тому числі наявні медіа формати та їх кодека, роздільна здатність та бітрейт інформації.
trueабоfalseЗа замовчуванням:true params.include_chaptersboolean / Необов’язково- Включіть розділи, коли відео має їх.
trueабоfalseЗа замовчуванням:true
Відповідь
Realtime повертається status: done. Читати вихід джерела на results[0]; usage.credits облік заряду.
Мета одного відео включає videoId, назву, деталі каналів, тривалість та кількість залучень.
Читати результат
Збережіть успішну відповідь JSON як response.json. Збережіть це як read-response.py і запустіть python read-response.py. Використовуються тільки Python- стандартна бібліотека і не дає нового запиту.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {name: result.get(name) for name in (
"videoId", "title", "channel", "duration", "hasTranscripts", "transcriptLanguages"
)}
print(json.dumps(output, ensure_ascii=False, indent=2))Обидва варіанти відповіді за замовчуванням до true при підключенні. Вимкнено include_formats для меншої відповіді, коли вам потрібно лише метадані. Розділи з'являються лише при запитуванні та доступі. Недоступні підрахунки можуть бути null.
formats опис доступних кодувань; він не завантажує відео. hasTranscripts і transcriptLanguages опис наявності, не перезапис тексту. Використання API завантаження для ЗМІ та ЗМІ транскрипція API для тексту.
Усі поля відповіді
| Поле | Опис |
|---|---|
sourcestring | За запитом джерело API. |
statusstring | в режимі реального часу, якщо в реальному часі буде досягнуто запит. |
created_atstring | Час створення відповіді в форматі ISO 8601. |
usage.creditsnumber | Кредит, що стягується за запит, виходячи з тарифного плану. |
results[0].videoIdstring | YouTube відео ID. |
results[0].titlestring | Назва відео. |
results[0].descriptionstring | Повний опис відео. |
results[0].channelstring | Назва каналу. |
results[0].channelIdstring | Канал ID. |
results[0].channelUrlstring | Канал URL. |
results[0].channelSubscriberCountnumber · nullable | Кількість абонентів каналу. |
results[0].viewCountnumber · nullable | Переглянути кількість. |
results[0].likeCountnumber · nullable | Як рахувати. |
results[0].commentCountnumber · nullable | Кількість коментарів. |
results[0].uploadDatestring · nullable | Дата завантаження. |
results[0].durationnumber · nullable | тривалість відео за секундами. |
results[0].durationStringstring · nullable | Термін придатності при наявності. |
results[0].thumbnailsarray | Thumbnail URLs і розміри. |
results[0].categoriesarray | Відео категорії. |
results[0].tagsarray | Відео теги. |
results[0].ageLimitinteger | Вік обмеження, або 0 при обмеженні. |
results[0].isLiveboolean | Чи живе відео. |
results[0].wasLiveboolean | Якщо відео було живим струмом. |
results[0].hasTranscriptsboolean | Чи доступні набори підписів. |
results[0].transcriptLanguagesarray | Доступні коди мови підписки. |
results[0].formatsarray · optional | Доступні медіа формати при include_formats true. |
results[0].chaptersarray · optional | Назва глави, start_time і end_time за секундами, при запитуванні і доступі. |
На полях описано типову відповідь JSON. JSON, звичайний текст і Markdown формати.
Async повертає одне надходження в роботу; повернення пакету на одну за Відео ID. Перевірити статус кожного завдання і отримати його результати за допомогою повернутих посилань.
Async & пакетний життєвий цикл
Подача повертається квитанції, не результати. Async створює одну роботу; пакет повертає окрему роботу в queries[] для кожного прийнятого запиту. Відстежуйте та отримайте кожну роботу самостійно.
Подати data.flashdata.dev; читати статус роботи та результати з api.flashdata.dev з тим же X-API-Key. Приклади базових прикладів API використовують Python і cURL.
1. Заощаджуйте роботу IDs
Зберігати поля запиту джерела при переході на Async. Для Batch викласти кожен запит у масив запитів об'єкта JSON. Заощаджуйте кожну подану роботу ID.
2. Статус на сервери
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: опитування з затримкою та повагоюRetry-Afterприсутні.completed: результати fetch.failed: оглядjob.error.Читать job.status, не статус отримання інформації.
Перевірити статус · Python і cURL
Статус на сервери API посилання3. Результати Фетт
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsПісля завершення перевірте результат читати, після чого викинути 302 пам'ять URL без ключа API. Заощаджуйте JSON в межах 24 годин завершення.
Результати розрахунків · Python і cURL · Формати відповідей
Завантажити API
Половлення та вилучення існуючих результатів не споживають кредитні запити. Час вилучення не скасовує роботу: зберігайте ID замість подання дублікатів, які запроваджують роботу. Коди помилок та поведінка птиця.
Вебхуки завершення
Підписатися на запит
Комплекти callback_url на рівні асинхронного запиту, або всередині кожного запиту в партії, поза params. Не потрібно окремий запит на веб-візію. Realtime не надсилайте зворотні дзвінки.
Використовуйте публічний HTTPS URL на порту 443. FlashData POSTS повідомлення для кожного досягнення роботи completed або failed; подія містить посилання, не сам результат.
Acknowledge і перевірка
Повернутися 2xx після того, як багато хто приймає захід. Дублікат delivery_id, також відправлений як X-Delivery-Id. Не слідувати перенаправлення.
В'язані поставки птиця з експоненціальним відключенням, до 8 намагатися всього і в більшості 24 годин після завершення. Зберігайте опитування як падлогу.
Відкликання не відмічаються. Підтвердіть роботу ID, джерело та статус терміналу через автентифікована кінцева точка стану перед обробкою повідомлення. Доставка ID призначена для дедупації, не вистосування автентичності.
Приклад подій та полів вебхока
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_metadata",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Поле | Опис |
|---|---|
delivery_idstring | Стабільний ідентифікатор доставки. Відхилити повідомлення за допомогою цього значення, вона також надсилається в заголовку X-Delivery-Id. |
idstring | Робота ID. |
sourcestring | Запит на джерело даних. |
statusstring | завершено або не вдалося. |
linksarray | Статус і посилання на результат. Повідомлення не включають вміст результатів або ключ API. |
links[].relstring | само або результати. |
links[].hrefstring | Абсолютний менеджмент API URL; автентичний з ключем API. |
links[].methodstring | GET. |
Обробка файлів Bulk
Завантажте одне відео ID на рядок і створюйте роботу Bulk з джерелом: youtube_metadata. Доступні параметри застосовуються до кожного ID в файлі.
Параметри джерела: include_formats, include_chapters. Поставте їх в опції при створенні завдання Bulk.
Отримати завершену колекцію як проявляється і gzip-compressed NDJSON результат частин. Джерела даних також можуть доставити деталі до хмарного сховища, встановлюючи options.result_storage при створенні завдання Bulk. Заощаджуйте прояву і частини в 24 години після завершення роботи Bulk.
Bulk обробка API · Python і cURL · Batch JSON запитів
Створіть робочий потік Bulk для цього джерела · Пауза, резюме і відновлення
Відновлення пароля
Поставка 11-character відео ID, не повний YouTube URL. Важна ID не гарантує доступність відео: видалені, приватні або обмежені відео можуть не виконуватися під час обробки. Кількість місць може бути null; відсутні розділи або формати не самі несуть вакансійні несправності.
Для автентифікації, балансу, запиту та обмеження, використовуйте посилання на спільну помилку. Термін подачі може бути ще створено роботу; перевірити існуючу роботу перед спрацьовуванням.
Покроковий посібник: Перегляд та використання метаданих відео
Ціни
| Плани | Тарифи на користуванняза 1 000 стандартних запитів | Абоненти | Включені кредити за вексельний період |
|---|---|---|---|
| Оплата за використання | 0,50 USD | Без щомісячної плати | Поповнюйте за потреби |
| Micro | 0,40 USD | 49,00 USD / місяць | 1 000 кредити (50,00 USD використання API) включені |
| Starter | 0,35 USD | 199,00 USD / місяць | 4 000 кредити (200,00 USD використання API) включені |
| Pro | 0,30 USD | 499,00 USD / місяць | 10 000 кредити (500,00 USD використання API) включені |
| Scale | 0,25 USD | 999,00 USD / місяць | 20 000 кредити (1 000,00 USD використання API) включені |
| Business | 0,20 USD | 1 999,00 USD / місяць | 40 000 кредити (2 000,00 USD використання API) включені |
Один тариф облікового запису. Спільні кредити для трьох продуктів. Використання, покрите включеними кредитами, повторно не оплачується.
Поточні ціни та ліміти плану