YouTube Music API Dokümantasyonu

YouTube Music verilerine erişmenize, aramalara, şarkı sözlerine ve daha fazlasına olanak tanıyan kapsamlı bir API

Genel Bakış

Bu API, YouTube Music'e programlı erişim sağlayan bir Flask uygulamasıdır. Trend müzikleri, arama sonuçlarını, sanatçı bilgilerini, çalma listelerini ve daha fazlasını alabilirsiniz. API, ytmusicapi kütüphanesini kullanarak YouTube Music verilerine erişir.

Bu API, kullanıcıların YouTube Music'ten çeşitli verilere erişmesine olanak tanır. Tüm istekler, varsayılan olarak UTF-8 karakter kodlamasını kullanarak JSON yanıtları döndürür.

Kullanım

API, aşağıdaki gibi basit GET istekleri kullanılarak erişilebilir:

GET http://localhost:5000/API/endpoint/

Örneğin, çalma listesi bilgilerini almak için:

GET http://localhost:5000/API/playlist/RDCLAK5uy_ljdExjsU2bwlhBJp34ObF_Irf6xgIwvE8/

Genel Parametreler

Tüm API çağrıları için kullanılabilecek bazı ortak parametreler vardır:

Parametre Açıklama Varsayılan Değer
country İçeriğin hangi ülke için alınacağını belirtir (ISO ülke kodu) TR
language İçeriğin hangi dilde alınacağını belirtir (ISO dil kodu) tr
limit Döndürülecek sonuç sayısını sınırlar 10

API Endpoints

GET /API/tasteprofile/[country]/[language]/

YouTube Music zevk profil bilgilerini alır.

Parametreler
Parametre Tür Gerekli Açıklama
country string Hayır İçeriğin hangi ülke için alınacağını belirtir
language string Hayır İçeriğin hangi dilde alınacağını belirtir
Örnek İstek
GET http://localhost:5000/API/tasteprofile/TR/tr/
Örnek Yanıt
Yanıt 200 OK 
{
  "tasteProfile": [
    {
      "title": "Pop",
      "icon": "MUSIC_NOTE"
    },
    {
      "title": "Rock",
      "icon": "MUSIC_NOTE"
    },
    {
      "title": "Hip Hop",
      "icon": "MUSIC_NOTE"
    }
  ]
}
GET /API/home/[country]/[language]/[limit]/

YouTube Music ana sayfa içeriğini alır.

Parametreler
Parametre Tür Gerekli Açıklama
country string Hayır İçeriğin hangi ülke için alınacağını belirtir
language string Hayır İçeriğin hangi dilde alınacağını belirtir
limit integer Hayır Döndürülecek sonuç sayısını sınırlar
Örnek İstek
GET http://localhost:5000/API/home/TR/tr/5/
Örnek Yanıt
Yanıt 200 OK 
[
  {
    "title": "Hızlı seçimler",
    "contents": [
      {
        "title": "Takip ettiğin müzikler",
        "thumbnails": [...],
        "playlistId": "PLOHoVaTp8R7dWbzzb0Kir0i8O16ZO4rhS"
      },
      {
        "title": "Karışık",
        "thumbnails": [...],
        "playlistId": "RDTMAK5uy_lBBwQqWAPbgBKUkcFlvGnl9xMV9wr1XKs"
      }
    ]
  },
  {
    "title": "Önerilen albümler",
    "contents": [...]
  }
]
GET /API/mood/categories/[country]/[language]/

YouTube Music'teki ruh hali (mood) kategorilerini listeler.

Parametreler
Parametre Tür Gerekli Açıklama
country string Hayır İçeriğin hangi ülke için alınacağını belirtir
language string Hayır İçeriğin hangi dilde alınacağını belirtir
Örnek İstek
GET http://localhost:5000/API/mood/categories/TR/tr/
Örnek Yanıt
Yanıt 200 OK 
[
  {
    "params": "ggMPOg1uXzIxYkNac21YZ2Z0",
    "title": "Enerjik"
  },
  {
    "params": "ggMPOg1jTHRpbVduLXJKWVhT",
    "title": "Romantik"
  },
  {
    "params": "ggMPOg1EMU5DTElaNmNwVnRa",
    "title": "Konsantrasyon"
  }
]
GET /API/mood/playlist/[param]/[country]/[language]/

Belirli bir ruh hali (mood) kategorisindeki çalma listelerini getirir.

Parametreler
Parametre Tür Gerekli Açıklama
param string Evet Mood kategorisinin parametre değeri
country string Hayır İçeriğin hangi ülke için alınacağını belirtir
language string Hayır İçeriğin hangi dilde alınacağını belirtir
Örnek İstek
GET http://localhost:5000/API/mood/playlist/ggMPOg1uXzIxYkNac21YZ2Z0/TR/tr/
Örnek Yanıt
Yanıt 200 OK 
[
  {
    "title": "Motivasyon",
    "playlistId": "PLgzTt0k8mXzEk586ze4BjvDXR7c-TUSnx",
    "thumbnails": [...]
  },
  {
    "title": "Çalışma Motivasyonu",
    "playlistId": "PLgzTt0k8mXzEUSRoXFszQdJYIUvRYWP0p",
    "thumbnails": [...]
  }
]