YouTube Search
Search videos, channels and playlists.
ค้นหา YouTube
ค้นหา YouTube สำหรับวิดีโอ ช่อง และเพลย์ลิสต์ engine=youtube และ q เป็นฟิลด์บังคับ ใช้ gl และ hl สำหรับประเทศและภาษา หรือ sp สำหรับการแบ่งหน้าและตัวกรองขั้นสูง
ข้อมูลอ้างอิงราคา
- การวัดปริมาณการใช้งาน: ฐานต้นทุนคำขอที่สำเร็จแบบคงที่
- ค่าประมาณคำขออ้างอิง: USD 0.0029
- ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว
เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo
- enumengineconst:youtubeจำเป็น
ตัวระบุเอนจิน SearchApi ใช้
youtubeสำหรับ endpoint YouTube นี้ค่า- youtube
- ประเภท: stringgl
รหัสประเทศ (เช่น us, jp)
- ประเภท: stringhl
ภาษาของอินเทอร์เฟซ
- ประเภท: stringqจำเป็น
คำค้น จำเป็นตาม runtime และ SearchApi ต้นทาง
- ประเภท: stringsp
โทเคนตัวกรอง YouTube (การแบ่งหน้าหรือตัวกรองขั้นสูง)
- ประเภท: object · ResponseFc5Af1Fcba22_SearchResponse200
การตอบกลับสำเร็จ
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Ad[]ads
ผลลัพธ์โฆษณา
- 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 เว็บไซต์ของผู้ลงโฆษณา
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Channel[]channels
ผลลัพธ์ช่อง YouTube
- descriptionประเภท: string
คำอธิบายช่อง
- idประเภท: string
ID ช่อง YouTube
- isประเภท: boolean
_verified ระบุว่าช่องได้รับการยืนยันหรือไม่
- linkประเภท: string
ลิงก์ไปยังช่อง
- positionประเภท: integer
ตำแหน่งในผลการค้นหา
- subscribersประเภท: integer
จำนวนผู้ติดตาม
- thumbnailประเภท: object · ResponseFc5Af1Fcba22_Thumbnail
- richประเภท: string
URL ภาพขนาดย่อแบบสมบูรณ์/เคลื่อนไหว
- staticประเภท: string
URL ภาพขนาดย่อแบบคงที่
- titleประเภท: string
ชื่อช่อง
- videoประเภท: integer
_count จำนวนวิดีโอ
- ประเภท: stringerror
ข้อความข้อผิดพลาดหากการค้นหาล้มเหลว
- ประเภท: object · ResponseFc5Af1Fcba22_FeaturedChannelfeatured
_channel - highlightedประเภท: object · ResponseFc5Af1Fcba22_HighlightedVideo
_video - 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
ชื่อวิดีโอ
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Movie[]movies
ผลลัพธ์ภาพยนตร์
- badgesประเภท: array string[]
ป้ายภาพยนตร์
- buttonsประเภท: array string[]
ปุ่มการกระทำ
- channelประเภท: object · ResponseFc5Af1Fcba22_MovieChannel
- idประเภท: string
ID ช่อง
- isประเภท: boolean
_verified ระบุว่าช่องได้รับการยืนยันหรือไม่
- linkประเภท: string
ลิงก์ไปยังช่อง
- titleประเภท: string
ชื่อช่อง
- descriptionประเภท: string
คำอธิบายภาพยนตร์
- idประเภท: string
ID วิดีโอภาพยนตร์
- lengthประเภท: string
ความยาวภาพยนตร์
- linkประเภท: string
ลิงก์ไปยังภาพยนตร์
- metadataประเภท: object · ResponseFc5Af1Fcba22_MetadataItems
_items - bottomประเภท: array string[]
รายการข้อมูลเมตาด้านล่าง
- topประเภท: array string[]
รายการข้อมูลเมตาด้านบน
- positionประเภท: integer
ตำแหน่งในผลการค้นหา
- thumbnailประเภท: string
URL ภาพขนาดย่อของภาพยนตร์
- titleประเภท: string
ชื่อภาพยนตร์
- ประเภท: object · ResponseFc5Af1Fcba22_Paginationpagination
- nextประเภท: string
_page _token โทเคนสำหรับดึงผลลัพธ์หน้าถัดไป
- ประเภท: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]people
_also _search _for ข้อเสนอแนะการค้นหาที่เกี่ยวข้อง
- linkประเภท: string
ลิงก์สำหรับดำเนินการค้นหา
- queryประเภท: string
คำค้นหาที่แนะนำ
- thumbnailประเภท: string
ภาพขนาดย่อของข้อเสนอแนะ
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Playlist[]playlists
ผลลัพธ์เพลย์ลิสต์
- channelประเภท: object · ResponseFc5Af1Fcba22_PlaylistChannel
- idประเภท: string
ID ช่อง
- isประเภท: boolean
_verified ระบุว่าช่องได้รับการยืนยันหรือไม่
- linkประเภท: string
ลิงก์ไปยังช่อง
- titleประเภท: string
ชื่อช่อง
- idประเภท: string
ID เพลย์ลิสต์
- linkประเภท: string
ลิงก์ไปยังเพลย์ลิสต์
- positionประเภท: integer
ตำแหน่งในผลการค้นหา
- publishedประเภท: string
_time เวลาที่ผ่านไปนับตั้งแต่เผยแพร่
- thumbnailประเภท: string
URL ภาพขนาดย่อของเพลย์ลิสต์
- titleประเภท: string
ชื่อเพลย์ลิสต์
- videoประเภท: integer
_count จำนวนวิดีโอในเพลย์ลิสต์
- videosประเภท: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]
วิดีโอในเพลย์ลิสต์
- idประเภท: string
ID วิดีโอ
- lengthประเภท: string
ความยาววิดีโอ
- linkประเภท: string
ลิงก์ไปยังวิดีโอ
- titleประเภท: string
ชื่อวิดีโอ
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Posts[]posts
ผลลัพธ์โพสต์ของชุมชน
- itemsประเภท: array object[] · ResponseFc5Af1Fcba22_Post[]
โพสต์ของชุมชน
- channelประเภท: object · ResponseFc5Af1Fcba22_PostChannel
- idประเภท: string
ID ช่อง
- isประเภท: boolean
_verified ระบุว่าช่องได้รับการยืนยันหรือไม่
- linkประเภท: string
ลิงก์ไปยังช่อง
- thumbnailประเภท: string
URL ภาพขนาดย่อของช่อง
- titleประเภท: string
ชื่อช่อง
- commentsประเภท: string
จำนวนความคิดเห็น (ข้อความ)
- extractedประเภท: integer
_comments จำนวนความคิดเห็น (จำนวนเต็ม)
- extractedประเภท: integer
_likes จำนวนถูกใจ (จำนวนเต็ม)
- idประเภท: string
ID โพสต์
- likesประเภท: string
จำนวนถูกใจ (ข้อความ)
- linkประเภท: string
ลิงก์ไปยังโพสต์
- positionประเภท: integer
ตำแหน่งในส่วนโพสต์
- publishedประเภท: string
_time เวลาที่ผ่านไปนับตั้งแต่เผยแพร่
- textประเภท: string
เนื้อหาข้อความของโพสต์
- thumbnailประเภท: string
URL ภาพขนาดย่อของโพสต์
- positionประเภท: integer
ตำแหน่งในผลการค้นหา
- sectionประเภท: string
_title ชื่อส่วนของโพสต์
- ประเภท: object · ResponseFc5Af1Fcba22_SearchInformationsearch
_information - correctedประเภท: string
_query คำค้นหาที่แก้ไขแล้วหากมีการแก้ไขการสะกด
- originalประเภท: string
_query คำค้นหาเดิมก่อนการแก้ไข
- originalประเภท: string
_query _sp พารามิเตอร์ SP สำหรับคำค้นหาเดิม
- stateประเภท: string
สถานะของการแก้ไขคำค้นหา (ถ้ามี)
- totalประเภท: integer
_results จำนวนผลลัพธ์ทั้งหมดที่พบ
- ประเภท: object · ResponseFc5Af1Fcba22_SearchMetadatasearch
_metadata - createdประเภท: string รูปแบบ: date-time
_at จำเป็นเวลาที่สร้างการค้นหา
- idประเภท: stringจำเป็น
ตัวระบุเฉพาะของคำขอค้นหา
- statusประเภท: stringจำเป็น
สถานะของคำขอค้นหา
- htmlประเภท: string
_url URL สำหรับดูผลลัพธ์ HTML
- jsonประเภท: string
_url URL สำหรับดูผลลัพธ์ JSON
- parsingประเภท: number
_time _taken เวลาที่ใช้ในการแยกวิเคราะห์ผลลัพธ์เป็นวินาที
- requestประเภท: number
_time _taken เวลาที่ใช้ในการส่งคำขอเป็นวินาที
- requestประเภท: string
_url URL YouTube สำหรับการค้นหานี้
- totalประเภท: number
_time _taken เวลารวมที่ใช้ในการค้นหาเป็นวินาที
- ประเภท: object · ResponseFc5Af1Fcba22_SearchParameterssearch
_parameters - engineประเภท: string
เครื่องมือค้นหาที่ใช้
- glประเภท: string
รหัสประเทศที่ใช้
- hlประเภท: string
ภาษาของอินเทอร์เฟซที่ใช้
- qประเภท: string
คำค้นหาที่ใช้
- spประเภท: string
พารามิเตอร์ตัวกรอง/การแบ่งหน้าที่ใช้
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Section[]sections
ผลลัพธ์ของส่วน
- itemsประเภท: array object[] · ResponseFc5Af1Fcba22_SectionItem[]
รายการในส่วน
- channelประเภท: object · ResponseFc5Af1Fcba22_SectionChannel
- idประเภท: string
ID ช่อง
- linkประเภท: string
ลิงก์ไปยังช่อง
- titleประเภท: string
ชื่อช่อง
- idประเภท: string
ID รายการ
- lengthประเภท: string
ความยาวรายการ
- linkประเภท: string
ลิงก์ไปยังรายการ
- publishedประเภท: string
_time เวลาที่ผ่านไปนับตั้งแต่เผยแพร่
- thumbnailประเภท: string
URL ภาพขนาดย่อของรายการ
- titleประเภท: string
ชื่อรายการ
- viewsประเภท: integer
จำนวนการรับชม
- positionประเภท: integer
ตำแหน่งในผลการค้นหา
- sectionประเภท: string
_title ชื่อส่วน
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Shorts[]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ประเภท: string
_title ชื่อส่วนของ Shorts
- ประเภท: array string[]suggestions
ข้อเสนอแนะคำค้นหา
- ประเภท: array object[] · ResponseFc5Af1Fcba22_Video[]videos
ผลลัพธ์การค้นหาวิดีโอ
- badgesประเภท: array string[]
ป้ายวิดีโอ
- channelประเภท: object · ResponseFc5Af1Fcba22_VideoChannel
- idประเภท: string
ID ช่อง
- isประเภท: boolean
_verified ระบุว่าช่องได้รับการยืนยันหรือไม่
- linkประเภท: string
ลิงก์ไปยังช่อง
- thumbnailประเภท: string
URL ภาพขนาดย่อของช่อง
- titleประเภท: string
ชื่อช่อง
- descriptionประเภท: string
ข้อความสั้นของคำอธิบายวิดีโอ
- idประเภท: string
ID วิดีโอ YouTube
- isประเภท: boolean
_live ระบุว่าวิดีโอกำลังออกอากาศสดอยู่ในขณะนี้หรือไม่
- keyประเภท: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]
_moments ช่วงเวลาสำคัญในวิดีโอ
- startประเภท: integer
_seconds เวลาเริ่มของช่วงเวลาสำคัญเป็นวินาที
- thumbnailประเภท: string
URL ภาพขนาดย่อของช่วงเวลาสำคัญ
- titleประเภท: string
ชื่อช่วงเวลาสำคัญ
- lengthประเภท: string
ความยาววิดีโอ
- linkประเภท: string
ลิงก์ไปยังวิดีโอ
- positionประเภท: integer
ตำแหน่งในผลการค้นหา
- publishedประเภท: string
_time เวลาที่ผ่านไปนับตั้งแต่เผยแพร่
- 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
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"
}