YouTube API

YouTube API

YouTube arama sıralamalarını, video detaylarını, altyazıları ve yorumları herkese açık her video için programatik olarak çekin. Dört rapor tek bir endpoint'te, günlük kota olmadan — üstelik altyazılar yalnızca kendi videolarınız için değil, her video için çalışır.

Tek Endpoint, Dört Rapor Çeviri Destekli Altyazılar Günlük Kota Yok Masaüstü ve Mobil Arama Hatalar Ücretlendirilmez
Python API Example
import requests

response = requests.post(
    "https://data.semust.com/v1/youtube",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "type": "search",
        "keyword": "seo nedir",
        "country": "TR",
        "device": "mobile",
        "limit": 20,
    },
    timeout=90,  # longer than ?wait= (60 seconds by default)
)

data = response.json()
if response.status_code == 202:
    # Still running: collect it later from data["poll_url"]
    print(f"Task {data['task_id']} is still running")
elif response.status_code == 200:
    for row in data["items"]:
        print(f"{row['position']}. [{row['type']}] {row['title']}")
        print(f"   Channel: {row['channel_name']}")
        print(f"   Views: {row['views']}")
Cookshop
ideasoft
Yapı Kredi
beko logo
vialand
defacto
koton
venividi logo
Cookshop
ideasoft
Yapı Kredi
beko logo
vialand
defacto
koton
venividi logo

12.000+ markanın güvendiği Semust ile şimdi tanışın.

Tek Endpoint

Arama, video, altyazı ve yorum raporlarının tamamı `type` parametresiyle seçilir. Öğrenilecek tek bir istek şekli, tek bir kimlik doğrulama, tek bir fiyat listesi.

Herkese Açık Her Video

Yalnızca kendi kanalınızın değil, herkese açık her videonun altyazısını, detaylarını ve yorumlarını okuyun. 11 karakterlik video kimliğini gönderin ya da YouTube bağlantısını olduğu gibi yapıştırın.

Net Fiyatlandırma

20 arama sonucu ya da yorum 0,0022 USD; bir videonun detayları ya da altyazısı 0,0066 USD. Hatalar için asla ücret alınmaz.

YouTube API ile Neler Yapabilirsiniz?

data.semust.com/v1/youtube endpoint'i ile YouTube arama, video, altyazı ve yorum verisine erişin.

Bir anahtar kelime için YouTube sonuçlarını, gerçek bir izleyicinin gördüğü sıralamayla alın: videolar, Shorts, oynatma listeleri, kanallar ve reklamlar, her biri pozisyonuyla birlikte. Aramanın hangi ülkeden yapılacağını, arayüz dilini ve masaüstü ya da mobil görünümü siz seçin. Her satırda başlık, standart bağlantı, kanal, izlenme sayısı, süre ve canlı yayın bilgisi yer alır — tek istekte 200 sonuca kadar.

// POST /v1/youtube
// { "type": "search", "keyword": "seo nedir", "limit": 20 }
{
  "type": "search",
  "keyword": "seo nedir",
  "country": "TR",
  "device": "desktop",
  "total": 628065,
  "items": [
    {
      "position": 1,
      "type": "video",
      "title": "SEO Nedir? Yeni Başlayanlar İçin",
      "video_id": "Xk9mP2qR7tA",
      "channel_name": "Example Channel",
      "views": 241552,
      "duration_seconds": 180,
      "is_live": false
    },
    {
      "position": 2,
      "type": "playlist",
      "title": "SEO Eğitimi Serisi",
      "views": null,
      "video_count": 20
    }
  ],
  "cost": 0.0022
}

Tek bir platform,Organik başarı hikayeleri:

Batuhan Durmaz

Batuhan Durmaz

SEO Uzmanı

SEMUST SEO çalışmalarımız için oldukça değerli verileri çok basit ve anlaşılır bir şekilde bize sunmakta olan harika bir araç. Rakip araçlara baktığımızda çok uygun fiyatlara, çok iyi veriler elde etmek mümkün. Ben SEMUST'ı hem yerli hem de global projelerde anahtar kelime analizleri, Google search console verisi, Sıralama takibi ve içerik üretimi için kullanıyorum. Oldukça da memnunum.

Selen Çetin

Selen Çetin

SEO Uzmanı

Semust'la ilk olarak LinkedIn'de karşılaşmıştım, o zamanlar yeni yeni duyuluyordu. Merak edip denemiştim, şimdi severek kullandığım araçlardan biri haline geldi. Özellikle manuel olarak yapmam gereken birçok işi tek tıkla halletmesi, işimi ciddi anlamda kolaylaştırıyor. İlk kullandığım zamandan bu yana ne kadar hızlı geliştiğini görmek de ayrıca güven veriyor.

Aykut Özcan

Aykut Özcan

SEO Director - Digital UP

Digital UP SEO Ajansı olarak, SEO süreçlerimizde Semust'un sunduğu analiz ve raporlama araçlarından büyük ölçüde faydalanıyoruz. Anahtar kelime takibinden rekabet analizine, site sağlığı taramalarından backlink denetimine kadar birçok kritik alanda bize hız ve derinlik kazandırıyor. Özellikle veri odaklı stratejiler geliştirmemizde sağladığı kapsamlı içgörüler sayesinde, müşterilerimizin arama motorlarındaki performansını istikrarlı biçimde artırıyoruz. Semust, ajansımızın büyüme yolculuğunda güçlü bir destekçidir.

YouTube API Sıkça Sorulan Sorular

YouTube API Nedir ve Nasıl Çalışır?

YouTube API, YouTube'daki arama sonuçlarına, video bilgilerine, altyazılara ve yorumlara programatik olarak erişmenizi sağlayan bir arayüzdür. YouTube'da aramaları tek tek elle yapmak ya da videoları izleyip not almak yerine, kendi uygulamanızdan tek bir HTTP isteğiyle bu verileri yapılandırılmış JSON olarak alırsınız. Video stratejisini veriyle yönetmek isteyen içerik ekipleri, ajanslar ve markalar için güçlü bir yapı taşıdır.

Semust YouTube API tek bir endpoint üzerinden çalışır: data.semust.com/v1/youtube adresine gönderdiğiniz POST isteğinde type parametresiyle search, video, transcript veya comments raporunu seçersiniz. Kimlik doğrulama SEMUST-API-USER ve SEMUST-API-PASSWORD header'larıyla yapılır. 60 saniyeden uzun süren bir istek bağlantıyı açık tutmak yerine bir task_id döndürür; sonucu daha sonra alırsınız.

YouTube Verisi SEO ve İçerik Stratejisi İçin Neden Önemli?

Pek çok konuda kullanıcılar aramalarını doğrudan YouTube'da yapar. Bir anahtar kelimede hangi videoların üst sıralarda olduğu, sonuçlarda Shorts'un mu yoksa uzun videoların mı öne çıktığı ve hangi kanalların tekrar tekrar karşınıza çıktığı, hangi içeriği hangi formatta üretmeniz gerektiğini doğrudan gösterir.

Bu veriyi düzenli olarak toplamak, rakip bir videonun sizinkini geride bıraktığı anı ya da konunuzda hızla yükselen yeni bir kanalı fark etmenizi sağlar. Takibi API üzerinden otomatikleştirdiğinizde bu değişimleri kimsenin elle kontrol etmesine gerek kalmadan yakalarsınız.

YouTube Arama Sıralaması Takibi

search raporu bir anahtar kelime için sonuçları sıralama düzeninde döndürür: videolar, Shorts, oynatma listeleri, kanallar ve reklamlar, her biri pozisyonuyla birlikte. country ile aramanın yapıldığı ülkeyi, language ile arayüz dilini, device ile masaüstü ya da mobil görünümü seçersiniz. limit ile tek istekte 200 sonuca kadar alabilirsiniz; total alanı ise YouTube'un bildirdiği sonuç sayısını verir.

YouTube arama sonuçlarında göreli tarih gösterdiği için ("5 yıl önce" gibi) published_at değeri burada yaklaşıktır; bir videonun kesin yayın tarihine ihtiyacınız olduğunda bunu video raporu verir. Sıralama verisini video detaylarıyla birleştiren raporlar kurarken hangi değerin kesin, hangisinin yaklaşık olduğunu bilmek önemlidir.

Altyazılarla Videoyu Metne Dönüştürmek

transcript raporu bir videonun altyazısını tek parça düz metin olarak ve start, end ve text alanlarından oluşan zaman damgalı bölümler halinde döndürür. Rakip bir videonun neyi, hangi sırayla anlattığını okumak, bir videodan blog yazısı ya da özet çıkarmak veya videolarda geçen konuları ve ifadeleri analiz etmek için videoyu baştan sona izlemeniz gerekmez.

Altyazılar yalnızca kendi videolarınız için değil, herkese açık her video için çalışır. video raporu bir videonun hangi dillerde altyazısı olduğunu listeler; transcript_language ile bunlardan birini seçer, translate_to ile altyazıyı başka bir dile çevrilmiş olarak alırsınız. Altyazılar 30 gün önbellekte tutulur.

YouTube API Fiyatlandırması

search ve comments raporları başlanan her 20 sonuçluk blok için 0,0022 USD olarak ücretlendirilir; bu yüzden 20 ve 40 en verimli limit değerleridir. 200 sonuçluk en büyük arama 0,022 USD tutar. video ve transcript raporları ise istek başına 0,0066 USD'dir. İstek gönderildiğinde limit kadarının ücreti bakiyenizden bloke edilir ve kullanılmayan kısım hemen iade edilir.

Sonuçsuz bir arama ya da yorum listesi geçerli bir yanıttır ve tek blok olarak ücretlendirilir. Arama sonuçları, video detayları ve yorumlar 24 saat, altyazılar 30 gün önbellekte tutulur; önbellekten dönen yanıt "cached": true ile işaretlenir ve canlı yanıtla aynı ücreti öder. Bir hata için asla ücret alınmaz, başarısız bir task'ın ücreti ise tamamen iade edilir.

Video ve Yorum Analizi

video raporu bir videonun performansını tek çağrıda özetler: izlenme, beğeni ve yorum sayısı, kanalın abone sayısı, kesin yayın tarihi, süre, kategori ve yükleyenin eklediği etiketler. Rakiplerin hangi etiketleri kullandığını, hangi uzunlukta ve hangi kategoride içerik ürettiğini bu veriden okuyabilirsiniz.

comments raporu bir videonun öne çıkan yorumlarını yazar, metin, beğeni ve yanıt sayısıyla döndürür; total alanı videonun toplam yorum sayısını verir. İzleyicilerin sorduğu sorular ve dile getirdiği ihtiyaçlar, bir sonraki videonuzun ya da SSS sayfanızın konusunu belirlemek için doğrudan bir kaynaktır.

Ülkeler, Diller ve Temiz Veri

GET /v1/youtube/markets endpoint'i desteklenen tüm ülkeleri ve arama dillerini ücretsiz olarak listeler. country varsayılan olarak TR'dir; aramanın arayüz dili ve altyazı dili TR için varsayılan olarak tr, diğer ülkelerde en olur. video_id alanına 11 karakterlik kimliği ya da watch?v=, youtu.be/, shorts/, embed/ veya live/ biçimindeki herhangi bir YouTube bağlantısını gönderebilirsiniz.

Yanıtlar doğrudan kullanıma hazırdır: olmayan ya da geçerli olmayan bir değer 0 değil null döner — örneğin bir oynatma listesinde views null'dır. URL'ler izleme parametreleri olmadan standart biçimdedir, tarihler UTC olarak ISO 8601 formatındadır. Böylece veriyi kendi tarafınızda temizlemekle uğraşmazsınız.

YouTube API Entegrasyonu

Entegrasyon için tek ihtiyacınız API kullanıcı adı ve şifresidir; bunları hesap panelinizdeki API Erişimi sayfasından oluşturabilirsiniz. İstekler standart HTTP POST'tur, yanıtlar JSON'dur ve herhangi bir dilden çağrılabilir. Dokümantasyonda cURL ve Python örnekleri, Task'lar sayfasında ise 202 yanıtlarını sizin yerinize takip eden, Python ve Node.js için hazır bir call() yardımcısı bulunur.

Zaman aşımına uğrayan bir isteği güvenle tekrarlayabilmeniz için idempotency_key desteği vardır: aynı anahtarla tekrarlanan istek aynı task'ı döndürür ve yalnızca bir kez ücretlendirilir. Seçilen rapor için geçerli olmayan bir parametre yok sayılmaz, reddedilir; yanlış yazılmış bir parametre ise hatada adıyla ve bir öneriyle bildirilir. Her API kullanıcısı aynı anda en fazla 10 istek çalıştırabilir.

Daha fazla organik trafik 

  • 14 gün ücretsiz deneme
  • Kurulum gerekmez
  • Search Console entegrasyonu