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

معرّف القناة

link
النوع: string

رابط القناة

title
النوع: string

اسم القناة

description
النوع: string

وصف الإعلان

id
النوع: string

معرّف الفيديو لإعلانات الفيديو

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

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

معرّف الفيديو

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

عنوان الفيديو

movies
النوع: array object[] · ResponseFc5Af1Fcba22_Movie[]

نتائج الأفلام

badges
النوع: array string[]

شارات الفيلم

buttons
النوع: array string[]

أزرار الإجراءات

channel
النوع: object · ResponseFc5Af1Fcba22_MovieChannel
id
النوع: string

معرّف القناة

is_verified
النوع: boolean

يشير إلى ما إذا كانت القناة موثّقة

link
النوع: string

رابط القناة

title
النوع: string

اسم القناة

description
النوع: string

وصف الفيلم

id
النوع: string

معرّف فيديو الفيلم

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

معرّف القناة

is_verified
النوع: boolean

يشير إلى ما إذا كانت القناة موثّقة

link
النوع: string

رابط القناة

title
النوع: string

اسم القناة

id
النوع: string

معرّف قائمة التشغيل

link
النوع: string

رابط قائمة التشغيل

position
النوع: integer

الموضع في نتائج البحث

published_time
النوع: string

الوقت المنقضي منذ النشر

thumbnail
النوع: string

عنوان URL للصورة المصغّرة لقائمة التشغيل

title
النوع: string

عنوان قائمة التشغيل

video_count
النوع: integer

عدد الفيديوهات في قائمة التشغيل

videos
النوع: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

الفيديوهات في قائمة التشغيل

id
النوع: string

معرّف الفيديو

length
النوع: string

مدة الفيديو

link
النوع: string

رابط الفيديو

title
النوع: string

عنوان الفيديو

posts
النوع: array object[] · ResponseFc5Af1Fcba22_Posts[]

نتائج منشورات المجتمع

items
النوع: array object[] · ResponseFc5Af1Fcba22_Post[]

منشورات المجتمع

channel
النوع: object · ResponseFc5Af1Fcba22_PostChannel
id
النوع: string

معرّف القناة

is_verified
النوع: boolean

يشير إلى ما إذا كانت القناة موثّقة

link
النوع: string

رابط القناة

thumbnail
النوع: string

عنوان URL للصورة المصغّرة للقناة

title
النوع: string

اسم القناة

comments
النوع: string

عدد التعليقات كنص

extracted_comments
النوع: integer

عدد التعليقات كعدد صحيح

extracted_likes
النوع: integer

عدد الإعجابات كعدد صحيح

id
النوع: string

معرّف المنشور

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

معرّف القناة

link
النوع: string

رابط القناة

title
النوع: string

اسم القناة

id
النوع: string

معرّف العنصر

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

معرّف الفيديو القصير

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

معرّف القناة

is_verified
النوع: boolean

يشير إلى ما إذا كانت القناة موثّقة

link
النوع: string

رابط القناة

thumbnail
النوع: string

عنوان URL للصورة المصغّرة للقناة

title
النوع: string

اسم القناة

description
النوع: string

مقتطف وصف الفيديو

id
النوع: string

معرّف فيديو 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

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

استجابة ناجحة

البحث على YouTube

المصادقةRequired

YouTube Search

البحث على YouTube

مرجع التسعير