YouTube Поиск API
Ищет в YouTube и возвращает подходящие видео: название, канал, число просмотров, длительность и время публикации.
0,43 USD/1 тыс. запросов, оплата за запрос, без подписки.
Apollo 11 Moon Landing: Restored Footage
14.9M views · 2 years ago
NASA
{"id": "BzSzwqb-OEE","url": "https://www.youtube.com/watch?v=BzSzwqb-OEE","title": "Apollo 11 Moon Landing: Restored Footage","channel": "NASA","views": 14860541,"lengthText": "4:14","publishedTime": "2 years ago","authorAvatarUrl": string,... ещё полей: 3}
Цены и поставщики
Цена API YouTube Поиск: один API, поставщиков 5, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
Попробовать
Получите YouTube Поиск одним запросом
В этом примере показано полей: 10 из 16. Все поля
{
"found": true,
"data": {
"videos": [
{
"id": "BzSzwqb-OEE",
"url": "https://www.youtube.com/watch?v=BzSzwqb-OEE",
"title": "Apollo 11 Moon Landing: Restored Footage",
"channel": "NASA",
"views": 14860541,
"lengthText": "4:14",
"publishedTime": "2 years ago"
}
]
}
}Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.
Справочник
Один запрос, один формат ответа.
Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.
Проверено 2026-11-21 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- querystring
apollo 11 landing
Поисковый запрос YouTube.
- cursorstring
Токен продолжения из предыдущего ответа для постраничной выдачи.
- requireCursorboolean
Устарело; вместо этого отправляйте `requireFields: ["nextCursor"]`, это делает ровно то же самое. Установите true, если собираетесь листать результаты, тогда запрос обслужит только источник, который может вернуть nextCursor. Если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Это может поднять вашу цену: если самый дешёвый источник не умеет листать страницы, обслуживает тот, кто умеет, и вам называют и списывают его цену. Параметр по-прежнему принимается, чтобы вызывающие, которые его уже отправляют, продолжали работать.
- requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `nextCursor`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в результате, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания. При постраничном обходе это действует только на первую страницу; следующие страницы остаются у источника, который выбрала эта страница, по названной ей цене.
- sortByenum
Порядок сортировки: "relevance" (по умолчанию) или "popular" (самые просматриваемые).
- uploadDateenum
Фильтр по давности загрузки. Не указывайте, чтобы получить любое время.
Ответ
JSON, по одному примеру значения на поле.
- nextCursorstringможет потребовать
Opaque cursor for the next page of results, or null when this lane has no more. Pass it back as cursor to continue.
Populated whenever the provider has data for the entity.
- authorAvatarUrlstring
URL of the publishing channel's avatar image.
- authorIdstring
YouTube channel ID of the publishing channel.
- channelstring
NASA
Populated whenever the provider has data for the entity.
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time), estimated from the relative age YouTube shows such as "4 days ago", so it can be off by up to that label's unit (a day, a week, a month). Multiply by 1000 for a JS Date in milliseconds.
- idstring
BzSzwqb-OEE
Populated whenever the provider has data for the entity.
- imagestring
URL of the video thumbnail image, tracking query parameters stripped.
- lengthTextstring
4:14
- publishedTimestring
2 years ago
Populated whenever the provider has data for the entity.
- titlestring
Apollo 11 Moon Landing: Restored Footage
Populated whenever the provider has data for the entity.
- urlstring
https://www.youtube.com/watch?v=BzSzwqb-OEE
Populated whenever the provider has data for the entity.
- viewsinteger
14860541
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Продаёте этот API? Полная схема, которую должен возвращать ваш эндпоинт.
Вопросы и ответы
Об API YouTube Поиск
AnyAPI YouTube Поиск API возвращает данные YouTube в виде нормализованного JSON одним вызовом POST к /v1/run/youtube.search. Ищет в YouTube и возвращает подходящие видео: название, канал, число просмотров, длительность и время публикации. AnyAPI направляет каждый запрос по источникам (их 5) и автоматически переключается, если один из них отказывает. Это стоит от 0,43 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 100,0% вызовов YouTube Поиск через AnyAPI завершились успешно, медианное время ответа 2,1 с, измерено вызовов: 219 679.