v0.2.0-beta

OpenAPI 3.1.0

YouTube Araması

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

YouTube Search

Search videos, channels and playlists.

YouTube Search İşlemler

get/v1/beta/youtube/search

YouTube Araması

YouTube'da video, kanal ve çalma listesi arar. engine=youtube ve q zorunludur. Ülke ve dil için gl ve hl, sayfalama ve gelişmiş filtreler için sp kullanın.

Fiyatlandırma referansı

Ölçümlendirme: başarılı istek başına sabit maliyet esası.
Referans istek tahmini: USD 0.0029.
Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Sorgu Parametreleri

engine
enum
sabit:
youtube
gerekli

SearchApi motor tanımlayıcısı. Bu YouTube uç noktası için youtube kullanın.
değerler
- youtube
gl
Tür: string

Ülke kodu (ör. us, jp)
hl
Tür: string

Arayüz dili
q
Tür: string
gerekli

Arama sorgusu. Çalışma zamanı ve upstream SearchApi tarafından zorunludur.
sp
Tür: string

YouTube filtre belirteci (sayfalama veya gelişmiş filtreler)

Yanıtlar

200
Tür: object · ResponseFc5Af1Fcba22_SearchResponse

Başarılı yanıt
ads
Tür: array object[] · ResponseFc5Af1Fcba22_Ad[]

Reklam sonuçları

channel
Tür: object · ResponseFc5Af1Fcba22_AdChannel
id
Tür: string

Kanal kimliği

link
Tür: string

Kanala bağlantı

title
Tür: string

Kanal adı

description
Tür: string

Reklam açıklaması

id
Tür: string

Video reklamlar için video kimliği

length
Tür: string

Video reklamlar için video süresi

link
Tür: string

Reklam bağlantısı

position
Tür: integer

Arama sonuçlarındaki konum

thumbnail
Tür: string

Reklam küçük resim URL'si

title
Tür: string

Reklam başlığı

website
Tür: string

Reklamveren web sitesi URL'si

channels
Tür: array object[] · ResponseFc5Af1Fcba22_Channel[]

YouTube kanal sonuçları

description
Tür: string

Kanal açıklaması

id
Tür: string

YouTube kanal kimliği

is_verified
Tür: boolean

Kanalın doğrulanmış olup olmadığı

link
Tür: string

Kanala bağlantı

position
Tür: integer

Arama sonuçlarındaki konum

subscribers
Tür: integer

Abone sayısı

thumbnail
Tür: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tür: string

Zengin/animasyonlu küçük resim URL'si

static
Tür: string

Statik küçük resim URL'si

title
Tür: string

Kanal adı

video_count
Tür: integer

Video sayısı

error
Tür: string

Arama başarısız olursa hata iletisi

featured_channel
Tür: object · ResponseFc5Af1Fcba22_FeaturedChannel
highlighted_video
Tür: object · ResponseFc5Af1Fcba22_HighlightedVideo
id
Tür: string

Video kimliği

length
Tür: string

Video süresi

link
Tür: string

Videoya bağlantı

subtitle
Tür: string

Video alt başlığı

title
Tür: string

Video başlığı

id
Tür: string

Öne çıkan kanal kimliği

link
Tür: string

Öne çıkan kanala bağlantı

subtitle
Tür: string

Öne çıkan kanal alt başlığı

title
Tür: string

Öne çıkan kanal başlığı

videos
Tür: array object[] · ResponseFc5Af1Fcba22_FeaturedVideo[]

Öne çıkan kanal videoları

channel
Tür: object · ResponseFc5Af1Fcba22_FeaturedVideoChannel
id
Tür: string

Kanal kimliği

link
Tür: string

Kanala bağlantı

title
Tür: string

Kanal adı

id
Tür: string

Video kimliği

length
Tür: string

Video süresi

link
Tür: string

Videoya bağlantı

subtitle
Tür: string

Video alt başlığı

thumbnail
Tür: string

Video küçük resim URL'si

title
Tür: string

Video başlığı

movies
Tür: array object[] · ResponseFc5Af1Fcba22_Movie[]

Film sonuçları

badges
Tür: array string[]

Film rozetleri

buttons
Tür: array string[]

Eylem düğmeleri

channel
Tür: object · ResponseFc5Af1Fcba22_MovieChannel
id
Tür: string

Kanal kimliği

is_verified
Tür: boolean

Kanalın doğrulanmış olup olmadığı

link
Tür: string

Kanala bağlantı

title
Tür: string

Kanal adı

description
Tür: string

Film açıklaması

id
Tür: string

Film video kimliği

length
Tür: string

Film süresi

link
Tür: string

Filme bağlantı

metadata_items
Tür: object · ResponseFc5Af1Fcba22_MetadataItems
bottom
Tür: array string[]

Alt üst veri öğeleri

top
Tür: array string[]

Üst üst veri öğeleri

position
Tür: integer

Arama sonuçlarındaki konum

thumbnail
Tür: string

Film küçük resim URL'si

title
Tür: string

Film başlığı

pagination
Tür: object · ResponseFc5Af1Fcba22_Pagination
next_page_token
Tür: string

Sonraki sonuç sayfasını getirmek için token

people_also_search_for
Tür: array object[] · ResponseFc5Af1Fcba22_PeopleAlsoSearchFor[]

İlgili arama önerileri

link
Tür: string

Aramayı gerçekleştirme bağlantısı

query
Tür: string

Önerilen arama sorgusu

thumbnail
Tür: string

Öneri için küçük resim

playlists
Tür: array object[] · ResponseFc5Af1Fcba22_Playlist[]

Oynatma listesi sonuçları

channel
Tür: object · ResponseFc5Af1Fcba22_PlaylistChannel
id
Tür: string

Kanal kimliği

is_verified
Tür: boolean

Kanalın doğrulanmış olup olmadığı

link
Tür: string

Kanala bağlantı

title
Tür: string

Kanal adı

id
Tür: string

Oynatma listesi kimliği

link
Tür: string

Oynatma listesine bağlantı

position
Tür: integer

Arama sonuçlarındaki konum

published_time
Tür: string

Yayınlanmasından bu yana geçen süre

thumbnail
Tür: string

Oynatma listesi küçük resim URL'si

title
Tür: string

Oynatma listesi başlığı

video_count
Tür: integer

Oynatma listesindeki video sayısı

videos
Tür: array object[] · ResponseFc5Af1Fcba22_PlaylistVideo[]

Oynatma listesindeki videolar

id
Tür: string

Video kimliği

length
Tür: string

Video süresi

link
Tür: string

Videoya bağlantı

title
Tür: string

Video başlığı

posts
Tür: array object[] · ResponseFc5Af1Fcba22_Posts[]

Topluluk gönderisi sonuçları

items
Tür: array object[] · ResponseFc5Af1Fcba22_Post[]

Topluluk gönderileri

channel
Tür: object · ResponseFc5Af1Fcba22_PostChannel
id
Tür: string

Kanal kimliği

is_verified
Tür: boolean

Kanalın doğrulanmış olup olmadığı

link
Tür: string

Kanala bağlantı

thumbnail
Tür: string

Kanal küçük resim URL'si

title
Tür: string

Kanal adı

comments
Tür: string

Yorum sayısı (metin)

extracted_comments
Tür: integer

Tam sayı olarak yorum sayısı

extracted_likes
Tür: integer

Tam sayı olarak beğeni sayısı

id
Tür: string

Gönderi kimliği

likes
Tür: string

Beğeni sayısı (metin)

link
Tür: string

Gönderiye bağlantı

position
Tür: integer

Gönderiler bölümündeki konum

published_time
Tür: string

Yayınlanmasından bu yana geçen süre

text
Tür: string

Gönderi metin içeriği

thumbnail
Tür: string

Gönderi küçük resim URL'si

position
Tür: integer

Arama sonuçlarındaki konum

section_title
Tür: string

Gönderiler için bölüm başlığı

search_information
Tür: object · ResponseFc5Af1Fcba22_SearchInformation
corrected_query
Tür: string

Yazım düzeltmesi uygulandıysa düzeltilmiş sorgu

original_query
Tür: string

Düzeltmeden önceki orijinal sorgu

original_query_sp
Tür: string

Orijinal sorgu için SP parametresi

state
Tür: string

Varsa sorgu düzeltmesinin durumu

total_results
Tür: integer

Bulunan toplam sonuç sayısı

search_metadata
Tür: object · ResponseFc5Af1Fcba22_SearchMetadata
created_at
Tür: string Biçim: date-time
gerekli

Aramanın oluşturulduğu zaman damgası

id
Tür: string
gerekli

Arama isteği için benzersiz tanımlayıcı

status
Tür: string
gerekli

Arama isteğinin durumu

html_url
Tür: string

HTML sonuçlarını görüntüleme URL'si

json_url
Tür: string

JSON sonuçlarını görüntüleme URL'si

parsing_time_taken
Tür: number

Sonuçları ayrıştırma süresi (saniye cinsinden)

request_time_taken
Tür: number

İsteği gerçekleştirme süresi (saniye cinsinden)

request_url
Tür: string

Bu arama için YouTube URL'si

total_time_taken
Tür: number

Arama için geçen toplam süre (saniye cinsinden)

search_parameters
Tür: object · ResponseFc5Af1Fcba22_SearchParameters
engine
Tür: string

Kullanılan arama motoru

gl
Tür: string

Kullanılan ülke kodu

hl
Tür: string

Kullanılan arayüz dili

q
Tür: string

Kullanılan arama sorgusu

sp
Tür: string

Kullanılan filtre/sayfalama parametresi

sections
Tür: array object[] · ResponseFc5Af1Fcba22_Section[]

Bölüm sonuçları

items
Tür: array object[] · ResponseFc5Af1Fcba22_SectionItem[]

Bölümdeki öğeler

channel
Tür: object · ResponseFc5Af1Fcba22_SectionChannel
id
Tür: string

Kanal kimliği

link
Tür: string

Kanala bağlantı

title
Tür: string

Kanal adı

id
Tür: string

Öğe kimliği

length
Tür: string

Öğe süresi

link
Tür: string

Öğeye bağlantı

published_time
Tür: string

Yayınlanmasından bu yana geçen süre

thumbnail
Tür: string

Öğe küçük resim URL'si

title
Tür: string

Öğe başlığı

views
Tür: integer

Görüntüleme sayısı

position
Tür: integer

Arama sonuçlarındaki konum

section_title
Tür: string

Bölüm başlığı

shorts
Tür: array object[] · ResponseFc5Af1Fcba22_Shorts[]

YouTube Shorts sonuçları

items
Tür: array object[] · ResponseFc5Af1Fcba22_Short[]

Shorts videoları

duration
Tür: string

Short süresi

id
Tür: string

Shorts video kimliği

link
Tür: string

Short videosuna bağlantı

position
Tür: integer

Shorts bölümündeki konum

thumbnail
Tür: string

Short küçük resim URL'si

title
Tür: string

Short başlığı

views
Tür: integer

Görüntüleme sayısı

position
Tür: integer

Arama sonuçlarındaki konum

section_title
Tür: string

Shorts için bölüm başlığı

suggestions
Tür: array string[]

Arama sorgusu önerileri

videos
Tür: array object[] · ResponseFc5Af1Fcba22_Video[]

Video arama sonuçları

badges
Tür: array string[]

Video rozetleri

channel
Tür: object · ResponseFc5Af1Fcba22_VideoChannel
id
Tür: string

Kanal kimliği

is_verified
Tür: boolean

Kanalın doğrulanmış olup olmadığı

link
Tür: string

Kanala bağlantı

thumbnail
Tür: string

Kanal küçük resim URL'si

title
Tür: string

Kanal adı

description
Tür: string

Video açıklaması alıntısı

id
Tür: string

YouTube video kimliği

is_live
Tür: boolean

Videonun şu anda canlı olup olmadığı

key_moments
Tür: array object[] · ResponseFc5Af1Fcba22_KeyMoment[]

Videodaki önemli anlar

start_seconds
Tür: integer

Anın başlangıç zamanı (saniye cinsinden)

thumbnail
Tür: string

Önemli an küçük resim URL'si

title
Tür: string

Önemli an başlığı

length
Tür: string

Video süresi

link
Tür: string

Videoya bağlantı

position
Tür: integer

Arama sonuçlarındaki konum

published_time
Tür: string

Yayınlanmasından bu yana geçen süre

thumbnail
Tür: object · ResponseFc5Af1Fcba22_Thumbnail
rich
Tür: string

Zengin/animasyonlu küçük resim URL'si

static
Tür: string

Statik küçük resim URL'si

title
Tür: string

Video başlığı

views
Tür: integer

Görüntüleme sayısı
application/json
400

İstek işlenemedi. İstek parametrelerini kontrol edin.
401

Geçerli bir Felo API anahtarı gerekir.
402

Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
403

Hesabın bu işlemi gerçekleştirme izni yok.
429

İstek veya harcama sınırına ulaşıldı.
502

Hizmet isteği tamamlayamadı.
503

API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
504

İstek işlenirken hizmet zaman aşımına uğradı.
default

Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

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'

Şemayı göster

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

Başarılı yanıt

YouTube Araması

Kimlik doğrulamaRequired

YouTube Search

YouTube Araması

Fiyatlandırma referansı