v0.2.0-beta

OpenAPI 3.1.0

Vyhledávání na YouTube

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operace

get/v1/beta/youtube/search

Vyhledávání na YouTube

Prohledává YouTube a hledá videa, kanály a playlisty. engine=youtube a q jsou povinné. Pomocí gl a hl nastavte zemi a jazyk nebo pomocí sp stránkování a pokročilé filtry.

Cenová reference

Účtování: pevná nákladová základna za úspěšný požadavek.
Referenční odhad požadavku: USD 0.0029.
Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Parametry dotazu

engine
enum
const:
youtube
povinné

Identifikátor enginu SearchApi. Pro tento endpoint YouTube použijte youtube.
hodnoty
- youtube
gl
Typ: string

Kód země (např. us, jp)
hl
Typ: string

Jazyk rozhraní
q
Typ: string
povinné

Vyhledávací dotaz. Vyžaduje jej runtime a upstream SearchApi.
sp
Typ: string

Filtrovací token YouTube (stránkování nebo pokročilé filtry)

Odpovědi

200
Typ: object · ResponseFc5Af1Fcba22_SearchResponse

Úspěšná odpověď
ads
Typ: array object[] · ResponseFc5Af1Fcba22_Ad[]

Výsledky reklam

channel
Typ: object · ResponseFc5Af1Fcba22_AdChannel
id
Typ: string

ID kanálu

link
Typ: string

Odkaz na kanál

title
Typ: string

Název kanálu

description
Typ: string

Popis reklamy

id
Typ: string

ID videa pro videoreklamy

length
Typ: string

Délka videa pro videoreklamy

link
Typ: string

Odkaz na reklamu

position
Typ: integer

Pozice ve výsledcích vyhledávání

thumbnail
Typ: string

URL náhledu reklamy

title
Typ: string

Název reklamy

website
Typ: string

URL webu inzerenta

channels
Typ: array object[] · ResponseFc5Af1Fcba22_Channel[]

Výsledky kanálů YouTube

description
Typ: string

Popis kanálu

id
Typ: string

ID kanálu YouTube

is_verified
Typ: boolean

Zda je kanál ověřený

link
Typ: string

Odkaz na kanál

position
Typ: integer

Pozice ve výsledcích vyhledávání

subscribers
Typ: integer

Počet odběratelů

thumbnail
Typ: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Typ: string

URL animovaného/bohatého náhledu

static
Typ: string

URL statického náhledu

title
Typ: string

Název kanálu

video_count
Typ: integer

Počet videí

error
Typ: string

Chybová zpráva, pokud vyhledávání selhalo

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

ID videa

length
Typ: string

Délka videa

link
Typ: string

Odkaz na video

subtitle
Typ: string

Podtitul videa

title
Typ: string

Název videa

id
Typ: string

ID zvýrazněného kanálu

link
Typ: string

Odkaz na zvýrazněný kanál

subtitle
Typ: string

Podtitul zvýrazněného kanálu

title
Typ: string

Název zvýrazněného kanálu

videos
Typ: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Videa zvýrazněného kanálu

channel
Typ: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Typ: string

ID kanálu

link
Typ: string

Odkaz na kanál

title
Typ: string

Název kanálu

id
Typ: string

ID videa

length
Typ: string

Délka videa

link
Typ: string

Odkaz na video

subtitle
Typ: string

Podtitul videa

thumbnail
Typ: string

URL náhledu videa

title
Typ: string

Název videa

movies
Typ: array object[] · ResponseFc5Af1Fcba22_Movie[]

Výsledky filmů

badges
Typ: array string[]

Odznaky filmu

buttons
Typ: array string[]

Tlačítka akcí

channel
Typ: object · ResponseFc5Af1Fcba22_MovieChannel
id
Typ: string

ID kanálu

is_verified
Typ: boolean

Zda je kanál ověřený

link
Typ: string

Odkaz na kanál

title
Typ: string

Název kanálu

description
Typ: string

Popis filmu

id
Typ: string

ID videa filmu

length
Typ: string

Délka filmu

link
Typ: string

Odkaz na film

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

Dolní položky metadat

top
Typ: array string[]

Horní položky metadat

position
Typ: integer

Pozice ve výsledcích vyhledávání

thumbnail
Typ: string

URL náhledu filmu

title
Typ: string

Název filmu

pagination
Typ: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Typ: string

Token pro načtení další stránky výsledků

people_also_search_for
Typ: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Související návrhy vyhledávání

link
Typ: string

Odkaz pro provedení vyhledávání

query
Typ: string

Navrhovaný vyhledávací dotaz

thumbnail
Typ: string

Náhled návrhu

playlists
Typ: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Výsledky playlistů

channel
Typ: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Typ: string

ID kanálu

is_verified
Typ: boolean

Zda je kanál ověřený

link
Typ: string

Odkaz na kanál

title
Typ: string

Název kanálu

id
Typ: string

ID playlistu

link
Typ: string

Odkaz na playlist

position
Typ: integer

Pozice ve výsledcích vyhledávání

published_time
Typ: string

Čas od zveřejnění

thumbnail
Typ: string

URL náhledu playlistu

title
Typ: string

Název playlistu

video_count
Typ: integer

Počet videí v playlistu

videos
Typ: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Videa v playlistu

id
Typ: string

ID videa

length
Typ: string

Délka videa

link
Typ: string

Odkaz na video

title
Typ: string

Název videa

posts
Typ: array object[] · ResponseFc5Af1Fcba22_Posts[]

Výsledky příspěvků komunity

items
Typ: array object[] · ResponseFc5Af1Fcba22_Post[]

Příspěvky komunity

channel
Typ: object · ResponseFc5Af1Fcba22_PostChannel
id
Typ: string

ID kanálu

is_verified
Typ: boolean

Zda je kanál ověřený

link
Typ: string

Odkaz na kanál

thumbnail
Typ: string

URL náhledu kanálu

title
Typ: string

Název kanálu

comments
Typ: string

Počet komentářů (text)

extracted_comments
Typ: integer

Počet komentářů jako celé číslo

extracted_likes
Typ: integer

Počet lajků jako celé číslo

id
Typ: string

ID příspěvku

likes
Typ: string

Počet lajků (text)

link
Typ: string

Odkaz na příspěvek

position
Typ: integer

Pozice v sekci příspěvků

published_time
Typ: string

Čas od zveřejnění

text
Typ: string

Textový obsah příspěvku

thumbnail
Typ: string

URL náhledu příspěvku

position
Typ: integer

Pozice ve výsledcích vyhledávání

section_title
Typ: string

Název sekce příspěvků

search_information
Typ: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Typ: string

Opravený dotaz, pokud byla použita oprava pravopisu

original_query
Typ: string

Původní dotaz před opravou

original_query_sp
Typ: string

Parametr SP pro původní dotaz

state
Typ: string

Stav opravy dotazu, pokud je relevantní

total_results
Typ: integer

Celkový počet nalezených výsledků

search_metadata
Typ: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Typ: string Formát: date-time
povinné

Časové razítko vytvoření vyhledávání

id
Typ: string
povinné

Jedinečný identifikátor požadavku vyhledávání

status
Typ: string
povinné

Stav požadavku vyhledávání

html_url
Typ: string

URL pro zobrazení výsledků HTML

json_url
Typ: string

URL pro zobrazení výsledků JSON

parsing_time_taken
Typ: number

Čas parsování výsledků v sekundách

request_time_taken
Typ: number

Čas provedení požadavku v sekundách

request_url
Typ: string

URL YouTube pro toto vyhledávání

total_time_taken
Typ: number

Celkový čas vyhledávání v sekundách

search_parameters
Typ: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Typ: string

Použitý vyhledávač

gl
Typ: string

Použitý kód země

hl
Typ: string

Použitý jazyk rozhraní

q
Typ: string

Použitý vyhledávací dotaz

sp
Typ: string

Použitý parametr filtru/stránkování

sections
Typ: array object[] · ResponseFc5Af1Fcba22_Section[]

Výsledky sekcí

items
Typ: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Položky v sekci

channel
Typ: object · ResponseFc5Af1Fcba22_SectionChannel
id
Typ: string

ID kanálu

link
Typ: string

Odkaz na kanál

title
Typ: string

Název kanálu

id
Typ: string

ID položky

length
Typ: string

Délka položky

link
Typ: string

Odkaz na položku

published_time
Typ: string

Čas od zveřejnění

thumbnail
Typ: string

URL náhledu položky

title
Typ: string

Název položky

views
Typ: integer

Počet zhlédnutí

position
Typ: integer

Pozice ve výsledcích vyhledávání

section_title
Typ: string

Název sekce

shorts
Typ: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Výsledky YouTube Shorts

items
Typ: array object[] · ResponseFc5Af1Fcba22_Short[]

Videa Shorts

duration
Typ: string

Délka shortu

id
Typ: string

ID videa Shorts

link
Typ: string

Odkaz na short

position
Typ: integer

Pozice v sekci shorts

thumbnail
Typ: string

URL náhledu shortu

title
Typ: string

Název shortu

views
Typ: integer

Počet zhlédnutí

position
Typ: integer

Pozice ve výsledcích vyhledávání

section_title
Typ: string

Název sekce shorts

suggestions
Typ: array string[]

Návrhy vyhledávacích dotazů

videos
Typ: array object[] · ResponseFc5Af1Fcba22_Video[]

Výsledky vyhledávání videí

badges
Typ: array string[]

Odznaky videa

channel
Typ: object · ResponseFc5Af1Fcba22_VideoChannel
id
Typ: string

ID kanálu

is_verified
Typ: boolean

Zda je kanál ověřený

link
Typ: string

Odkaz na kanál

thumbnail
Typ: string

URL náhledu kanálu

title
Typ: string

Název kanálu

description
Typ: string

Úryvek popisu videa

id
Typ: string

ID videa YouTube

is_live
Typ: boolean

Zda je video aktuálně vysíláno živě

key_moments
Typ: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Klíčové momenty ve videu

start_seconds
Typ: integer

Čas začátku momentu v sekundách

thumbnail
Typ: string

URL náhledu klíčového momentu

title
Typ: string

Název klíčového momentu

length
Typ: string

Délka videa

link
Typ: string

Odkaz na video

position
Typ: integer

Pozice ve výsledcích vyhledávání

published_time
Typ: string

Čas od zveřejnění

thumbnail
Typ: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Typ: string

URL animovaného/bohatého náhledu

static
Typ: string

URL statického náhledu

title
Typ: string

Název videa

views
Typ: integer

Počet zhlédnutí
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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'

Zobrazit schéma

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

Úspěšná odpověď

Vyhledávání na YouTube

OvěřováníRequired

YouTube Search

Vyhledávání na YouTube

Cenová reference