데이터 API / YouTube / Search

YouTube Search

Search YouTube for videos, channels and playlists. engine=youtube and q are required. Use gl and hl for country and language, or sp for pagination and advanced filters.

파라미터

쿼리

enginestring필수
허용 값: youtube
SearchApi engine identifier. Use youtube for this YouTube endpoint.
qstring필수
Search query. Required by runtime and upstream SearchApi.
spstring선택
YouTube filter token (pagination or advanced filters)
glstring선택
Country code (e.g. us, jp)
hlstring선택
Interface language

요청 예시

curl -G "https://openapi.felo.ai/v1/beta/youtube/search" \
  --data-urlencode "engine=<string>" \
  --data-urlencode "q=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

응답

응답 필드

search_metadataobject선택
idstring선택
statusstring선택
created_atstring선택
request_time_takennumber선택
parsing_time_takennumber선택
total_time_takennumber선택
request_urlstring선택
html_urlstring선택
json_urlstring선택
search_parametersobject선택
search_informationobject선택
total_resultsinteger선택
videosobject[]선택
positioninteger선택
idstring선택
titlestring선택
linkstring선택
descriptionstring선택
thumbnailstring선택
published_timestring선택
lengthstring선택
views선택
channelobject선택
is_liveboolean선택
badgesstring[]선택
channelsobject[]선택
positioninteger선택
idstring선택
titlestring선택
linkstring선택
descriptionstring선택
thumbnailstring선택
subscribersstring선택
shortsobject[]선택
positioninteger선택
section_titlestring선택
itemsobject[]선택
sectionsobject[]선택
positioninteger선택
section_titlestring선택
itemsobject[]선택
playlistsobject[]선택
adsobject[]선택
paginationobject선택
next_page_tokenstring선택