Дані YouTube

Застосунок може брати реальні дані двома шляхами. Вони не конкурують — їх можна поєднати, і тоді один страхує інший.

	yt-dlp (локально)	YouTube Data API
Потрібен ключ	ні	так
Добова квота	немає	10 000 юнітів
Швидкість	висока (локально, з кешем)	обмежена квотою
Точні дати публікації	так	так
Крива уваги аудиторії	так	ні
Субтитри й коментарі	так	коментарі — так, субтитри — ні
Працює без інтернету	ні	ні

Що таке крива уваги і чому це важливо

YouTube віддає для кожного відео 100 точок, які показують, як поводиться увага аудиторії протягом відео. Ці дані бачить автор у студії — і саме їх зазвичай не показують для чужих каналів. Застосунок дістає їх і для чужого відео.

Важливо про природу цих чисел. Значення нормовані до найвищої точки відео, а не до старту. Тобто це не «відсоток утримання», а рельєф уваги: де саме увага сягає піку, а де провалюється відносно піку. Застосунок прямо так і підписує графік, щоб не вводити в оману.

Що з цього можна взяти практично:

Пік уваги — момент, який найчастіше передивляються або перемотують назад. Це найцінніше місце відео, його варто повторити у своєму.
Найглибший спад — епізод, де увага обвалюється. Якщо таке саме місце є в конкурентів — це структурна помилка ніші, і ви можете зробити краще.
Рівність кривої — наскільки увага тримається без стрибків. Нерівна крива зазвичай означає, що відео роздуте посередині.

Гібридний режим

Режим Гібрид спершу пробує локальний yt-dlp, а якщо не вийшло — звертається до офіційного API. Це найнадійніший варіант: безкоштовні дані надходять локально, а квота витрачається тільки тоді, коли локальний шлях справді не спрацював.

Квота: скільки це в пошуках

Один пошуковий запит коштує близько 100 юнітів, один запит деталей відео — 1 юніт. За добу з 10 000 юнітів виходить приблизно 100 пошуків. Саме тому для масового сканування радимо yt-dlp: у нього квоти немає взагалі.

Кеш

Усе, що застосунок дістав із YouTube, зберігається локально, щоб не турбувати YouTube повторно. Терміни: каталог каналу — 6 годин, дані відео — 6 годин, пошук — 1 година, субтитри — 30 днів.

Режим	Що робить
Автоматично	yt-dlp, якщо він є; інакше API; якщо немає нічого — працює сама модель.
yt-dlp	Тільки локально. Ключ і квота не потрібні.
YouTube API	Тільки офіційний шлях.
Гібрид	yt-dlp, а при невдачі — API.
Вимкнено	Без реальних даних: лише міркування моделі.

Кеш можна очистити в налаштуваннях — кнопка Очистити кеш. Це корисно, якщо цифри у відео змінилися, а ви хочете свіжі.

Наскільки свіжі дані

yt-dlp віддає те саме, що бачить звичайний відвідувач YouTube у момент запиту. Перегляди оновлюються самостійно протягом годин, тож маленькі розбіжності з тим, що ви бачите на сторінці відео, — це нормально, а не помилка.