v0.2.0-beta

OpenAPI 3.1.0

Pencarian YouTube

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search Operasi

get/v1/beta/youtube/search

Pencarian YouTube

Cari video, saluran, dan playlist di YouTube. engine=youtube dan q wajib diisi. Gunakan gl dan hl untuk negara dan bahasa, atau sp untuk paginasi dan filter lanjutan.

Referensi harga

Metering: Dasar biaya tetap per permintaan berhasil.
Estimasi referensi per permintaan: USD 0.0029.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Parameter Kueri

engine
enum
const:
youtube
wajib

Pengenal mesin SearchApi. Gunakan youtube untuk endpoint YouTube ini.
nilai
- youtube
gl
Tipe: string

Kode negara (misalnya us, jp)
hl
Tipe: string

Bahasa antarmuka
q
Tipe: string
wajib

Kueri pencarian. Diperlukan oleh runtime dan SearchApi upstream.
sp
Tipe: string

Token filter YouTube (paginasi atau filter lanjutan)

Respons

200
Tipe: object · ResponseFc5Af1Fcba22_SearchResponse

Respons berhasil
ads
Tipe: array object[] · ResponseFc5Af1Fcba22_Ad[]

Hasil iklan

channel
Tipe: object · ResponseFc5Af1Fcba22_AdChannel
id
Tipe: string

ID kanal

link
Tipe: string

Tautan ke kanal

title
Tipe: string

Nama kanal

description
Tipe: string

Deskripsi iklan

id
Tipe: string

ID video untuk iklan video

length
Tipe: string

Durasi video untuk iklan video

link
Tipe: string

Tautan iklan

position
Tipe: integer

Posisi dalam hasil pencarian

thumbnail
Tipe: string

URL thumbnail iklan

title
Tipe: string

Judul iklan

website
Tipe: string

URL situs web pengiklan

channels
Tipe: array object[] · ResponseFc5Af1Fcba22_Channel[]

Hasil kanal YouTube

description
Tipe: string

Deskripsi kanal

id
Tipe: string

ID kanal YouTube

is_verified
Tipe: boolean

Apakah kanal terverifikasi

link
Tipe: string

Tautan ke kanal

position
Tipe: integer

Posisi dalam hasil pencarian

subscribers
Tipe: integer

Jumlah pelanggan

thumbnail
Tipe: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipe: string

URL thumbnail kaya/animasi

static
Tipe: string

URL thumbnail statis

title
Tipe: string

Nama kanal

video_count
Tipe: integer

Jumlah video

error
Tipe: string

Pesan error jika pencarian gagal

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

ID video

length
Tipe: string

Durasi video

link
Tipe: string

Tautan ke video

subtitle
Tipe: string

Subjudul video

title
Tipe: string

Judul video

id
Tipe: string

ID kanal unggulan

link
Tipe: string

Tautan ke kanal unggulan

subtitle
Tipe: string

Subjudul kanal unggulan

title
Tipe: string

Judul kanal unggulan

videos
Tipe: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Video kanal unggulan

channel
Tipe: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Tipe: string

ID kanal

link
Tipe: string

Tautan ke kanal

title
Tipe: string

Nama kanal

id
Tipe: string

ID video

length
Tipe: string

Durasi video

link
Tipe: string

Tautan ke video

subtitle
Tipe: string

Subjudul video

thumbnail
Tipe: string

URL thumbnail video

title
Tipe: string

Judul video

movies
Tipe: array object[] · ResponseFc5Af1Fcba22_Movie[]

Hasil film

badges
Tipe: array string[]

Lencana film

buttons
Tipe: array string[]

Tombol tindakan

channel
Tipe: object · ResponseFc5Af1Fcba22_MovieChannel
id
Tipe: string

ID kanal

is_verified
Tipe: boolean

Apakah kanal terverifikasi

link
Tipe: string

Tautan ke kanal

title
Tipe: string

Nama kanal

description
Tipe: string

Deskripsi film

id
Tipe: string

ID video film

length
Tipe: string

Durasi film

link
Tipe: string

Tautan ke film

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

Item metadata bawah

top
Tipe: array string[]

Item metadata atas

position
Tipe: integer

Posisi dalam hasil pencarian

thumbnail
Tipe: string

URL thumbnail film

title
Tipe: string

Judul film

pagination
Tipe: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Tipe: string

Token untuk mengambil halaman hasil berikutnya

people_also_search_for
Tipe: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

Saran pencarian terkait

link
Tipe: string

Tautan untuk melakukan pencarian

query
Tipe: string

Kueri pencarian yang disarankan

thumbnail
Tipe: string

Thumbnail untuk saran

playlists
Tipe: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Hasil playlist

channel
Tipe: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Tipe: string

ID kanal

is_verified
Tipe: boolean

Apakah kanal terverifikasi

link
Tipe: string

Tautan ke kanal

title
Tipe: string

Nama kanal

id
Tipe: string

ID playlist

link
Tipe: string

Tautan ke playlist

position
Tipe: integer

Posisi dalam hasil pencarian

published_time
Tipe: string

Waktu sejak publikasi

thumbnail
Tipe: string

URL thumbnail playlist

title
Tipe: string

Judul playlist

video_count
Tipe: integer

Jumlah video dalam playlist

videos
Tipe: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Video dalam playlist

id
Tipe: string

ID video

length
Tipe: string

Durasi video

link
Tipe: string

Tautan ke video

title
Tipe: string

Judul video

posts
Tipe: array object[] · ResponseFc5Af1Fcba22_Posts[]

Hasil postingan komunitas

items
Tipe: array object[] · ResponseFc5Af1Fcba22_Post[]

Postingan komunitas

channel
Tipe: object · ResponseFc5Af1Fcba22_PostChannel
id
Tipe: string

ID kanal

is_verified
Tipe: boolean

Apakah kanal terverifikasi

link
Tipe: string

Tautan ke kanal

thumbnail
Tipe: string

URL thumbnail kanal

title
Tipe: string

Nama kanal

comments
Tipe: string

Jumlah komentar dalam teks

extracted_comments
Tipe: integer

Jumlah komentar sebagai bilangan bulat

extracted_likes
Tipe: integer

Jumlah suka sebagai bilangan bulat

id
Tipe: string

ID postingan

likes
Tipe: string

Jumlah suka dalam teks

link
Tipe: string

Tautan ke postingan

position
Tipe: integer

Posisi dalam bagian postingan

published_time
Tipe: string

Waktu sejak publikasi

text
Tipe: string

Konten teks postingan

thumbnail
Tipe: string

URL thumbnail postingan

position
Tipe: integer

Posisi dalam hasil pencarian

section_title
Tipe: string

Judul bagian untuk postingan

search_information
Tipe: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Tipe: string

Kueri yang dikoreksi jika perbaikan ejaan diterapkan

original_query
Tipe: string

Kueri asli sebelum koreksi

original_query_sp
Tipe: string

Parameter SP untuk kueri asli

state
Tipe: string

Status koreksi kueri jika berlaku

total_results
Tipe: integer

Jumlah total hasil yang ditemukan

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

Stempel waktu saat pencarian dibuat

id
Tipe: string
wajib

Pengidentifikasi unik untuk permintaan pencarian

status
Tipe: string
wajib

Status permintaan pencarian

html_url
Tipe: string

URL untuk melihat hasil HTML

json_url
Tipe: string

URL untuk melihat hasil JSON

parsing_time_taken
Tipe: number

Waktu yang diperlukan untuk mengurai hasil dalam detik

request_time_taken
Tipe: number

Waktu yang diperlukan untuk membuat permintaan dalam detik

request_url
Tipe: string

URL YouTube untuk pencarian ini

total_time_taken
Tipe: number

Total waktu yang diperlukan untuk pencarian dalam detik

search_parameters
Tipe: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Tipe: string

Mesin pencari yang digunakan

gl
Tipe: string

Kode negara yang digunakan

hl
Tipe: string

Bahasa antarmuka yang digunakan

q
Tipe: string

Kueri pencarian yang digunakan

sp
Tipe: string

Parameter filter/paginasi yang digunakan

sections
Tipe: array object[] · ResponseFc5Af1Fcba22_Section[]

Hasil bagian

items
Tipe: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Item dalam bagian

channel
Tipe: object · ResponseFc5Af1Fcba22_SectionChannel
id
Tipe: string

ID kanal

link
Tipe: string

Tautan ke kanal

title
Tipe: string

Nama kanal

id
Tipe: string

ID item

length
Tipe: string

Durasi item

link
Tipe: string

Tautan ke item

published_time
Tipe: string

Waktu sejak publikasi

thumbnail
Tipe: string

URL thumbnail item

title
Tipe: string

Judul item

views
Tipe: integer

Jumlah penayangan

position
Tipe: integer

Posisi dalam hasil pencarian

section_title
Tipe: string

Judul bagian

shorts
Tipe: array object[] · ResponseFc5Af1Fcba22_Shorts[]

Hasil YouTube Shorts

items
Tipe: array object[] · ResponseFc5Af1Fcba22_Short[]

Video shorts

duration
Tipe: string

Durasi shorts

id
Tipe: string

ID video shorts

link
Tipe: string

Tautan ke shorts

position
Tipe: integer

Posisi dalam bagian shorts

thumbnail
Tipe: string

URL thumbnail shorts

title
Tipe: string

Judul shorts

views
Tipe: integer

Jumlah penayangan

position
Tipe: integer

Posisi dalam hasil pencarian

section_title
Tipe: string

Judul bagian untuk shorts

suggestions
Tipe: array string[]

Saran kueri pencarian

videos
Tipe: array object[] · ResponseFc5Af1Fcba22_Video[]

Hasil pencarian video

badges
Tipe: array string[]

Lencana video

channel
Tipe: object · ResponseFc5Af1Fcba22_VideoChannel
id
Tipe: string

ID kanal

is_verified
Tipe: boolean

Apakah kanal terverifikasi

link
Tipe: string

Tautan ke kanal

thumbnail
Tipe: string

URL thumbnail kanal

title
Tipe: string

Nama kanal

description
Tipe: string

Cuplikan deskripsi video

id
Tipe: string

ID video YouTube

is_live
Tipe: boolean

Apakah video sedang live

key_moments
Tipe: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Momen utama dalam video

start_seconds
Tipe: integer

Waktu mulai momen dalam detik

thumbnail
Tipe: string

URL thumbnail momen utama

title
Tipe: string

Judul momen utama

length
Tipe: string

Durasi video

link
Tipe: string

Tautan ke video

position
Tipe: integer

Posisi dalam hasil pencarian

published_time
Tipe: string

Waktu sejak publikasi

thumbnail
Tipe: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tipe: string

URL thumbnail kaya/animasi

static
Tipe: string

URL thumbnail statis

title
Tipe: string

Judul video

views
Tipe: integer

Jumlah penayangan
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat 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'

Tampilkan Skema

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

Respons berhasil

Pencarian YouTube

AutentikasiRequired

YouTube Search

Pencarian YouTube

Referensi harga