YouTube Search
Search videos, channels and playlists.
חיפוש ב-YouTube
חיפוש ב-YouTube אחר סרטונים, ערוצים ופלייליסטים. engine=youtube ו-q חובה. השתמשו ב-gl וב-hl עבור מדינה ושפה, או ב-sp לעימוד ולמסננים מתקדמים.
מראה תמחור
- מדידה: בסיס עלות קבוע לבקשה מוצלחת.
- אומדן בקשת ייחוס: 0.0029 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- enumengineconst:youtubeחובה
מזהה מנוע SearchApi. השתמשו ב-
youtubeעבור נקודת הקצה הזו של YouTube.ערכים- youtube
- סוג: stringgl
קוד מדינה (למשל us, jp)
- סוג: stringhl
שפת הממשק
- סוג: stringqחובה
שאילתת חיפוש. נדרש על ידי ה-runtime ועל ידי SearchApi ב-upstream.
- סוג: stringsp
טוקן סינון של YouTube (עימוד או מסננים מתקדמים)
- סוג: object · ResponseFc5Af1Fcba22_SearchResponse200
תגובה מוצלחת
- סוג: array object[] · ResponseFc5Af1Fcba22_Ad[]ads
תוצאות פרסומות
- channelסוג: object · ResponseFc5Af1Fcba22_AdChannel
- idסוג: string
מזהה הערוץ
- linkסוג: string
קישור לערוץ
- titleסוג: string
שם הערוץ
- descriptionסוג: string
תיאור המודעה
- idסוג: string
מזהה סרטון עבור מודעות וידאו
- lengthסוג: string
משך הסרטון עבור מודעות וידאו
- linkסוג: string
קישור למודעה
- positionסוג: integer
מיקום בתוצאות החיפוש
- thumbnailסוג: string
כתובת URL של התמונה הממוזערת של המודעה
- titleסוג: string
כותרת המודעה
- websiteסוג: string
כתובת URL של אתר המפרסם
- סוג: array object[] · ResponseFc5Af1Fcba22_Channel[]channels
תוצאות ערוצי YouTube
- descriptionסוג: string
תיאור הערוץ
- idסוג: string
מזהה ערוץ 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
מזהה סרטון
- lengthסוג: string
משך הסרטון
- linkסוג: string
קישור לסרטון
- subtitleסוג: string
כתובית המשנה של הסרטון
- titleסוג: string
כותרת הסרטון
- idסוג: string
מזהה הערוץ המוצג
- linkסוג: string
קישור לערוץ המוצג
- subtitleסוג: string
כתובית המשנה של הערוץ המוצג
- titleסוג: string
כותרת הערוץ המוצג
- videosסוג: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]
סרטונים בערוץ המוצג
- channelסוג: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
- idסוג: string
מזהה הערוץ
- linkסוג: string
קישור לערוץ
- titleסוג: string
שם הערוץ
- idסוג: string
מזהה סרטון
- 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
מזהה הערוץ
- isסוג: boolean
_verified מציין אם הערוץ מאומת
- linkסוג: string
קישור לערוץ
- titleסוג: string
שם הערוץ
- descriptionסוג: string
תיאור הסרט
- idסוג: string
מזהה הסרטון של הסרט
- 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
מזהה הערוץ
- isסוג: boolean
_verified מציין אם הערוץ מאומת
- linkסוג: string
קישור לערוץ
- titleסוג: string
שם הערוץ
- idסוג: string
מזהה פלייליסט
- linkסוג: string
קישור לפלייליסט
- positionסוג: integer
מיקום בתוצאות החיפוש
- publishedסוג: string
_time הזמן שחלף מאז הפרסום
- thumbnailסוג: string
כתובת URL של התמונה הממוזערת של הפלייליסט
- titleסוג: string
כותרת הפלייליסט
- videoסוג: integer
_count מספר הסרטונים בפלייליסט
- videosסוג: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]
סרטונים בפלייליסט
- idסוג: string
מזהה סרטון
- lengthסוג: string
משך הסרטון
- linkסוג: string
קישור לסרטון
- titleסוג: string
כותרת הסרטון
- סוג: array object[] · ResponseFc5Af1Fcba22_Posts[]posts
תוצאות פוסטים בקהילה
- itemsסוג: array object[] · ResponseFc5Af1Fcba22_Post[]
פוסטים בקהילה
- channelסוג: object · ResponseFc5Af1Fcba22_PostChannel
- idסוג: string
מזהה הערוץ
- isסוג: boolean
_verified מציין אם הערוץ מאומת
- linkסוג: string
קישור לערוץ
- thumbnailסוג: string
כתובת URL של התמונה הממוזערת של הערוץ
- titleסוג: string
שם הערוץ
- commentsסוג: string
מספר התגובות כטקסט
- extractedסוג: integer
_comments מספר התגובות כמספר שלם
- extractedסוג: integer
_likes מספר הלייקים כמספר שלם
- idסוג: string
מזהה הפוסט
- 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
מזהה הערוץ
- linkסוג: string
קישור לערוץ
- titleסוג: string
שם הערוץ
- idסוג: string
מזהה הפריט
- 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[]
סרטונים קצרים
- durationסוג: string
משך הסרטון הקצר
- idסוג: string
מזהה הסרטון הקצר
- linkסוג: string
קישור לסרטון הקצר
- positionסוג: integer
מיקום בתוך מקטע הסרטונים הקצרים
- thumbnailסוג: string
כתובת URL של התמונה הממוזערת של הסרטון הקצר
- titleסוג: string
כותרת הסרטון הקצר
- viewsסוג: integer
מספר הצפיות
- positionסוג: integer
מיקום בתוצאות החיפוש
- sectionסוג: string
_title כותרת המקטע עבור סרטונים קצרים
- סוג: array string[]suggestions
הצעות לשאילתות חיפוש
- סוג: array object[] · ResponseFc5Af1Fcba22_Video[]videos
תוצאות חיפוש וידאו
- badgesסוג: array string[]
תגיות הסרטון
- channelסוג: object · ResponseFc5Af1Fcba22_VideoChannel
- idסוג: string
מזהה הערוץ
- isסוג: boolean
_verified מציין אם הערוץ מאומת
- linkסוג: string
קישור לערוץ
- thumbnailסוג: string
כתובת URL של התמונה הממוזערת של הערוץ
- titleסוג: string
שם הערוץ
- descriptionסוג: string
קטע מתיאור הסרטון
- idסוג: string
מזהה סרטון 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.601Z",
"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"
}