Felo API PlatformFelo API Platform
endpoint ทั้งหมดของ YouTube
v0.2.0-beta
OpenAPI 3.1.0

ค้นหา YouTube

เซิร์ฟเวอร์:https://openapi.felo.ai
ไลบรารีไคลเอนต์

ค้นหา YouTube

​

ค้นหา YouTube สำหรับวิดีโอ ช่อง และเพลย์ลิสต์ engine=youtube และ q เป็นฟิลด์บังคับ ใช้ gl และ hl สำหรับประเทศและภาษา หรือ sp สำหรับการแบ่งหน้าและตัวกรองขั้นสูง

ข้อมูลอ้างอิงราคา

  • การวัดปริมาณการใช้งาน: ฐานต้นทุนคำขอที่สำเร็จแบบคงที่
  • ค่าประมาณคำขออ้างอิง: USD 0.0029
  • ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

พารามิเตอร์ในคิวรี
  • engine
    enum
    const:  
    youtube
    จำเป็น

    ตัวระบุเอนจิน SearchApi ใช้ youtube สำหรับ endpoint YouTube นี้

    ค่า
    • youtube
  • gl
    ประเภท: string

    รหัสประเทศ (เช่น us, jp)

  • hl
    ประเภท: string

    ภาษาของอินเทอร์เฟซ

  • q
    ประเภท: string
    จำเป็น

    คำค้น จำเป็นตาม runtime และ 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

        ID ช่อง YouTube

      • 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

        URL สำหรับดูผลลัพธ์ HTML

      • json_url
        ประเภท: string

        URL สำหรับดูผลลัพธ์ JSON

      • parsing_time_taken
        ประเภท: number

        เวลาที่ใช้ในการแยกวิเคราะห์ผลลัพธ์เป็นวินาที

      • request_time_taken
        ประเภท: number

        เวลาที่ใช้ในการส่งคำขอเป็นวินาที

      • request_url
        ประเภท: string

        URL YouTube สำหรับการค้นหานี้

      • 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[]

        วิดีโอ Short

        • duration
          ประเภท: string

          ความยาว Short

        • id
          ประเภท: string

          ID วิดีโอ Short

        • link
          ประเภท: string

          ลิงก์ไปยัง Short

        • position
          ประเภท: integer

          ตำแหน่งในส่วน Shorts

        • thumbnail
          ประเภท: string

          URL ภาพขนาดย่อของ Short

        • title
          ประเภท: string

          ชื่อ Short

        • 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

        ID วิดีโอ YouTube

      • 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

    จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

  • 402

    ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน

  • 403

    บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้

  • 429

    ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว

  • 502

    บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้

  • 503

    API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว

  • 504

    บริการหมดเวลาระหว่างประมวลผลคำขอ

  • default

    การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

    application/json
Request Example for 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"
}
YouTube Search