Google Search Console API kendi altyapınız için
Search Console performans verileriniz, temiz bir REST uç noktası üzerinden.
Tıklama, gösterim, TO ve ortalama konumu — sorguya, sayfaya ve tarih aralığına göre — doğrudan Google Search Console'dan ürününüze, panelinize veya veri ambarınıza çekin. GSC'yi SEOcrawl AI içinde bir kez bağlayın, panelinizden bir Bearer anahtarı oluşturun ve REST /v1'i çağırın — kendiniz kurmanız gereken bir Google OAuth yok. Bu, SEOcrawl AI MCP'yi çalıştıran aynı kanonik veri katmanı; yani sayılarınız her zaman tutar. İndeksleme kapsamı ve URL İnceleme sırada REST'e geliyor; MCP üzerinden şimdiden canlı.
Bir mülk belirleyin. GSC verilerini çekin.
Panelinizden bir Bearer token oluşturun ve onu Authorization başlığında iletin. Search Console mülkünüzün id'sini bir kez belirleyin, ardından performansını REST üzerinden sorgulayın. Aynı anahtar hem REST API'de hem de MCP sunucusunda çalışır.
Temel URL
https://api.seocrawl.ai/v1Authorization başlığı
Authorization: Bearer sca_live_your_token_hereSearch Console'un tüm metrikleri, REST üzerinden
Tıklama, gösterim, TO ve ortalama konum — sorguya, sayfaya, tarih aralığına ve dönemler arası kıyasa göre. Her uç nokta bir mülke bağlıdır: önce mülkün id'sini belirleyin, sonra Search Console verilerini okuyun. Bu GSC grupları v1'de canlı; indeksleme kapsamı ve URL İnceleme bugün MCP üzerinden sunuluyor ve sırada REST'e geliyor.
Mülkler
Hesabınıza bağlı Search Console mülklerini listeleyin. Her GSC uç noktasının yolunda ilgili mülkün id'sini kullanın.
- GET
/v1/propertiesCanlı
Performans
Bir tarih aralığı için toplam tıklama, gösterim, TO ve ortalama konum — artı aynı pencere için dönemler arası fark.
- GET
/v1/properties/{id}/gsc/summaryCanlı - GET
/v1/properties/{id}/gsc/compareCanlı
Sorgular
Sıralandığınız arama sorguları ve sorgu başına metrikler — artı herhangi bir anahtar kelimenin tam günlük geçmişi.
- GET
/v1/properties/{id}/gsc/top-keywordsCanlı - GET
/v1/properties/{id}/gsc/keywords/detailCanlı
Sayfalar
Search Console metrikleriyle en iyi performans gösteren URL'leriniz — artı herhangi bir sayfanın tam günlük performans dökümü.
- GET
/v1/properties/{id}/gsc/top-pagesCanlı - GET
/v1/properties/{id}/gsc/pages/detailCanlı
İndeksleme kapsamı
Google'ın gerçekte neyi indekslediği: kapsam durumları ve indeksleme geçmişi. Bugün MCP'de canlı; REST uç noktaları yayına alınıyor.
- GET
/v1/properties/{id}/indexation/summaryYakında
URL İnceleme
URL bazında inceleme — tek bir sayfanın kapsamı, son taranma zamanı ve indeksleme durumu. Şu anda MCP üzerinden kullanılabilir; REST sırada.
- GET
/v1/properties/{id}/url-inspectionYakında
Gerçek Search Console verisi, ürünler için tasarlandı
Google Search Console'daki gerçek performansınız — üçüncü taraf tahminleri değil — Bearer kimlik doğrulama ve hız limitleriyle temiz bir REST API üzerinden; MCP ile tek bir kanonik veri katmanı paylaşır, böylece sayılar asla çelişmez.
Doğrudan Search Console'dan
Tıklama, gösterim, TO ve ortalama konum kendi GSC mülkünüzden çekilir — Google'ın raporladığı gerçek sayılar; modellenmiş ya da scraping ile toplanmış tahminler değil. Öngörülebilir kaynaklar, standart HTTP fiilleri, tipli JSON ve RFC uyumlu hatalar.
Kurmanız gereken Google OAuth yok
Search Console'u SEOcrawl AI içinde bir kez bağlayın, sonra tek bir sca_live_ Bearer anahtarıyla okuyun. Google Cloud projesini, izin ekranını ve token yenilemeyi atlayın — anahtarları panelinizden saniyeler içinde oluşturun ve iptal edin.
Tek kanonik veri katmanı
REST GSC uç noktaları ile MCP GSC araçları aynı sağlayıcı üzerinde kardeştir ve eşitlik CI'da test edilir. Paneliniz ve AI ajanlarınız her zaman aynı tıklama, gösterim ve konumları görür.
Sorgu ve sayfa kırılımı
Bir mülkün toplamlarını okuyun ya da derine inin: en iyi sorgular, en iyi sayfalar, tek bir anahtar kelimenin günlük eğilimi veya tek bir URL'nin geçmişi — Search Console'da gördüğünüz boyutların aynısı, HTTP üzerinden erişilebilir.
Dönem karşılaştırması yerleşik
Bir range isteyin (last_7_days, last_28_days, last_3_months, last_year) ya da açık from/to tarihleri verin; dönem karşılaştırmalarını kutudan çıktığı gibi alın — ikinci bir çağrı yok, farkları tutturmak için istemci tarafında tarih hesabı yok.
Belgelenmiş hız limitleri
Token başına dakikada 60 ve saatte 1.000 istek, net 429 + Retry-After yanıtlarıyla. REST limitleri MCP kullanımından ayrı bir havuzdur — biri diğerini asla tüketmez.
Sadece 3 adımda başlayın
Sıfırdan ilk Search Console çağrınıza birkaç dakikada ulaşın.
Bir anahtar oluşturun
Search Console'u SEOcrawl AI'da bağlayın, ardından API token'ları sayfasını açıp bir Bearer token üretin. Bir kez kopyalayın — sca_live_ ile başlar.
Bir mülk belirleyin
Okumak istediğiniz Search Console mülkünün id'sini (bir UUID) almak için Authorization: Bearer sca_live_… ile GET /v1/properties çağırın.
GSC verilerini çekin
Toplamlar için /v1/properties/{id}/gsc/summary?range=last_28_days adresine gidin ya da /gsc/top-keywords, /gsc/top-pages ve /detail uç noktalarını kullanın — ve JSON'u doğrudan ürününüze, panelinize veya ambarınıza aktarın.
Search Console verilerinize ulaşmanın üç yolu
Aynı GSC sayıları, farklı yüzey — nasıl geliştirdiğinize uyanı seçin.
REST API
Ürünler, paneller ve veri hatları için. Bearer kimlik doğrulama, tipli JSON, hız limitleri. Şu an bu sayfadasınız — tam SEO API aynı anahtarla sıralama ve AI görünürlük uç noktaları ekler.
MCP sunucusu
AI ajanları için — Claude, ChatGPT ve herhangi bir MCP istemcisi Search Console verilerinizi doğal dilde sorgular.
MCP'yi keşfedinTerminal ve CLI
Betikler ve CI/CD için — GSC verilerinizi MCP uyumlu herhangi bir terminal ajanından yönetin.
CLI'yi görünSearch Console API üzerine kimler geliştiriyor
Gerçek GSC performans verisini kendi sistemlerinde isteyen ekipler.
Ajanslar
Her müşterinin Search Console verisini özel bir portala, Looker Studio'ya veya raporlama katmanınıza aktarın — tek anahtar, tüm mülkler, elle GSC dışa aktarımı yok.
SaaS ve iş ortakları
Canlı Search Console metriklerini kendi ürün arayüzünüze gömün. Google'ın API'sini kendiniz kurmadan kullanıcılarınıza tıklama, gösterim ve konum verilerini sunun.
Veri ekipleri
GSC tıklama, gösterim, TO ve konum verilerini ambarınıza planlı olarak indirin. Bunları gelirle birleştirin ve panellerinizin ihtiyaç duyduğu modelleri kurun.
Geliştiriciler
Sorgu ve sayfa izlemesini otomatikleştirin, sıralama düşüşlerinde uyarı verin ve Search Console verilerini zaten yayınladığınız uygulamalara ve iş akışlarına bağlayın.
Sıkça sorulan sorular
Bu, Google'ın resmî Search Console API'si mi?
Hayır. Bu, hesabınıza zaten bağladığınız Search Console verileri üzerinde çalışan, SEOcrawl AI'ın kendi Bearer kimlik doğrulamalı REST API'sidir. GSC'yi SEOcrawl AI içinde bir kez bağlarsınız, sonra tıklama, gösterim, TO ve konumu tek ve temiz bir sca_live_ anahtarıyla okursunuz — kendiniz bir Google Cloud projesi, OAuth izin ekranı veya token yenileme kurmadan. Sayılar sizin gerçek Search Console sayılarınızdır; API ve kimlik doğrulama bize aittir.
Bugün hangi Search Console verilerini çekebilirim?
Bir tarih aralığı için toplamlar (tıklama, gösterim, TO, ortalama konum), dönemler arası karşılaştırmalar, metrikleriyle en iyi sorgularınız ve sayfalarınız, tek bir anahtar kelimenin ya da tek bir sayfanın tam günlük detayı — artı bağlı mülklerinizin listesi. İndeksleme kapsamı ve canlı URL İnceleme şu anda MCP üzerinden kullanılabilir; REST uç noktaları sırada. Hesabı sorgulamak yerine okumayı tercih ederseniz, Google Search Console denetimi aynı veriyi tek bir prompt'ta ele alır.
Nasıl kimlik doğrularım?
Bir Bearer token ile. Panelinizden bir sca_live_ anahtarı oluşturun ve her istekte Authorization: Bearer <key> olarak gönderin. Kendi hesabınız için OAuth adımları yok — yalnızca başlık.
Hangi tarih aralıkları destekleniyor?
Her GSC uç noktası ya bir range (last_7_days, last_28_days, last_3_months veya last_year) ya da açık bir from/to çifti alır. gsc/compare uç noktası aynı pencereyi bir önceki dönemle karşılaştırarak döndürür; böylece farkları ikinci bir çağrı olmadan alırsınız.
Hız limitleri nedir?
Token başına dakikada 60 ve saatte 1.000 istek. Bunları aşarsanız Retry-After başlıklı bir 429 alırsınız. REST limitleri MCP kullanımından ayrı izlenir, böylece ikisi asla aynı bütçe için yarışmaz.
MCP ile aynı anahtar ve aynı veri mi?
Evet. Aynı sca_live_ token'ı hem REST API'yi hem de MCP sunucusunu kimlik doğrular ve ikisi de tek bir kanonik veri katmanından okur — yani REST üzerinden çektiğiniz Search Console sayıları, AI ajanlarınızın MCP üzerinden gördükleriyle birebir aynıdır. Tek kimlik bilgisi, iki yüzey.
Search Console verileriniz üzerine geliştirmeye hazır mısınız?
GSC'yi bir kez bağlayın, panelinizden bir Bearer anahtarı oluşturun ve ilk Search Console REST çağrınızı dakikalar içinde yapın — ya da AI ajanları için MCP'yi keşfedin.
