v0.2.0-beta

OpenAPI 3.1.0

Поиск в YouTube

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клиентские библиотеки

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Операции

get/v1/beta/youtube/search

Поиск в YouTube

Ищет видео, каналы и плейлисты на YouTube. engine=youtube и q обязательны. Используйте gl и hl для страны и языка либо sp для пагинации и расширенных фильтров.

Справочная информация о ценах

Тарификация: фиксированная базовая стоимость успешного запроса.
Справочная оценка запроса: USD 0.0029.
Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Query-параметры

engine
enum
константа:
youtube
обязательно

Идентификатор движка SearchApi. Для этого эндпоинта YouTube используйте youtube.
значения
- youtube
gl
Тип: string

Код страны (например, us, jp)
hl
Тип: string

Язык интерфейса
q
Тип: string
обязательно

Поисковый запрос. Требуется средой выполнения и вышестоящим SearchApi.
sp
Тип: string

Токен фильтра YouTube (пагинация или расширенные фильтры)

Ответы

200
Тип: object · ResponseFc5Af1Fcba22_SearchResponse

Успешный ответ
ads
Тип: array object[] · ResponseFc5Af1Fcba22_Ad[]

Результаты объявлений

channel
Тип: object · ResponseFc5Af1Fcba22_AdChannel
id
Тип: string

ID канала

link
Тип: string

Ссылка на канал

title
Тип: string

Название канала

description
Тип: string

Описание объявления

id
Тип: string

ID видео для видеообъявлений

length
Тип: string

Длительность видео для видеообъявлений

link
Тип: string

Ссылка объявления

position
Тип: integer

Позиция в результатах поиска

thumbnail
Тип: string

URL превью объявления

title
Тип: string

Заголовок объявления

website
Тип: string

URL сайта рекламодателя

channels
Тип: array object[] · ResponseFc5Af1Fcba22_Channel[]

Результаты каналов YouTube

description
Тип: string

Описание канала

id
Тип: string

ID канала YouTube

is_verified
Тип: boolean

Подтверждён ли канал

link
Тип: string

Ссылка на канал

position
Тип: integer

Позиция в результатах поиска

subscribers
Тип: integer

Число подписчиков

thumbnail
Тип: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Тип: string

URL расширенного/анимированного превью

static
Тип: string

URL статического превью

title
Тип: string

Название канала

video_count
Тип: integer

Число видео

error
Тип: string

Сообщение об ошибке, если поиск не удался

featured_channel
Тип: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
Тип: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
Тип: string

ID видео

length
Тип: string

Длительность видео

link
Тип: string

Ссылка на видео

subtitle
Тип: string

Подзаголовок видео

title
Тип: string

Заголовок видео

id
Тип: string

ID рекомендуемого канала

link
Тип: string

Ссылка на рекомендуемый канал

subtitle
Тип: string

Подзаголовок рекомендуемого канала

title
Тип: string

Заголовок рекомендуемого канала

videos
Тип: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Видео рекомендуемого канала

channel
Тип: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Тип: string

ID канала

link
Тип: string

Ссылка на канал

title
Тип: string

Название канала

id
Тип: string

ID видео

length
Тип: string

Длительность видео

link
Тип: string

Ссылка на видео

subtitle
Тип: string

Подзаголовок видео

thumbnail
Тип: string

URL превью видео

title
Тип: string

Заголовок видео

movies
Тип: array object[] · ResponseFc5Af1Fcba22_Movie[]

Результаты фильмов

badges
Тип: array string[]

Значки фильма

buttons
Тип: array string[]

Кнопки действий

channel
Тип: object · ResponseFc5Af1Fcba22_MovieChannel
id
Тип: string

ID канала

is_verified
Тип: boolean

Подтверждён ли канал

link
Тип: string

Ссылка на канал

title
Тип: string

Название канала

description
Тип: string

Описание фильма

id
Тип: string

ID видео фильма

length
Тип: string

Длительность фильма

link
Тип: string

Ссылка на фильм

metadata_items
Тип: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
Тип: array string[]

Элементы метаданных внизу

top
Тип: array string[]

Элементы метаданных вверху

position
Тип: integer

Позиция в результатах поиска

thumbnail
Тип: string

URL превью фильма

title
Тип: string

Название фильма

pagination
Тип: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Тип: string

Токен для получения следующей страницы результатов

people_also_search_for
Тип: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Связанные поисковые подсказки

link
Тип: string

Ссылка для выполнения поиска

query
Тип: string

Предлагаемый поисковый запрос

thumbnail
Тип: string

Превью для подсказки

playlists
Тип: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Результаты плейлистов

channel
Тип: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Тип: string

ID канала

is_verified
Тип: boolean

Подтверждён ли канал

link
Тип: string

Ссылка на канал

title
Тип: string

Название канала

id
Тип: string

ID плейлиста

link
Тип: string

Ссылка на плейлист

position
Тип: integer

Позиция в результатах поиска

published_time
Тип: string

Время с момента публикации

thumbnail
Тип: string

URL превью плейлиста

title
Тип: string

Название плейлиста

video_count
Тип: integer

Число видео в плейлисте

videos
Тип: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Видео в плейлисте

id
Тип: string

ID видео

length
Тип: string

Длительность видео

link
Тип: string

Ссылка на видео

title
Тип: string

Заголовок видео

posts
Тип: array object[] · ResponseFc5Af1Fcba22_Posts[]

Результаты публикаций сообщества

items
Тип: array object[] · ResponseFc5Af1Fcba22_Post[]

Публикации сообщества

channel
Тип: object · ResponseFc5Af1Fcba22_PostChannel
id
Тип: string

ID канала

is_verified
Тип: boolean

Подтверждён ли канал

link
Тип: string

Ссылка на канал

thumbnail
Тип: string

URL превью канала

title
Тип: string

Название канала

comments
Тип: string

Число комментариев в виде текста

extracted_comments
Тип: integer

Число комментариев как целое число

extracted_likes
Тип: integer

Число лайков как целое число

id
Тип: string

ID публикации

likes
Тип: string

Число лайков в виде текста

link
Тип: string

Ссылка на публикацию

position
Тип: integer

Позиция в разделе публикаций

published_time
Тип: string

Время с момента публикации

text
Тип: string

Текстовое содержимое публикации

thumbnail
Тип: string

URL превью публикации

position
Тип: integer

Позиция в результатах поиска

section_title
Тип: string

Заголовок раздела публикаций

search_information
Тип: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Тип: string

Исправленный запрос, если применялось исправление орфографии

original_query
Тип: string

Исходный запрос до исправления

original_query_sp
Тип: string

Параметр SP для исходного запроса

state
Тип: string

Состояние исправления запроса, если применимо

total_results
Тип: integer

Общее число найденных результатов

search_metadata
Тип: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Тип: string Формат: date-time
обязательно

Метка времени создания поиска

id
Тип: string
обязательно

Уникальный идентификатор поискового запроса

status
Тип: string
обязательно

Статус поискового запроса

html_url
Тип: string

URL для просмотра результатов в HTML

json_url
Тип: string

URL для просмотра результатов в JSON

parsing_time_taken
Тип: number

Время разбора результатов в секундах

request_time_taken
Тип: number

Время выполнения запроса в секундах

request_url
Тип: string

URL YouTube для этого поиска

total_time_taken
Тип: number

Общее время поиска в секундах

search_parameters
Тип: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Тип: string

Использованный поисковый движок

gl
Тип: string

Использованный код страны

hl
Тип: string

Использованный язык интерфейса

q
Тип: string

Использованный поисковый запрос

sp
Тип: string

Использованный параметр фильтрации/пагинации

sections
Тип: array object[] · ResponseFc5Af1Fcba22_Section[]

Результаты разделов

items
Тип: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Элементы раздела

channel
Тип: object · ResponseFc5Af1Fcba22_SectionChannel
id
Тип: string

ID канала

link
Тип: string

Ссылка на канал

title
Тип: string

Название канала

id
Тип: string

ID элемента

length
Тип: string

Длительность элемента

link
Тип: string

Ссылка на элемент

published_time
Тип: string

Время с момента публикации

thumbnail
Тип: string

URL превью элемента

title
Тип: string

Заголовок элемента

views
Тип: integer

Число просмотров

position
Тип: integer

Позиция в результатах поиска

section_title
Тип: string

Заголовок раздела

shorts
Тип: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Результаты YouTube Shorts

items
Тип: array object[] · ResponseFc5Af1Fcba22_Short[]

Видео Shorts

duration
Тип: string

Длительность Shorts

id
Тип: string

ID видео Shorts

link
Тип: string

Ссылка на Shorts

position
Тип: integer

Позиция в разделе Shorts

thumbnail
Тип: string

URL превью Shorts

title
Тип: string

Название Shorts

views
Тип: integer

Число просмотров

position
Тип: integer

Позиция в результатах поиска

section_title
Тип: string

Заголовок раздела Shorts

suggestions
Тип: array string[]

Поисковые подсказки

videos
Тип: array object[] · ResponseFc5Af1Fcba22_Video[]

Результаты поиска видео

badges
Тип: array string[]

Значки видео

channel
Тип: object · ResponseFc5Af1Fcba22_VideoChannel
id
Тип: string

ID канала

is_verified
Тип: boolean

Подтверждён ли канал

link
Тип: string

Ссылка на канал

thumbnail
Тип: string

URL превью канала

title
Тип: string

Название канала

description
Тип: string

Фрагмент описания видео

id
Тип: string

ID видео YouTube

is_live
Тип: boolean

Идёт ли видео сейчас в прямом эфире

key_moments
Тип: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Ключевые моменты видео

start_seconds
Тип: integer

Время начала момента в секундах

thumbnail
Тип: string

URL превью ключевого момента

title
Тип: string

Заголовок ключевого момента

length
Тип: string

Длительность видео

link
Тип: string

Ссылка на видео

position
Тип: integer

Позиция в результатах поиска

published_time
Тип: string

Время с момента публикации

thumbnail
Тип: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Тип: string

URL расширенного/анимированного превью

static
Тип: string

URL статического превью

title
Тип: string

Заголовок видео

views
Тип: integer

Число просмотров
application/json
400

Запрос не удалось обработать. Проверьте параметры запроса.
401

Требуется действительный API-ключ Felo.
402

Запрос не может быть выполнен: не выполнено требование биллинга.
403

Аккаунту не разрешено выполнять эту операцию.
429

Достигнут лимит запросов или расходов.
502

Сервис не смог выполнить запрос.
503

API или сервис биллинга временно недоступны.
504

Истекло время ожидания обработки запроса.
default

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

application/json

get/v1/beta/youtube/search

curl 'https://openapi.felo.ai/v1/beta/youtube/search?engine=youtube&q=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Показать схему

{
  "search_metadata": {
    "id": "string",
    "status": "string",
    "created_at": "2026-10-26T08:08:16.607Z",
    "request_time_taken": 1,
    "parsing_time_taken": 1,
    "total_time_taken": 1,
    "request_url": "string",
    "html_url": "string",
    "json_url": "string"
  },
  "search_parameters": {
    "engine": "string",
    "q": "string",
    "sp": "string",
    "hl": "string",
    "gl": "string"
  },
  "search_information": {
    "total_results": 1,
    "state": "string",
    "original_query": "string",
    "original_query_sp": "string",
    "corrected_query": "string"
  },
  "suggestions": [
    "string"
  ],
  "ads": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "website": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string"
      },
      "length": "string",
      "thumbnail": "string"
    }
  ],
  "channels": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "is_verified": true,
      "video_count": 1,
      "subscribers": 1,
      "thumbnail": {
        "static": "string",
        "rich": "string"
      }
    }
  ],
  "movies": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true
      },
      "length": "string",
      "metadata_items": {
        "top": [
          "string"
        ],
        "bottom": [
          "string"
        ]
      },
      "badges": [
        "string"
      ],
      "buttons": [
        "string"
      ],
      "thumbnail": "string"
    }
  ],
  "videos": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "description": "string",
      "views": 1,
      "is_live": true,
      "channel": {
        "id": "string",
        "title": "string",
        "link": "string",
        "is_verified": true,
        "thumbnail": "string"
      },
      "length": "string",
      "published_time": "string",
      "badges": [
        "string"
      ],
      "thumbnail": {
        "static": "string",
        "rich": "string"
      },
      "key_moments": [
        {
          "title": "string",
          "start_seconds": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "playlists": [
    {
      "position": 1,
      "id": "string",
      "title": "string",
      "link": "string",
      "video_count": 1,
      "channel": {
        "id": "string",
        "title": "string",
        "is_verified": true,
        "link": "string"
      },
      "published_time": "string",
      "videos": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "length": "string"
        }
      ],
      "thumbnail": "string"
    }
  ],
  "sections": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "id": "string",
          "title": "string",
          "link": "string",
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string"
          },
          "views": 1,
          "published_time": "string",
          "length": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "shorts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "title": "string",
          "link": "string",
          "duration": "string",
          "views": 1,
          "thumbnail": "string"
        }
      ]
    }
  ],
  "posts": [
    {
      "section_title": "string",
      "position": 1,
      "items": [
        {
          "position": 1,
          "id": "string",
          "link": "string",
          "text": "string",
          "likes": "string",
          "extracted_likes": 1,
          "comments": "string",
          "extracted_comments": 1,
          "channel": {
            "id": "string",
            "title": "string",
            "link": "string",
            "is_verified": true,
            "thumbnail": "string"
          },
          "published_time": "string",
          "thumbnail": "string"
        }
      ]
    }
  ],
  "people_also_search_for": [
    {
      "query": "string",
      "link": "string",
      "thumbnail": "string"
    }
  ],
  "featured_channel": {
    "id": "string",
    "title": "string",
    "subtitle": "string",
    "link": "string",
    "highlighted_video": {
      "id": "string",
      "title": "string",
      "subtitle": "string",
      "link": "string",
      "length": "string"
    },
    "videos": [
      {
        "id": "string",
        "title": "string",
        "subtitle": "string",
        "link": "string",
        "length": "string",
        "channel": {
          "id": "string",
          "title": "string",
          "link": "string"
        },
        "thumbnail": "string"
      }
    ]
  },
  "pagination": {
    "next_page_token": "string"
  },
  "error": "string"
}

Успешный ответ

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Поиск в YouTube

АутентификацияRequired

YouTube Search

Поиск в YouTube

Справочная информация о ценах

Нужна помощь?