Felo API PlatformFelo API Platform
تمام YouTube endpoints
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
    لازمی

    تلاش کی کوئری۔ رن ٹائم اور اپ اسٹریم 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

        YouTube چینل ID

      • 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

        HTML نتائج دیکھنے کا URL

      • json_url
        قسم: string

        JSON نتائج دیکھنے کا URL

      • parsing_time_taken
        قسم: number

        نتائج پارس کرنے میں لگا وقت، سیکنڈز میں

      • request_time_taken
        قسم: number

        درخواست کرنے میں لگا وقت، سیکنڈز میں

      • request_url
        قسم: string

        اس تلاش کے لیے YouTube URL

      • 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

          Short ویڈیو ID

        • link
          قسم: string

          Short کا لنک

        • position
          قسم: integer

          shorts سیکشن کے اندر پوزیشن

        • thumbnail
          قسم: string

          Short کے تھمب نیل کا URL

        • 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

        YouTube ویڈیو ID

      • 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

    درست Felo API کلید درکار ہے۔

  • 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