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 を使用します。

料金の参考情報

計測方法：成功リクエストあたりの固定コスト基準。
参考リクエスト見積もり：0.0029 USD。
参照用の顧客乗数：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[]

ショート動画

duration
型: string

ショートの長さ

id
型: string

ショートの動画 ID

link
型: string

ショートへのリンク

position
型: integer

ショートセクション内の位置

thumbnail
型: string

ショートのサムネイル画像 URL

title
型: string

ショートのタイトル

views
型: integer

再生回数

position
型: integer

検索結果内の位置

section_title
型: string

ショートセクションのタイトル

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

成功レスポンス

ヘルプが必要ですか？

API・請求・アカウントのご質問はサポートへ。
Discord で Felo の開発者と交流できます。
更新履歴をご覧ください。
ボリューム価格や購買についてのご相談は営業窓口へ。
LLM での構築をお考えですか？llms.txt をご覧ください。

YouTube 検索

認証Required

YouTube Search

YouTube 検索

料金の参考情報

ヘルプが必要ですか？