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
الزامی

کوئری جستجو. توسط runtime و 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.607Z",
    "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

مرجع قیمت‌گذاری