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

YouTube 채널 ID

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

HTML 결과를 보는 URL

json_url
유형: string

JSON 결과를 보는 URL

parsing_time_taken
유형: number

결과를 파싱하는 데 걸린 시간(초)

request_time_taken
유형: number

요청을 수행하는 데 걸린 시간(초)

request_url
유형: string

이 검색의 YouTube URL

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

Shorts 동영상 ID

link
유형: string

Shorts 링크

position
유형: integer

Shorts 섹션 내 위치

thumbnail
유형: string

Shorts 썸네일 URL

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

YouTube 동영상 ID

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

유효한 Felo API 키가 필요합니다.
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.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"
}

성공 응답

도움이 필요하신가요?

API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
Discord에서 Felo 개발자와 대화해 보세요.
변경 내역을 확인해 보세요.
대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.

YouTube 검색

인증Required

YouTube Search

YouTube 검색

가격 참고

도움이 필요하신가요?