API ile Programatik SEO Otomasyonu: SEOYEN API Rehberi

SEO operasyonları büyüdükçe manuel iş akışları darboğaz yaratır. Her sabah yüzlerce kelimenin sıralamasını kontrol etmek, düzinelerce sitenin backlink profilini incelemek, raporları tek tek oluşturmak saatler alır. Bu noktada API devreye girer: tekrarlayan görevleri otomatikleştirmenin, SEO verilerini kendi sistemlerinize entegre etmenin ve ölçeklenebilir iş akışları oluşturmanın yolu. Bu rehberde SEOYEN API ile programatik SEO otomasyonunun temellerini, yaygın kullanım senaryolarını ve ilk API çağrınızı nasıl yapacağınızı anlatıyoruz.

API kavramlarına girmeden önce platformun genel kullanımını öğrenmek için SEOYEN Başlangıç Kılavuzu‘na göz atmanızı öneriyoruz.

SEO API Nedir?

API (Application Programming Interface), iki yazılım sistemi arasında veri alışverişi yapmanın standart yoludur. SEO bağlamında API, bir SEO platformunun verilerine programatik olarak erişmenizi sağlayan arayüzdür. Panelde fare tıklayarak yaptığınız her işlemi kodla otomatik yapabilirsiniz: kelime sıralaması çekme, site denetimi başlatma, backlink verileri sorgulama, rapor oluşturma.

SEOYEN API, REST mimarisinde çalışan, JSON formatında veri döndüren, API anahtarı ile kimlik doğrulanan bir HTTP arayüzüdür. Her endpoint belirli bir veri setini veya aksiyonu temsil eder. Geliştirici dokümanlarını API Platform sayfasından inceleyebilirsiniz.

API’nin temel farkı ölçeklenebilirliktir. Panelde tek bir kelimeyi kontrol edersiniz; API ile aynı anda bin kelimeyi sorgulayabilirsiniz. Panelde tek bir rapor oluşturursunuz; API ile yüz müşterinin raporunu bir döngüde oluşturabilirsiniz. Bu ölçek farklılığı, ajanslar ve büyük operasyonlar için vazgeçilmezdir.

Neden SEO Otomasyonu Önemlidir?

SEO otomasyonunun üç temel faydası vardır. Birincisi zaman tasarrufudur. Manuel olarak saatler süren görevler dakikalar içinde tamamlanır. Günde iki saat kazanmak ayda kırk saat, yılda yaklaşık beş yüz saatlik bir verimlilik artışı demektir.

İkincisi tutarlılıktır. İnsan hata yapar, bir kelimeyi atlar, yanlış tarih aralığını seçer, bir müşterinin raporunu unutur. Otomasyon her defasında aynı adımları aynı sırayla ve aynı doğrulukla tekrarlar. Bu tutarlılık veri güvenilirliğini artırır.

Üçüncüsü ölçeklenebilirliktir. Beş müşteri yönetmek ile elli müşteri yönetmek arasında manuel iş akışlarıyla on kat fark vardır. Otomasyon ile bu fark neredeyse sıfıra iner çünkü döngü bir müşteri için çalışıyorsa elli müşteri için de aynı şekilde çalışır.

SEOYEN API Kullanım Alanları

Toplu sıralama kontrolü. Her sabah yüzlerce kelimenin güncel sıralamasını çekip kendi veritabanınıza veya Google Sheets tablonuza yazabilirsiniz. Böylece özel dashboard’lar ve uyarı sistemleri kurabilirsiniz.

Otomatik rapor oluşturma. Her ayın ilk günü tüm müşterilerin raporlarını otomatik oluşturup e-posta ile gönderen bir script yazabilirsiniz. Manuel rapor hazırlama süresi sıfıra iner.

Kendi uygulamanıza SEO verisi entegrasyonu. Bir e-ticaret platformu veya CMS geliştiriyorsanız ürün sayfalarının SEO skorunu API üzerinden çekip kullanıcıya gösterebilirsiniz. Hızlı Rapor verilerini kendi arayüzünüzde sunabilirsiniz.

Rakip izleme otomasyonu. Rakiplerin kelime değişimlerini günlük çekip bir Slack kanalına veya e-postaya bildiren otomasyon kurabilirsiniz. Rakip yeni bir kelimede yükseldiğinde anında haberdar olursunuz.

Veri depolama ve analiz. API verilerin kendi veritabanınızda biriktirip uzun vadeli trendler analiz etmenize olanak tanır. Google Sheets, BigQuery veya herhangi bir veri ambarına aktarım yapabilirsiniz.

API Kimlik Doğrulama ve Güvenlik

SEOYEN API, her istekte X-API-Key header’ı ile kimlik doğrulama yapar. Bu anahtar yalnızca sizin hesabınıza bağlıdır ve tüm iletişim HTTPS üzerinden şifrelenmiş olarak gerçekleşir. API anahtarınızı oluştururken ona bir isim verin, örneğin “Günlük Sıralama Scripti” veya “Müşteri Rapor Otomasyonu” gibi. Bu isimlendirme birden fazla anahtarınız olduğunda hangisinin nerede kullanıldığını takip etmenizi kolaylaştırır.

Her API anahtarı bağımsız olarak devre dışı bırakılabilir veya silinebilir. Bir anahtarın tehlikeye girdiğini düşünüyorsanız hemen devre dışı bırakın ve yeni bir anahtar oluşturun. Eski anahtar anında geçersiz olur, yeni anahtarı scripitlerinize tanımlayın.

Anahtarı ortam değişkeninde veya güvenli bir yapılandırma dosyasında saklayın. Asla kaynak koduna gömmeyin, asla Git reposuna commit etmeyin ve asla URL parametresi olarak göndermeyin. Python’da os.environ, Node.js’de process.env, PHP’de getenv veya .env dosyası kullanın. Bu temel güvenlik pratiği API anahtarınızın yetkisiz kullanımını engeller.

Kredi Sistemi ve Maliyet Yönetimi

SEOYEN API kredi tabanlı bir fiyatlandırma modeli kullanır. Her endpoint’in kredi maliyeti farklıdır. Temel bilgi sorgulama endpoint’leri ücretsiz veya çok düşük maliyetlidir, yoğun işlem gerektiren endpoint’ler daha fazla kredi tüketir. API Platform sayfasındaki fiyatlandırma tablosu her endpoint’in kredi maliyetini detaylı gösterir.

Kredi bakiyenizi panelden takip edebilir ve bakiye belirli bir eşiğin altına düştüğünde otomatik yükleme ayarlayabilirsiniz. Bu özellik otomasyonlarınızın kredi yetersizliği nedeniyle durmasını engeller. Otomatik yükleme minimum beş dolarlık eşikle çalışır ve belirlediğiniz miktarı Stripe üzerinden yükler.

Maliyeti optimize etmek için gereksiz çağrılardan kaçının. Aynı veriyi tekrar tekrar sorgulamak yerine yanıtları yerel cache’de tutun. Sıralama verisi günlük güncellenir, aynı kelimeyi dakikada bir sorgulamak kredi israfıdır. Toplu sorgulama endpoint’lerini kullanarak tek istekte birden fazla sonuç almak maliyet açısından daha verimlidir.

İlk API Çağrınızı Yapma

SEOYEN API ile çalışmak için önce bir API anahtarı oluşturmanız gerekir. Panelde API Platform sayfasına gidin ve “Yeni Anahtar Oluştur” butonuna tıklayın. Oluşturulan anahtar X-API-Key header’ı ile gönderilir. Her istek JSON formatında yanıt döner.

Basit bir örnek: Sıralama Takipçisi verilerinizi çekmek istiyorsanız GET isteği ile rank endpoint’ine anahtar kelime ve tarih parametreleriyle sorgu gönderirsiniz. Yanıt olarak kelime pozisyonu, değişim miktarı, arama hacmi ve URL bilgisini JSON olarak alırsınız.

Python ile minimal bir örnek düşünün: requests kütüphanesini kullanarak API endpoint’ine GET isteği gönderirsiniz, headers’a API anahtarınızı eklersiniz ve dönen JSON’ı parse edersiniz. Bu kadar basit. Aynı mantık JavaScript, PHP, Ruby, Go veya herhangi bir dilde geçerlidir çünkü API HTTP standardında çalışır.

Her endpoint’in kredi maliyeti vardır. API Platform sayfasındaki fiyatlandırma tablosu hangi endpoint’in ne kadara mal olduğunu gösterir. Bazı temel endpoint’ler ücretsizdir, bazıları ise sorgu başına kredi tüketir. Kredi bakiyenizi panelden takip edebilir ve otomatik yükleme ayarlayabilirsiniz.

API Kullanımında Yaygın Hatalar

Hata 1: Rate limit’i göz ardı etmek. Her API’nin dakika veya saat başına istek limiti vardır. Limiti aşarsanız 429 hatası alırsınız. Kodunuzda retry mekanizması ve bekleme süresi (exponential backoff) kullanın.

Hata 2: API anahtarını kodda açık bırakmak. Anahtar bir ortam değişkeninde veya güvenli bir yapılandırma dosyasında saklanmalıdır. Git reposuna anahtar commit etmek ciddi bir güvenlik riskidir.

Hata 3: Hata yönetimini atlamak. API bazen geçici hatalar döner: sunucu meşgul, ağ zaman aşımı, geçersiz parametre. Her çağrıyı try-catch ile sarmalayın ve hata durumunda loglama yapın.

Hata 4: Gereksiz çağrı yapmak. Aynı veriyi tekrar tekrar sorgulamak kredi israfıdır. Yanıtları yerel cache’de tutun ve tazelik süresine göre yenileyin. Sıralama verisi günlük güncellenir, dakikada bir sorgulamak anlamsızdır.

Sık Sorulan Sorular

Otomasyonun Gücünü Keşfedin

API ile başlayabileceğiniz en basit otomasyon günlük sıralama verisi çekip bir tabloya yazmaktır. Bu tek adım bile manuel kontrolü ortadan kaldırır. Zamanla daha karmaşık iş akışları oluşturabilirsiniz: rakip değişim alarmları, otomatik raporlama, içerik performans izleme ve çoklu site yönetimi. Platform genelindeki iş akışları için Başlangıç Kılavuzu‘nu referans alın.

Programatik SEO otomasyonu, SEO operasyonlarını insan gücüne bağımlılıktan kurtarmanın en etkili yoludur. Küçük başlayın, tek bir script ile tek bir görevi otomatikleştirin. Sonra kademeli olarak genişletin. Her otomatikleştirdiğiniz görev, stratejiye ve yaratıcılığa ayırabileceğiniz zaman kazandırır.