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.

Параметри запиту

engine
перелік
константа:
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

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

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"
}

Успішна відповідь

Пошук у YouTube

АвтентифікаціяRequired

YouTube Search

Пошук у YouTube

Довідкові ціни