Google Search Console API nasıl kullanılır?

Google Cloud console'da bir proje oluşturun, Google Search Console API'yi etkinleştirin, OAuth 2.0 kimlik bilgileri oluşturun ve mülke erişimi olan bir Google hesabıyla oturum açın. Ardından dört kaynağa istek gönderebilirsiniz: tıklama, gösterim, CTR ve konum için Search Analytics; dizin durumu için URL Inspection; Sitemaps ve Sites. Tek başına API anahtarları çalışmaz: her çağrı bir OAuth belirteci gerektirir ve kotalar ne kadar veri isteyebileceğinizi sınırlar.

API neleri kapsar, neleri kapsamaz

API'nin tamamı bu kadardır. Bağlantılar, Tarama istatistikleri, Sayfa dizine ekleme raporu ve Core Web Vitals raporu için uç nokta yoktur; bu nedenle yalnızca Search Console arayüzünde kalırlar. URL Inspection, sayfanın canlı testini değil, Google'ın dizinindekileri raporlar.

Erişimi ayarlama

1. Google Cloud console'da bir proje oluşturun veya seçin.
2. Bu proje için Google Search Console API'yi etkinleştirin.
3. OAuth onay ekranını yapılandırın ve bir OAuth istemci kimliği oluşturun.
4. Bir kapsam isteyin: okumak için https://www.googleapis.com/auth/webmasters.readonly, site haritalarını göndermek veya silmek için de https://www.googleapis.com/auth/webmasters.
5. Mülk üzerinde izni olan bir hesapla oturum açın. Performans verilerini okumak için en az okuma erişimi gerekir; API, o hesabın gördüğünü görür.

İlk Search Analytics sorgunuz

POST https://www.googleapis.com/webmasters/v3/sites/sc-domain%3Aexample.com/searchAnalytics/query
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json

{
  "startDate": "2026-09-01",
  "endDate": "2026-09-30",
  "dimensions": ["query", "page"],
  "type": "web",
  "rowLimit": 25000,
  "startRow": 0
}

Site, URL kodlamasıyla yola yazılır: Domain mülkü için sc-domain:example.com, URL-prefix mülkü için sonundaki eğik çizgiyle birlikte tam önek, örneğin https://www.example.com/. En önemli alanlar:

• Tarihler başlangıç ve bitiş dahil olacak şekildedir ve Pasifik Saati'ne göredir.
• type varsayılan olarak web'dir; diğerleri image, video, news, googleNews ve discover'dır. Her biri ayrı bir istek gerektirir.
• Filtreler dimensionFilterGroups içine yazılır; işleçler equals ve contains'ten includingRegex ve excludingRegex'e (RE2 sözdizimi) kadar uzanır.
• rowLimit 1 ile 25.000 arasındadır (varsayılan 1.000); kalanını startRow ile sayfalarsınız.
• dataState varsayılan olarak final'dır; all yeni, henüz tamamlanmamış günleri ekler, hourly_all ise hour boyutuyla çalışır.

Her satır keys, clicks, impressions, ctr (0 ile 1 arası) ve position döndürür; tarihe göre gruplamadığınız sürece tıklamaya göre sıralanır.

Kodunuzu şekillendiren sınırlar

• Arama türü başına günde 50.000 satır. startRow ile 25.000'lik adımlarla sayfalayın ve boş yanıt gelince durun. En fazla veriyi almak için her seferinde tek bir gün sorgulayın.
• Yük kotası. Hem sayfa hem sorguya göre gruplama veya filtreleme en pahalı istektir ve uzun tarih aralıkları kısa olanlardan daha pahalıdır. Kısa vadeli kotayı aşarsanız Google 15 dakika beklemenizi ister.
• İstek hızları. Site ve kullanıcı başına dakikada 1.200 sorgu; proje başına dakikada 40.000 ve günde 30.000.000.
• URL Inspection kotası. Her mülk için günde 2.000 ve dakikada 600 denetim.
• 16 aylık geçmiş; veriler genellikle günün bitmesinden iki üç gün sonra kullanılabilir olur.
• Satırların toplamı genel toplamı vermez. Nadir sorgular sorgu düzeyindeki satırlara dahil edilmez ve sayfaya göre gruplama gösterimleri mülke göre gruplamadan farklı sayar; bu yüzden toplamları sorgu boyutu olmayan bir istekten okuyun.

Sık yapılan hatalar

• Mülk https:// iken http:// kullanmak veya sondaki eğik çizgiyi atlamak, hesabın erişimi olsa bile izin hatası verir.
• URL Inspection'da mülkün dışındaki bir URL istemek reddedilir: URL, ilettiğiniz siteUrl altında olmalıdır.
• Bir ayı tek çağrıda sorgu ve sayfaya göre gruplamak yalnızca en üstteki satırları döndürür. Günlük istekler daha fazla satır döndürür.

AutoPSEO nasıl yardımcı olur

OAuth ve sayfalama yükünü üstlenmek istemezseniz AutoPSEO, Google ile oturum açma üzerinden bağlanır ve aynı verileri /v1 adresindeki kendi REST API'si (bir OpenAPI 3.1 belgesiyle) ve bir MCP sunucusu aracılığıyla sunar; yetkilendirme Account → API keys bölümündeki bir API anahtarıyla yapılır. Salt okunur anahtarlar mevcuttur, search analytics uç noktası çağrı başına en fazla 5.000 satır döndürür ve uygulamanın URL Inspection araçları Google'ın günlük 2.000'lik kotasını sizin yerinize takip eder. Bkz. MCP ve API anahtarları. 16 aydan eski verileri bir işlem hattı yazmadan saklamak için Search Console verileri ne kadar süre saklanır sayfasına bakın.

Kaynaklar: Google'ın API başvurusu, Search Analytics query yöntemi, kullanım sınırları, tüm verilerinizi alma ve yetkilendirme kılavuzu.