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 美元。
參考客戶乘數：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'

顯示 Schema

{
  "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 搜尋

計費參考

需要協助嗎？