v0.2.0-beta

OpenAPI 3.1.0

Wyszukiwanie w YouTube

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operacje

get/v1/beta/youtube/search

Wyszukiwanie w YouTube

Przeszukuje YouTube w poszukiwaniu filmów, kanałów i playlist. engine=youtube i q są wymagane. Użyj gl i hl dla kraju i języka lub sp dla paginacji i filtrów zaawansowanych.

Cennik referencyjny

Rozliczanie: stała podstawa kosztu za udane żądanie.
Szacunek referencyjny dla żądania: USD 0.0029.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Parametry zapytania

engine
enum
const:
youtube
wymagane

Identyfikator silnika SearchApi. Dla tego endpointu YouTube użyj youtube.
wartości
- youtube
gl
Typ: string

Kod kraju (np. us, jp)
hl
Typ: string

Język interfejsu
q
Typ: string
wymagane

Zapytanie wyszukiwania. Wymagane przez środowisko uruchomieniowe i upstream SearchApi.
sp
Typ: string

Token filtrów YouTube (paginacja lub filtry zaawansowane)

Odpowiedzi

200
Typ: object · ResponseFc5Af1Fcba22_SearchResponse

Pomyślna odpowiedź
ads
Typ: array object[] · ResponseFc5Af1Fcba22_Ad[]

Wyniki reklam

channel
Typ: object · ResponseFc5Af1Fcba22_AdChannel
id
Typ: string

Identyfikator kanału

link
Typ: string

Link do kanału

title
Typ: string

Nazwa kanału

description
Typ: string

Opis reklamy

id
Typ: string

Identyfikator wideo dla reklam wideo

length
Typ: string

Czas trwania wideo dla reklam wideo

link
Typ: string

Link do reklamy

position
Typ: integer

Pozycja w wynikach wyszukiwania

thumbnail
Typ: string

Adres URL miniatury reklamy

title
Typ: string

Tytuł reklamy

website
Typ: string

Adres URL witryny reklamodawcy

channels
Typ: array object[] · ResponseFc5Af1Fcba22_Channel[]

Wyniki kanałów YouTube

description
Typ: string

Opis kanału

id
Typ: string

Identyfikator kanału YouTube

is_verified
Typ: boolean

Czy kanał jest zweryfikowany

link
Typ: string

Link do kanału

position
Typ: integer

Pozycja w wynikach wyszukiwania

subscribers
Typ: integer

Liczba subskrybentów

thumbnail
Typ: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Typ: string

Adres URL miniatury animowanej/bogatej

static
Typ: string

Adres URL statycznej miniatury

title
Typ: string

Nazwa kanału

video_count
Typ: integer

Liczba filmów

error
Typ: string

Komunikat o błędzie, jeśli wyszukiwanie nie powiodło się

featured_channel
Typ: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
Typ: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
Typ: string

Identyfikator wideo

length
Typ: string

Czas trwania wideo

link
Typ: string

Link do wideo

subtitle
Typ: string

Podtytuł wideo

title
Typ: string

Tytuł wideo

id
Typ: string

Identyfikator wyróżnionego kanału

link
Typ: string

Link do wyróżnionego kanału

subtitle
Typ: string

Podtytuł wyróżnionego kanału

title
Typ: string

Tytuł wyróżnionego kanału

videos
Typ: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Filmy wyróżnionego kanału

channel
Typ: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Typ: string

Identyfikator kanału

link
Typ: string

Link do kanału

title
Typ: string

Nazwa kanału

id
Typ: string

Identyfikator wideo

length
Typ: string

Czas trwania wideo

link
Typ: string

Link do wideo

subtitle
Typ: string

Podtytuł wideo

thumbnail
Typ: string

Adres URL miniatury wideo

title
Typ: string

Tytuł wideo

movies
Typ: array object[] · ResponseFc5Af1Fcba22_Movie[]

Wyniki filmów

badges
Typ: array string[]

Plakietki filmu

buttons
Typ: array string[]

Przyciski akcji

channel
Typ: object · ResponseFc5Af1Fcba22_MovieChannel
id
Typ: string

Identyfikator kanału

is_verified
Typ: boolean

Czy kanał jest zweryfikowany

link
Typ: string

Link do kanału

title
Typ: string

Nazwa kanału

description
Typ: string

Opis filmu

id
Typ: string

Identyfikator wideo filmu

length
Typ: string

Czas trwania filmu

link
Typ: string

Link do filmu

metadata_items
Typ: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
Typ: array string[]

Dolne elementy metadanych

top
Typ: array string[]

Górne elementy metadanych

position
Typ: integer

Pozycja w wynikach wyszukiwania

thumbnail
Typ: string

Adres URL miniatury filmu

title
Typ: string

Tytuł filmu

pagination
Typ: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Typ: string

Token do pobrania następnej strony wyników

people_also_search_for
Typ: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Powiązane sugestie wyszukiwania

link
Typ: string

Link do wykonania wyszukiwania

query
Typ: string

Sugerowane zapytanie wyszukiwania

thumbnail
Typ: string

Miniatura sugestii

playlists
Typ: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Wyniki playlist

channel
Typ: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Typ: string

Identyfikator kanału

is_verified
Typ: boolean

Czy kanał jest zweryfikowany

link
Typ: string

Link do kanału

title
Typ: string

Nazwa kanału

id
Typ: string

Identyfikator playlisty

link
Typ: string

Link do playlisty

position
Typ: integer

Pozycja w wynikach wyszukiwania

published_time
Typ: string

Czas od publikacji

thumbnail
Typ: string

Adres URL miniatury playlisty

title
Typ: string

Tytuł playlisty

video_count
Typ: integer

Liczba filmów w playliście

videos
Typ: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Filmy w playliście

id
Typ: string

Identyfikator wideo

length
Typ: string

Czas trwania wideo

link
Typ: string

Link do wideo

title
Typ: string

Tytuł wideo

posts
Typ: array object[] · ResponseFc5Af1Fcba22_Posts[]

Wyniki postów społeczności

items
Typ: array object[] · ResponseFc5Af1Fcba22_Post[]

Posty społeczności

channel
Typ: object · ResponseFc5Af1Fcba22_PostChannel
id
Typ: string

Identyfikator kanału

is_verified
Typ: boolean

Czy kanał jest zweryfikowany

link
Typ: string

Link do kanału

thumbnail
Typ: string

Adres URL miniatury kanału

title
Typ: string

Nazwa kanału

comments
Typ: string

Liczba komentarzy (tekst)

extracted_comments
Typ: integer

Liczba komentarzy jako liczba całkowita

extracted_likes
Typ: integer

Liczba polubień jako liczba całkowita

id
Typ: string

Identyfikator posta

likes
Typ: string

Liczba polubień (tekst)

link
Typ: string

Link do posta

position
Typ: integer

Pozycja w sekcji postów

published_time
Typ: string

Czas od publikacji

text
Typ: string

Treść tekstowa posta

thumbnail
Typ: string

Adres URL miniatury posta

position
Typ: integer

Pozycja w wynikach wyszukiwania

section_title
Typ: string

Tytuł sekcji postów

search_information
Typ: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Typ: string

Poprawione zapytanie, jeśli zastosowano korektę pisowni

original_query
Typ: string

Oryginalne zapytanie przed korektą

original_query_sp
Typ: string

Parametr SP dla oryginalnego zapytania

state
Typ: string

Stan korekty zapytania, jeśli dotyczy

total_results
Typ: integer

Łączna liczba znalezionych wyników

search_metadata
Typ: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Typ: string Format: date-time
wymagane

Znacznik czasu utworzenia wyszukiwania

id
Typ: string
wymagane

Unikalny identyfikator żądania wyszukiwania

status
Typ: string
wymagane

Status żądania wyszukiwania

html_url
Typ: string

Adres URL do wyświetlenia wyników HTML

json_url
Typ: string

Adres URL do wyświetlenia wyników JSON

parsing_time_taken
Typ: number

Czas parsowania wyników w sekundach

request_time_taken
Typ: number

Czas wykonania żądania w sekundach

request_url
Typ: string

Adres URL YouTube dla tego wyszukiwania

total_time_taken
Typ: number

Łączny czas wyszukiwania w sekundach

search_parameters
Typ: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Typ: string

Użyta wyszukiwarka

gl
Typ: string

Użyty kod kraju

hl
Typ: string

Użyty język interfejsu

q
Typ: string

Użyte zapytanie wyszukiwania

sp
Typ: string

Użyty parametr filtra/paginacji

sections
Typ: array object[] · ResponseFc5Af1Fcba22_Section[]

Wyniki sekcji

items
Typ: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Elementy w sekcji

channel
Typ: object · ResponseFc5Af1Fcba22_SectionChannel
id
Typ: string

Identyfikator kanału

link
Typ: string

Link do kanału

title
Typ: string

Nazwa kanału

id
Typ: string

Identyfikator elementu

length
Typ: string

Czas trwania elementu

link
Typ: string

Link do elementu

published_time
Typ: string

Czas od publikacji

thumbnail
Typ: string

Adres URL miniatury elementu

title
Typ: string

Tytuł elementu

views
Typ: integer

Liczba wyświetleń

position
Typ: integer

Pozycja w wynikach wyszukiwania

section_title
Typ: string

Tytuł sekcji

shorts
Typ: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Wyniki YouTube Shorts

items
Typ: array object[] · ResponseFc5Af1Fcba22_Short[]

Wideo Shorts

duration
Typ: string

Czas trwania shorta

id
Typ: string

Identyfikator wideo Shorts

link
Typ: string

Link do shorta

position
Typ: integer

Pozycja w sekcji shorts

thumbnail
Typ: string

Adres URL miniatury shorta

title
Typ: string

Tytuł shorta

views
Typ: integer

Liczba wyświetleń

position
Typ: integer

Pozycja w wynikach wyszukiwania

section_title
Typ: string

Tytuł sekcji shorts

suggestions
Typ: array string[]

Sugestie zapytań wyszukiwania

videos
Typ: array object[] · ResponseFc5Af1Fcba22_Video[]

Wyniki wyszukiwania wideo

badges
Typ: array string[]

Plakietki wideo

channel
Typ: object · ResponseFc5Af1Fcba22_VideoChannel
id
Typ: string

Identyfikator kanału

is_verified
Typ: boolean

Czy kanał jest zweryfikowany

link
Typ: string

Link do kanału

thumbnail
Typ: string

Adres URL miniatury kanału

title
Typ: string

Nazwa kanału

description
Typ: string

Fragment opisu wideo

id
Typ: string

Identyfikator filmu YouTube

is_live
Typ: boolean

Czy wideo jest obecnie transmitowane na żywo

key_moments
Typ: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Kluczowe momenty w wideo

start_seconds
Typ: integer

Czas rozpoczęcia momentu w sekundach

thumbnail
Typ: string

Adres URL miniatury kluczowego momentu

title
Typ: string

Tytuł kluczowego momentu

length
Typ: string

Czas trwania wideo

link
Typ: string

Link do wideo

position
Typ: integer

Pozycja w wynikach wyszukiwania

published_time
Typ: string

Czas od publikacji

thumbnail
Typ: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Typ: string

Adres URL miniatury animowanej/bogatej

static
Typ: string

Adres URL statycznej miniatury

title
Typ: string

Tytuł wideo

views
Typ: integer

Liczba wyświetleń
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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'

Pokaż schemat

{
  "search_metadata": {
    "id": "string",
    "status": "string",
    "created_at": "2026-10-26T08:08:16.678Z",
    "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"
}

Pomyślna odpowiedź

Wyszukiwanie w YouTube

UwierzytelnianieRequired

YouTube Search

Wyszukiwanie w YouTube

Cennik referencyjny