v0.2.0-beta

OpenAPI 3.1.0

Carian YouTube

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operasi

get/v1/beta/youtube/search

Carian YouTube

Cari video, saluran dan senarai main di YouTube. engine=youtube dan q diperlukan. Gunakan gl dan hl untuk negara dan bahasa, atau sp untuk penomboran halaman dan penapis lanjutan.

Rujukan harga

Pemeteran: Asas kos tetap bagi setiap permintaan berjaya.
Anggaran rujukan setiap permintaan: USD 0.0029.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Parameter Pertanyaan

engine
enum
const:
youtube
wajib

Pengecam enjin SearchApi. Gunakan youtube untuk endpoint YouTube ini.
nilai
- youtube
gl
Jenis: string

Kod negara (contohnya us, jp)
hl
Jenis: string

Bahasa antara muka
q
Jenis: string
wajib

Pertanyaan carian. Diperlukan oleh runtime dan SearchApi huluan.
sp
Jenis: string

Token penapis YouTube (penomboran atau penapis lanjutan)

Respons

200
Jenis: object · ResponseFc5Af1Fcba22_SearchResponse

Respons berjaya
ads
Jenis: array object[] · ResponseFc5Af1Fcba22_Ad[]

Hasil iklan

channel
Jenis: object · ResponseFc5Af1Fcba22_AdChannel
id
Jenis: string

ID saluran

link
Jenis: string

Pautan ke saluran

title
Jenis: string

Nama saluran

description
Jenis: string

Keterangan iklan

id
Jenis: string

ID video untuk iklan video

length
Jenis: string

Tempoh video untuk iklan video

link
Jenis: string

Pautan iklan

position
Jenis: integer

Kedudukan dalam hasil carian

thumbnail
Jenis: string

URL imej kecil iklan

title
Jenis: string

Tajuk iklan

website
Jenis: string

URL laman web pengiklan

channels
Jenis: array object[] · ResponseFc5Af1Fcba22_Channel[]

Hasil saluran YouTube

description
Jenis: string

Keterangan saluran

id
Jenis: string

ID saluran YouTube

is_verified
Jenis: boolean

Sama ada saluran disahkan

link
Jenis: string

Pautan ke saluran

position
Jenis: integer

Kedudukan dalam hasil carian

subscribers
Jenis: integer

Bilangan pelanggan

thumbnail
Jenis: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Jenis: string

URL imej kecil kaya/animasi

static
Jenis: string

URL imej kecil statik

title
Jenis: string

Nama saluran

video_count
Jenis: integer

Bilangan video

error
Jenis: string

Mesej ralat jika carian gagal

featured_channel
Jenis: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
Jenis: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
Jenis: string

ID video

length
Jenis: string

Tempoh video

link
Jenis: string

Pautan ke video

subtitle
Jenis: string

Sari kata video

title
Jenis: string

Tajuk video

id
Jenis: string

ID saluran pilihan

link
Jenis: string

Pautan ke saluran pilihan

subtitle
Jenis: string

Sari kata saluran pilihan

title
Jenis: string

Tajuk saluran pilihan

videos
Jenis: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Video saluran pilihan

channel
Jenis: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Jenis: string

ID saluran

link
Jenis: string

Pautan ke saluran

title
Jenis: string

Nama saluran

id
Jenis: string

ID video

length
Jenis: string

Tempoh video

link
Jenis: string

Pautan ke video

subtitle
Jenis: string

Sari kata video

thumbnail
Jenis: string

URL imej kecil video

title
Jenis: string

Tajuk video

movies
Jenis: array object[] · ResponseFc5Af1Fcba22_Movie[]

Hasil filem

badges
Jenis: array string[]

Lencana filem

buttons
Jenis: array string[]

Butang tindakan

channel
Jenis: object · ResponseFc5Af1Fcba22_MovieChannel
id
Jenis: string

ID saluran

is_verified
Jenis: boolean

Sama ada saluran disahkan

link
Jenis: string

Pautan ke saluran

title
Jenis: string

Nama saluran

description
Jenis: string

Keterangan filem

id
Jenis: string

ID video filem

length
Jenis: string

Tempoh filem

link
Jenis: string

Pautan ke filem

metadata_items
Jenis: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
Jenis: array string[]

Item metadata bawah

top
Jenis: array string[]

Item metadata atas

position
Jenis: integer

Kedudukan dalam hasil carian

thumbnail
Jenis: string

URL imej kecil filem

title
Jenis: string

Tajuk filem

pagination
Jenis: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Jenis: string

Token untuk mengambil halaman hasil seterusnya

people_also_search_for
Jenis: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Cadangan carian berkaitan

link
Jenis: string

Pautan untuk melakukan carian

query
Jenis: string

Pertanyaan carian yang dicadangkan

thumbnail
Jenis: string

Imej kecil untuk cadangan

playlists
Jenis: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Hasil senarai main

channel
Jenis: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Jenis: string

ID saluran

is_verified
Jenis: boolean

Sama ada saluran disahkan

link
Jenis: string

Pautan ke saluran

title
Jenis: string

Nama saluran

id
Jenis: string

ID senarai main

link
Jenis: string

Pautan ke senarai main

position
Jenis: integer

Kedudukan dalam hasil carian

published_time
Jenis: string

Masa sejak penerbitan

thumbnail
Jenis: string

URL imej kecil senarai main

title
Jenis: string

Tajuk senarai main

video_count
Jenis: integer

Bilangan video dalam senarai main

videos
Jenis: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Video dalam senarai main

id
Jenis: string

ID video

length
Jenis: string

Tempoh video

link
Jenis: string

Pautan ke video

title
Jenis: string

Tajuk video

posts
Jenis: array object[] · ResponseFc5Af1Fcba22_Posts[]

Hasil siaran komuniti

items
Jenis: array object[] · ResponseFc5Af1Fcba22_Post[]

Siaran komuniti

channel
Jenis: object · ResponseFc5Af1Fcba22_PostChannel
id
Jenis: string

ID saluran

is_verified
Jenis: boolean

Sama ada saluran disahkan

link
Jenis: string

Pautan ke saluran

thumbnail
Jenis: string

URL imej kecil saluran

title
Jenis: string

Nama saluran

comments
Jenis: string

Bilangan komen dalam teks

extracted_comments
Jenis: integer

Bilangan komen sebagai integer

extracted_likes
Jenis: integer

Bilangan suka sebagai integer

id
Jenis: string

ID siaran

likes
Jenis: string

Bilangan suka dalam teks

link
Jenis: string

Pautan ke siaran

position
Jenis: integer

Kedudukan dalam bahagian siaran

published_time
Jenis: string

Masa sejak penerbitan

text
Jenis: string

Kandungan teks siaran

thumbnail
Jenis: string

URL imej kecil siaran

position
Jenis: integer

Kedudukan dalam hasil carian

section_title
Jenis: string

Tajuk bahagian untuk siaran

search_information
Jenis: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Jenis: string

Pertanyaan yang diperbetulkan jika pembetulan ejaan digunakan

original_query
Jenis: string

Pertanyaan asal sebelum pembetulan

original_query_sp
Jenis: string

Parameter SP untuk pertanyaan asal

state
Jenis: string

Keadaan pembetulan pertanyaan jika berkenaan

total_results
Jenis: integer

Jumlah hasil yang ditemui

search_metadata
Jenis: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Jenis: string Format: date-time
wajib

Cap masa apabila carian dicipta

id
Jenis: string
wajib

Pengecam unik untuk permintaan carian

status
Jenis: string
wajib

Status permintaan carian

html_url
Jenis: string

URL untuk melihat hasil HTML

json_url
Jenis: string

URL untuk melihat hasil JSON

parsing_time_taken
Jenis: number

Masa yang diambil untuk menghuraikan hasil dalam saat

request_time_taken
Jenis: number

Masa yang diambil untuk membuat permintaan dalam saat

request_url
Jenis: string

URL YouTube untuk carian ini

total_time_taken
Jenis: number

Jumlah masa yang diambil untuk carian dalam saat

search_parameters
Jenis: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Jenis: string

Enjin carian yang digunakan

gl
Jenis: string

Kod negara yang digunakan

hl
Jenis: string

Bahasa antara muka yang digunakan

q
Jenis: string

Pertanyaan carian yang digunakan

sp
Jenis: string

Parameter penapis/penomboran halaman yang digunakan

sections
Jenis: array object[] · ResponseFc5Af1Fcba22_Section[]

Hasil bahagian

items
Jenis: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Item dalam bahagian

channel
Jenis: object · ResponseFc5Af1Fcba22_SectionChannel
id
Jenis: string

ID saluran

link
Jenis: string

Pautan ke saluran

title
Jenis: string

Nama saluran

id
Jenis: string

ID item

length
Jenis: string

Tempoh item

link
Jenis: string

Pautan ke item

published_time
Jenis: string

Masa sejak penerbitan

thumbnail
Jenis: string

URL imej kecil item

title
Jenis: string

Tajuk item

views
Jenis: integer

Bilangan tontonan

position
Jenis: integer

Kedudukan dalam hasil carian

section_title
Jenis: string

Tajuk bahagian

shorts
Jenis: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Hasil YouTube Shorts

items
Jenis: array object[] · ResponseFc5Af1Fcba22_Short[]

Video shorts

duration
Jenis: string

Tempoh shorts

id
Jenis: string

ID video shorts

link
Jenis: string

Pautan ke shorts

position
Jenis: integer

Kedudukan dalam bahagian shorts

thumbnail
Jenis: string

URL imej kecil shorts

title
Jenis: string

Tajuk shorts

views
Jenis: integer

Bilangan tontonan

position
Jenis: integer

Kedudukan dalam hasil carian

section_title
Jenis: string

Tajuk bahagian untuk shorts

suggestions
Jenis: array string[]

Cadangan pertanyaan carian

videos
Jenis: array object[] · ResponseFc5Af1Fcba22_Video[]

Hasil carian video

badges
Jenis: array string[]

Lencana video

channel
Jenis: object · ResponseFc5Af1Fcba22_VideoChannel
id
Jenis: string

ID saluran

is_verified
Jenis: boolean

Sama ada saluran disahkan

link
Jenis: string

Pautan ke saluran

thumbnail
Jenis: string

URL imej kecil saluran

title
Jenis: string

Nama saluran

description
Jenis: string

Petikan keterangan video

id
Jenis: string

ID video YouTube

is_live
Jenis: boolean

Sama ada video sedang langsung

key_moments
Jenis: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Detik penting dalam video

start_seconds
Jenis: integer

Masa mula detik dalam saat

thumbnail
Jenis: string

URL imej kecil detik penting

title
Jenis: string

Tajuk detik penting

length
Jenis: string

Tempoh video

link
Jenis: string

Pautan ke video

position
Jenis: integer

Kedudukan dalam hasil carian

published_time
Jenis: string

Masa sejak penerbitan

thumbnail
Jenis: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Jenis: string

URL imej kecil kaya/animasi

static
Jenis: string

URL imej kecil statik

title
Jenis: string

Tajuk video

views
Jenis: integer

Bilangan tontonan
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

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'

Tunjukkan Skema

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

Respons berjaya

Carian YouTube

PengesahanRequired

YouTube Search

Carian YouTube

Rujukan harga