Sıralama İzleyici API'si

Giriş

Yüzlerce web sitesini, binlerce anahtar kelimeyi veya otomatik olarak güncellenmesi gereken SEO raporlarını yönetirken, sıralama takibi çok farklı bir sorun haline gelir.

Kontrol paneline giriş yapıp verileri manuel olarak dışa aktarmak, daha küçük projeler için işe yarayabilir. Ancak büyük ölçekte bu, hızla bir darboğaz haline gelir.

İşte bu nedenle Ranktracker API'sini'yi geliştirdik.

Ranktracker API şu anda kullanıma açıktır ve geliştiricilere, SEO ekiplerine, ajanslara, SaaS şirketlerine ve veri ekiplerine Ranktracker verilerine programlı erişim imkanı sunar.

API'yi şu amaçlarla kullanabilirsiniz:

• En iyi 100 anahtar kelime sıralamasını alın
• SERP verilerine erişin
• AI Özetlerini ve diğer SERP özelliklerini tespit edin
• İzlenen alan adlarını oluşturma ve yönetme
• Anahtar kelimeleri ekleyin ve yönetin
• Rakipleri takip edin
• Sıralama geçmişine erişin
• Ses Payını hesaplayın
• Anahtar kelimeleri etiketler kullanarak düzenleyin
• Hesap kullanımını ve kotayı izleyin
• Otomatik SEO raporlama süreçleri oluşturun
• Sıralama verilerini şirket içi uygulamalara ve gösterge panellerine bağlayın

SEO verilerini platformlar arasında manuel olarak aktarmak yerine, Ranktracker API'si kendi yazılımınızın Ranktracker'ın arkasındaki sıralama altyapısıyla doğrudan çalışmasını sağlar.

API anahtarınızı oluşturun veya yönetin: https://app.ranktracker.com/account/api

API belgelerini okuyun: https://developers.ranktracker.com/

Ranktracker API Nedir?

Ranktracker Ranktracker API , Ranktracker hesabınıza programlı erişim sağlayan bir REST API'sıdır.

Sıralama bilgilerine her ihtiyaç duyduğunuzda Ranktracker'ı açmak yerine, uygulamanız verileri otomatik olarak talep edebilir.

API, Ranktracker genelinde kullanılan aynı temel kaynaklar etrafında yapılandırılmıştır:

• Hesaplar
• Alan Adları
• Anahtar kelimeler
• Rakipler
• Sıralama geçmişi
• SERP verileri
• Ses Payı
• Etiketler
• Kullanım ve kota

Bu, geliştiricilere hem Ranktracker verilerini alma hem de Ranktracker'ın izlediği öğeleri yönetme olanağı sağlar.

Örneğin, bir SEO ajansı, yeni bir müşteri CRM sistemine girdiğinde otomatik olarak bir Ranktracker projesi oluşturabilir, müşterinin anahtar kelimelerini ve rakiplerini ekleyebilir ve ardından sıralamalarını dahili bir raporlama panosuna aktarabilir.

Bir SaaS platformu, aynı API'yi kullanarak sıralama verilerini doğrudan kendi ürünü içinde görüntüleyebilir.

Bir veri ekibi, daha ayrıntılı analiz için günlük sıralamaları otomatik olarak BigQuery, Snowflake, PostgreSQL, Google Sheets veya başka bir veri ambarına gönderebilir.

Kaynakların birbiriyle nasıl bütünleştiğine dair genel bir bakış için Ranktracker API Temel Kavramlar kılavuzuna'e bakın.

Varsayılan Olarak İlk 100 Sıralaması

Ranktracker API'sinin en büyük avantajlarından biri, sıralama verilerinin derinliğidir.

Her anahtar kelime kontrolü, varsayılan olarak Google'ın ilk 100 sonucunu içerir.

Bu, yalnızca şu anda birinci sayfada sıralanan sonuçları görmek yerine, arama sonuçlarının 10 sayfasının tamamını analiz edebileceğiniz anlamına gelir.

Bu önemlidir çünkü SEO'daki ilerleme genellikle bir anahtar kelime Top 10'a girmeden çok önce başlar.

Bir anahtar kelime şu şekilde hareket edebilir:

91. sıra → 63. sıra → 37. sıra → 18. sıra → 9. sıra

Bu, önemli bir SEO ilerlemesini temsil eder.

Sıralama verileriniz ilk 10 sonuçla sınırlıysa, bu sürecin neredeyse tamamı görünmez kalır.

İlk 100 izleme özelliği, şunları takip etmenizi sağlar:

• Google'ın İlk 100'üne giren yeni sıralamalar
• Birinci sayfaya yükselen anahtar kelimeler
• Büyük sıralama kazançları ve kayıpları
• Rakip hareketleri
• Uzun kuyruklu arama görünürlüğü
• Yeni içerik performansı
• Programatik SEO kampanyaları
• Büyük anahtar kelime portföyleri

Bu, API'yi hem üst düzey SEO raporlaması hem de ayrıntılı sıralama analizi için kullanışlı hale getirir.

API hakkında daha fazla bilgi edinin:

https://developers.ranktracker.com/

107.000'den Fazla Konumda Sıralamaları İzleyin

Arama sonuçları, aramanın yapıldığı yere göre önemli ölçüde değişiklik gösterir.

Ranktracker, 107.000'den fazla konumu destekler ve ekiplere API aracılığıyla yerel, ulusal ve uluslararası arama görünürlüğünü izleme olanağı sunar.

Anahtar kelime takibi, aşağıdakiler dahil olmak üzere çeşitli faktörlere göre yapılandırılabilir:

• Arama motoru
• Konum
• Dil
• Cihaz

Örneğin, aynı anahtar kelime aşağıdakiler için ayrı ayrı izlenebilir:

• Amerika Birleşik Devletleri — masaüstü
• Amerika Birleşik Devletleri — mobil
• Birleşik Krallık — masaüstü
• Almanya — mobil
• Polonya — masaüstü

Her yapılandırma, ayrı bir izlenen anahtar kelime olarak değerlendirilebilir.

Bu özellikle aşağıdakiler için yararlıdır:

• Uluslararası SEO
• Birden fazla lokasyonda faaliyet gösteren işletmeler
• Yerel SEO ajansları
• E-ticaret işletmeleri
• Farklı pazarlarda faaliyet gösteren yayıncılar
• Birden fazla ülkeyi hedefleyen SaaS şirketleri
• Kurumsal SEO ekipleri

Bir anahtar kelimeyi tek bir genel sıralama pozisyonuna sahipmiş gibi ele almak yerine, farklı pazarlarda ve cihazlarda görünürlüğün nasıl değiştiğini analiz edebilirsiniz.

Masaüstü ve Mobil Sıralama Takibi

Masaüstü ve mobil arama sonuçları farklılık gösterebilir.

Bu nedenle Ranktracker, anahtar kelime takibinin cihaza göre segmentlere ayrılmasına olanak tanır.

Bu, bir entegrasyonun aşağıdakileri ayrı ayrı analiz edebileceği anlamına gelir:

• Masaüstü sıralamaları
• Mobil sıralamalar

Örneğin, bir sayfa masaüstünde üst sıralarda yer alırken, SERP düzeni, yerel sonuçlar veya diğer arama özelliklerindeki farklılıklar nedeniyle mobil cihazlarda farklı bir performans gösterebilir.

Bu veri kümelerini ayrı tutmak, SEO ekiplerine kullanıcıların arama sonuçlarında web siteleriyle nasıl karşılaştıklarına dair çok daha net bir resim sunar.

API ayrıca, Share of Voice gibi özelliklerle çalışırken cihaz segmentasyonuna da olanak tanır.

SERP Özellikleri ve AI Genel Bakış Algılama

Modern Google sonuçları, geleneksel organik listelemelerden çok daha fazlasını içerir.

SERP'ler şunları içerebilir:

• AI Genel Bakışları
• Öne çıkan alıntılar
• Haritalar
• Yerel sonuçlar
• Videolar
• Alışveriş sonuçları
• Kullanıcılar ayrıca şunu soruyor
• Diğer arama özellikleri

Ranktracker API'si, anahtar kelime verilerinin yanı sıra SERP özellik bilgileri ve AI Genel Bakış algılamasını da içerir.

Bu, entegrasyonunuzun yalnızca bir web sitesinin sıralamasını değil, aynı zamanda Google'da bu sıralamanın çevresinde neler olduğunu da analiz edebileceği anlamına gelir.

Örneğin, şunları belirleyebilirsiniz:

• AI'yı tetikleyen anahtar kelimeler Genel Bakış
• Öne çıkan alıntılar içeren SERP'ler
• Video sonuçlarının ağırlıkta olduğu arama sorguları
• Yerel veya harita sonuçları üreten anahtar kelimeler
• Zaman içinde SERP bileşimindeki değişiklikler

Organik konum tek başına her zaman tüm hikayeyi anlatmadığı için bu giderek daha önemli hale gelmektedir.

Geleneksel bir SERP'de üçüncü sırada yer alan bir sayfa ile AI Overview, harita paketi, videolar ve "Kullanıcılar Ayrıca Şunları Soruyor" bölümünün altında üçüncü sırada yer alan bir sayfa, çok farklı görünürlük düzeylerine sahip olabilir.

API, bu farklılıkların SEO analizinizin bir parçası olmasını sağlar.

API belgelerinin tamamını inceleyin:

https://developers.ranktracker.com/

Eksiksiz SERP Verilerine Erişin

Ranktracker, tek bir sıralama rakamından çok daha fazlasını sunabilir.

İzlenen anahtar kelimeler için API, en son arama sonuçlarını ilgili SERP bilgileriyle birlikte sunabilir.

API kaynak yapısı şunları içerir:

• En son SERP verileri
• Sıralama bilgileri
• SERP özellikleri
• Önbelleğe alınmış SERP HTML

Bu, geliştiricilerin sadece şunun gibi bir şeyi depolamak yerine, gerçek arama sonuçları etrafında iş akışları oluşturabilecekleri anlamına gelir:

Sıra: 12

İleri düzey SEO ekipleri için bu, çok daha fazla esneklik sağlar.

SERP bilgilerini şu amaçlarla kullanabilirsiniz:

• Rakip URL'leri analiz etme
• Beklenmedik sıralama değişikliklerini araştırın
• Sonuç düzenlerindeki değişiklikleri belirleme
• Dahili SERP analiz araçları oluşturun
• Geçmiş SERP bilgilerini depolayın
• Arama sonucu bilgilerini diğer modellere veya analiz sistemlerine aktarın

Tam uç nokta referansı burada bulunabilir:

https://developers.ranktracker.com/rest-api/

API Aracılığıyla Etki Alanlarını Yönetme

Etki alanları, Ranktracker API'sının temel kaynaklarından biridir.

REST API ile şunları yapabilirsiniz:

• Etki alanları oluşturun
• Etki alanlarını geri getirin
• Alan adlarını güncelleyin
• Etki alanlarını silin

Bir alan adı, Ranktracker içinde izlenen bir siteyi temsil eder.

Her alan adı kendi aşağıdakileri içerebilir:

• Anahtar kelimeler
• Rakipler
• Sıralama geçmişi
• Ses Payı verileri

Bu, otomatik entegrasyonu mümkün kılar.

Örneğin, bir ajans aşağıdaki iş akışını oluşturabilir:

Yeni müşteri kaydolur
        ↓
Ranktracker etki alanı oluşturulur
        ↓
Müşterinin anahtar kelimeleri eklenir
        ↓
Rakipler eklenir
        ↓
Sıralama takibi başlar
        ↓
Veriler raporlama panosuna gönderilir

Bir ekip üyesinin her yeni projeyi manuel olarak yapılandırmasına gerek yoktur.

Ayrıntılı bir kılavuz, "Etki Alanı Ekleme ve Anahtar Kelimeleri İzleme" eğitimindebulunmaktadır.

Anahtar Kelimeleri Programlı Olarak Ekleme ve Yönetme

Bir alan adı oluşturulduktan sonra, anahtar kelimeler API aracılığıyla yönetilebilir.

API'yi kullanarak, izlenen anahtar kelimeleri eklerken bunlarla ilişkili arama yapılandırmasını da belirleyebilirsiniz.

İzlenen anahtar kelime verileri aşağıdaki faktörleri içerebilir:

• Kelime
• Arama motoru
• Konum
• Dil
• Cihaz
• Sıralama sonuçları

Mevcut anahtar kelimelerin izleme yaşam döngüsünü de yönetebilirsiniz.

Bu, aşağıdakileri yapma olanağını içerir:

• Anahtar kelimeleri al
• Sıralama bilgilerini okuyun
• İzlemeyi duraklat
• İzlemeyi devam ettir
• İzlemeyi durdur
• SERP bilgilerine eriş
• Etiket atayın

Bu, kendi uygulamanızın Ranktracker'ın hangi anahtar kelimeleri izleyeceğini kontrol etmesini mümkün kılar.

Toplu Anahtar Kelime İzleme

Büyük SEO hesapları, her anahtar kelime için ayrı bir API isteği yapmak zorunda kalmamalıdır.

Ranktracker, toplu anahtar kelime işlemlerini destekler.

Anahtar kelime oluşturma uç noktası, " kelime sayısı × arama motoru sayısı" yapılandırmasını kabul eder ve tek bir istekle çok sayıda izlenen anahtar kelime kombinasyonunun oluşturulmasına olanak tanır.

Örneğin, şunları izlemek istediğinizi varsayalım:

• 100 anahtar kelime
• ABD masaüstü
• ABD mobil

Bu yapılandırmalar, 200 ayrı kurulum isteği gerektirmeden 200 izlenen anahtar kelime kombinasyonu oluşturabilir.

Toplu işlemler özellikle aşağıdakiler için kullanışlıdır:

• Ajanslar
• Kurumsal SEO
• Büyük e-ticaret mağazaları
• Programatik SEO
• SaaS SEO platformları
• Büyük içerik yayıncıları

Ranktracker ayrıca toplu anahtar kelime etiketlemeyi de destekler.

Toplu işlemler kılavuzunun tamamını okuyun:

https://developers.ranktracker.com/guides/bulk-operations/

SEO Rakiplerini Takip Edin

Sıralamalar, rekabet bağlamını da içerdiğinde çok daha yararlı hale gelir.

Ranktracker API'si, izlenen alan adlarına göre rakiplerin yönetilmesine olanak tanır.

Bu sayede, arama performansınızı rakip web siteleriyle birlikte otomatik olarak analiz etmeniz mümkün olur.

Rakip verilerini aşağıdakileri izlemek için kullanabilirsiniz:

• Hangi rakipler görünürlük kazanıyor?
• Hangi siteler alan adınızı geride bırakıyor
• Paylaşılan anahtar kelime gruplarındaki değişiklikler
• Rekabetçi sıralama eğilimleri
• Göreceli arama görünürlüğü
• Ses Payı değişiklikleri

Ajanslar için bu, otomatik müşteri raporlama sisteminin bir parçası haline gelebilir.

Her ay bir müşteriyi rakiplerle manuel olarak karşılaştırmak yerine, ilgili veriler doğrudan raporlama sürecine entegre edilebilir.

Geçmiş Sıralama Verilerine Erişin

Mevcut sıralamalar yalnızca şu anda neler olduğunu gösterir.

Tarihsel sıralama verileri, SEO performansının hangi yönde ilerlediğini gösterir.

Ranktracker, API aracılığıyla alan adı sıralama geçmişini sunarak geliştiricilerin zaman içindeki görünürlüğü analiz etmelerine olanak tanır.

Geçmiş veriler şunları belirlemenize yardımcı olabilir:

• Sıralamadaki yükselişler
• Sıralamadaki düşüşler
• Görünürlük eğilimleri
• Anahtar kelime hareketleri
• SEO kampanyaları sonrası değişiklikler
• Google güncellemesinin etkisi
• Uzun vadeli kampanya performansı

Sıralama geçmişini kullanarak özel grafikler ve gösterge panelleri de oluşturabilirsiniz.

Örneğin:

Ranktracker API
       ↓
Günlük sıralama verilerinin alınması
       ↓
Veri ambarı
       ↓
Tarihsel SEO veri kümesi
       ↓
Kontrol Paneli / Uyarılar / Analiz

Ranktracker, günlük sıralamaları bir veri ambarına aktarmayı gösteren özel bir eğitim sunar:

https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Ranktracker Verilerini Bir Veri Ambarına Gönderme

En kullanışlı API iş akışlarından biri, Ranktracker verilerini kendi veritabanınıza veya veri ambarınıza otomatik olarak kaydetmektir.

Örneğin, sıralama verileri şu yerlere gönderilebilir:

• BigQuery
• Snowflake
• PostgreSQL
• MySQL
• Google E-Tablolar
• Dahili analiz veritabanları

Bu bilgiler daha sonra diğer iş verileriyle birleştirilebilir.

Örneğin:

Ranktracker
     ↓
Ranktracker API
     ↓
Veri Ambarı
     ↓
Google Search Console
Analytics
Dönüşümler
Gelir
CRM Verileri
     ↓
İş Zekası Panosu

Bu, SEO performansına dair çok daha kapsamlı bir tablo oluşturur.

Bir anahtar kelimenin 8. sıradan 3. sıraya yükseldiğini bilmek yerine, bu değişikliğin aşağıdakileri de beraberinde getirip getirmediğini analiz edebilirsiniz:

• Daha fazla organik tıklama
• Daha fazla potansiyel müşteri
• Daha yüksek dönüşüm oranları
• Artan gelir

" Sıralamalardan Veri Ambarına öğreticisi , bu tür bir iş akışının oluşturulmasına dair bir örnek sunar.

Ses Payı Raporları Oluşturun

Ranktracker API'si, Ses Payı verilerini de sunar.

Ses Payı, izlenen bir anahtar kelime kümesinde bir alan adının ne kadar görünür olduğuna dair daha kapsamlı bir ölçüm sağlar.

Şu soruyu sormak yerine:

Bu anahtar kelime için sıralamamız nedir?

şöyle sorabilirsiniz:

Bu arama pazarının genelinde ne kadar görünürüz?

Bu, rakip verileri de dahil edildiğinde özellikle etkili hale gelir.

Share of Voice API'si aşağıdakileri analiz etmek için kullanılabilir:

• Genel görünürlüğünüz
• Rakip görünürlüğü
• Zaman içinde değişen görünürlük
• Göreceli pazar konumu
• Masaüstü görünürlüğü
• Mobil görünürlük

Uç nokta, tarih aralıklarını ve cihaz segmentasyonunu destekler; böylece Share of Voice, özel SEO raporlarına dahil edilebilir.

Tam bir uygulama örneği burada mevcuttur:

https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Anahtar Kelimeleri Etiketlerle Düzenleyin

Büyük anahtar kelime portföyleri, düzenlendirilmedikçe yönetilmesi zor hale gelir.

Ranktracker, izlenen anahtar kelimelere eklenebilen hesap düzeyinde etiketler sunar.

Aşağıdakiler için etiketler oluşturabilirsiniz:

• Ürün kategorileri
• Arama niyeti
• Konumlar
• İçerik türleri
• Kampanyalar
• Müşteriler
• Huni aşamaları
• İş birimleri
• SEO ekipleri

Örneğin:

"koşu ayakkabısı satın al" → Ticari
"en iyi koşu ayakkabısı" → Karşılaştırma
"koşu ayakkabısı nasıl temizlenir" → Bilgilendirici

Aynı etiketler, farklı alan adları ve anahtar kelime grupları arasında yeniden kullanılabilir.

Ranktracker ayrıca toplu etiketleme özelliği sunar; böylece büyük anahtar kelime grupları, tek tek isteklerde bulunmaya gerek kalmadan düzenlenebilir.

Konuyla ilgili ayrıntılı bir eğitim kılavuzu burada mevcuttur:

https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

Hesap Kullanımını ve Kotayı İzleme

Otomatik sistemlerin, kendilerine sunulan hesap kaynaklarını da anlaması gerekir.

Ranktracker API'si şunları sağlar:

GET /v1/account/usage

Bu uç nokta, hesap kullanımını ve sınırlarını bildirir.

Güncel kullanım bilgileri şunları içerebilir:

• API erişim durumu
• Anahtar kelimeler
• Veri satırları
• Talep üzerine kullanım
• SERP Analizcisi kullanımı

Her kota, aşağıdaki gibi değerler sağlayabilir:

• Kullanım
• Sınır
• Kalan

Bu, bir uygulamanın büyük bir işlemi başlatmadan önce kullanılabilir kapasiteyi kontrol etmesini sağlar.

Örneğin, binlerce anahtar kelimeyi içe aktarmadan önce, sisteminiz hesap kullanımını sorgulayabilir ve ne kadar kapasite kaldığını belirleyebilir.

Kılavuzun tamamını okuyun:

https://developers.ranktracker.com/guides/usage-and-quota/

Ranktracker API Kimlik Doğrulaması Nasıl Çalışır?

Ranktracker REST API istekleri, bir API anahtarı kullanılarak doğrulanır.

Anahtarlarınızı doğrudan Ranktracker içinde oluşturabilir ve yönetebilirsiniz:

https://app.ranktracker.com/account/api

API anahtarınız her zaman bir şifre gibi ele alınmalıdır.

Üretim API temel URL'si şöyledir:

https://api.ranktracker.com

API kaynakları /v1 yolu altında bulunur.

Örneğin:

https://api.ranktracker.com/v1/domains

API anahtarı, doğrudan Authorization başlığında gönderilir.

Standart REST API istekleri için Bearer öneki yoktur.

Örnek:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

Ranktracker API anahtarı sunucu tarafında saklanmalı ve asla aşağıdakiler yoluyla ifşa edilmemelidir:

• Tarayıcı JavaScript
• Ön uç kaynak kodu
• Herkese açık depolar
• Mobil uygulama kodu
• Herkese açık yapılandırma dosyaları

Daha fazla bilgi için şunu okuyun:

Hızlı Başlangıç: https://developers.ranktracker.com/guides/quickstart/

Kimlik Doğrulama: https://developers.ranktracker.com/guides/authentication/

API anahtarlarını oluşturma/yönetme: https://app.ranktracker.com/account/api

API Kaynak Yapısı

Ranktracker, kaynakları tanımlamak için UUID'leri kullanır.

Bunlar arasında şunlar yer alır:

• Etki alanları
• Anahtar kelimeler
• Rakipler
• Etiketler

Basitleştirilmiş bir gösterimi şu şekildedir:

Hesap
│
├── Kullanım
├── Etiketler
│
└── Alan Adları
    │
    ├── Sıralama geçmişi
    ├── Ses Payı
    ├── Rakipler
    │
    └── Anahtar Kelimeler
        │
        ├── SERP
        ├── Önbelleğe Alınmış SERP HTML
        └── Etiketler

Bu, API yapısını öngörülebilir hale getirir.

Bir alan adının anahtar kelimeleri ve rakipleri vardır.

Bir anahtar kelime, izlenen bir etki alanına aittir ve ilişkili SERP ve sıralama bilgilerine sahiptir.

Etiketler hesap düzeyinde bulunur ve anahtar kelimelere eklenebilir.

Daha fazla bilgi:

https://developers.ranktracker.com/guides/concepts/

JSON API Yanıtları

Ranktracker yanıtları, tutarlı bir JSON:API tarzı zarf kullanır.

Kaynak, data altında döndürülürken, alanları ise attributes altında depolanır.

Örneğin:

{
  "data": {
    "id": "DOMAIN_UUID",
    "type": "domain",
    "attributes": {
      "host": "www.example.com",
      "projectName": "Example",
      "matchType": "any"
    }
  }
}

Geliştiriciler ayrıca önemli bir adlandırma kuralını da bilmelidir:

• API yanıtlarında camelCase kullanılır
• Yazma istek gövdeleri snake_case kullanır

Örneğin, bir yanıt şunları içerebilir:

projectName

yazma isteğinde ise şunlar kullanılır:

project_name

Bu kural API'nin tamamında geçerlidir.

Bkz.:

https://developers.ranktracker.com/guides/concepts/

Sayfalandırma

Uygulamaların büyük Ranktracker hesaplarıyla verimli bir şekilde çalışabilmesi için liste uç noktaları sayfalandırılmıştır.

Sayfalandırma, aşağıdakiler dahil olmak üzere kaynaklara uygulanır:

• Etki alanları
• Anahtar kelimeler
• Rakipler
• Etiketler

İki ana parametre şunlardır:

• sayfa
• sayfa_başı

per_page , sayfa başına en fazla 1.000 kaydı destekler.

Sayfalandırma bilgileri, aşağıdakiler dahil olmak üzere yanıt başlıkları aracılığıyla döndürülür:

• X-Toplam-Sayısı
• X-Toplam Sayfa Sayısı
• X-Sayfa Başına
• X-Geçerli Sayfa

Bu sayede, büyük ölçekli dışa aktarımlarda uygulamalar, veri kümesinin tamamı alınana kadar sayfa isteklerini sürdürebilir.

Sayfalandırma kılavuzunu okuyun:

https://developers.ranktracker.com/guides/pagination/

Hata İşleme ve Hız Sınırları

Ranktracker API'si, hataların programlı olarak daha kolay yönetilebilmesi için standart HTTP durum kodlarını kullanır.

Yaygın yanıtlar şunlardır:

Durum	Anlam	Örnek
400	Hatalı istek	Gerekli bir parametre eksik veya hatalı biçimlendirilmiş
402	Kota aşıldı	İstenen işlem, hesap kotasını aşacaktır
403	Yasak	İstek yetkilendirilmemiştir veya API erişimi mevcut değildir
404	Bulunamadı	Kaynak hesapta mevcut değil
422	Doğrulama hatası	İstek geçerli bir JSON'dur ancak geçersiz veriler içeriyor
429	Çok fazla istek	Entegrasyonun hız sınırı aşılmıştır

429 yanıtı verildiğinde, entegrasyonlar yeniden denemeden önce döndürülen Retry-After bilgisine uymalıdır.

Bu, üretim uygulamalarının geçici kısıtlamaları basitçe hata vermeden yönetebilmesini sağlar.

Hata ve hız sınırlamalarıyla ilgili eksiksiz belgeler burada mevcuttur:

https://developers.ranktracker.com/guides/errors-and-rate-limits/

Ranktracker REST API ve MCP

REST API, harici yazılımları Ranktracker'a bağlamanın tek yolu değildir.

Ranktracker ayrıca barındırılan bir MCP Sunucusu da sağlar.

MCP, Model Context Protocol (Model Bağlam Protokolü) anlamına gelir ve uyumlu AI uygulamaları ile ajanların Ranktracker verileriyle doğrudan çalışmasına olanak tanır.

Buna aşağıdakiler gibi uyumlu istemciler dahildir:

• ChatGPT
• Claude
• Cursor
• Diğer MCP uyumlu AI uygulamaları

REST ve MCP, aynı temel Ranktracker verileriyle etkileşime girer, ancak farklı iş akışları için tasarlanmıştır.

	Ranktracker REST API	Ranktracker MCP
En uygun olduğu alanlar	Uygulamalar, gösterge panelleri, veri depoları ve zamanlanmış işler	AI asistanları ve ajanları
Arayan	Arka uç veya HTTP istemciniz	ChatGPT, Claude, Cursor veya başka bir MCP istemcisi
Arayüz	REST uç noktaları	MCP araçları
REST yolu	/v1/...	/mcp
Tipik kullanım	SEO verilerini otomatik olarak taşıma ve yönetme	SEO verilerini diyalog şeklinde keşfetme

Örneğin, aşağıdakileri yapmak istiyorsanız REST daha iyi bir seçimdir:

• Her gece sıralamaları dışa aktar
• BI panosunu güncelle
• SEO projelerini otomatik olarak oluştur
• Uygulamanızdan anahtar kelimeler ekleyin
• Sıralama verilerini bir veritabanıyla senkronize etme

MCP ise aşağıdaki gibi sorular için daha uygundur:

Bu hafta takip ettiğim anahtar kelimelerden hangisi en çok düşüş gösterdi?

veya:

Hangi rakipler en fazla görünürlük kazandı?

Bir AI istemcisi, uygun Ranktracker aracını seçip ilgili verileri sorgulayabilir.

Birçok ileri düzey SEO ekibi her ikisini de kullanabilir.

REST, altyapı ve otomasyonu yönetir. MCP ise Ranktracker verilerini yapay zeka ajanlarının kullanımına sunar.

Daha fazla bilgi:

MCP'ye genel bakış: https://developers.ranktracker.com/mcp/

Bir MCP istemcisini bağlayın: https://developers.ranktracker.com/mcp/connect/

MCP araç kılavuzu: https://developers.ranktracker.com/mcp/tools/

Ranktracker API'si ile Neler Oluşturabilirsiniz?

Ranktracker API'si, bir anahtar kelimenin konumunu görüntülemekten çok daha fazlası için kullanılabilir.

İşte en kullanışlı uygulamalardan bazıları.

Otomatik SEO Raporlama

Bir ajans, sıralama bilgilerini kendi raporlama platformuna otomatik olarak aktarabilir.

Bunun yerine:

Ranktracker'ı aç
↓
CSV'yi dışa aktar
↓
Hesap tablosunu düzenle
↓
Raporu yükle
↓
Müşteriye gönder

şunu oluşturabilirsiniz:

Ranktracker API'si
↓
Raporlama platformu
↓
Otomatik olarak güncellenen müşteri raporu

Bu, çok sayıda müşteriyi yöneten ajanslar için özellikle değerlidir.

Özel SEO Panoları

Şirketiniz halihazırda bir iç raporlama veya iş zekası platformu kullanıyor olabilir.

API, Ranktracker verilerinin bu ortam içinde başka bir veri kaynağı haline gelmesini sağlar.

Aşağıdakileri gösteren gösterge panelleri oluşturabilirsiniz:

• Anahtar kelime sıralamaları
• Sıralama değişiklikleri
• En iyi 3 anahtar kelime
• En iyi 10 anahtar kelime
• En iyi 100 anahtar kelime
• Ses Payı
• Rakip görünürlüğü
• SERP özellikleri
• AI Genel Bakış görünümleri

Ortaya çıkan kontrol paneli, şirketinizin raporlama ihtiyaçlarına özel olarak uyarlanabilir.

Otomatik Müşteri Kaydı

SEO ajansları, Ranktracker'ı müşteri kabul süreçlerine entegre edebilir.

Örneğin:

Müşteri SEO paketi satın alır
↓
CRM müşteri kaydı oluşturur
↓
Ranktracker API'si alan adı oluşturur
↓
Anahtar kelimeler eklenir
↓
Rakipler eklenir
↓
İzleme başlar

Bu, tekrarlayan manuel proje kurulumunu ortadan kaldırır.

SEO Veri Depoları

Sıralamalar, diğer pazarlama ve iş verileriyle birleştirildiğinde daha değerli hale gelir.

Ranktracker bilgileri şunlarla birleştirilebilir:

• Google Arama Konsolu
• Analitik
• CRM verileri
• Dönüşüm verileri
• E-ticaret geliri
• Potansiyel müşteri verileri
• İçerik performansı

Bu, sadece bir sıralamayı kontrol etmekten çok daha önemli soruların yanıtlanmasına yardımcı olabilir.

Örneğin:

Hangi sıralama iyileştirmeleri en fazla gelir getirdi?

veya:

Hangi anahtar kelime grupları görünürlüğü artırıyor ancak dönüşüm sağlamıyor?

Sıralama Uyarıları

Geçmiş sıralama verileri, özel uyarı sistemlerini de destekleyebilir.

Bir entegrasyon, aşağıdaki durumları otomatik olarak algılayabilir:

• Bir anahtar kelime ilk 3'ten düşer
• Bir sayfa ilk 10'a giriyor
• Bir anahtar kelime ilk 100'e giriyor
• Önemli bir anahtar kelime ilk 100'den çıkıyor
• Bir rakip, web sitenizi geçiyor
• Arama görünürlüğü keskin bir şekilde düşer

Uyarılar daha sonra kendi e-postanıza, Slack'e, şirket içi kontrol panelinize veya izleme sisteminize gönderilebilir.

Rekabet İstihbaratı

Aşağıdakilerin birleştirilmesi:

• Sıralamalar
• Rakip takibi
• Sıralama geçmişi
• Ses Payı

otomatik bir rekabetçi SEO izleme sisteminin temelini oluşturur.

Rakipleri birkaç ayda bir değerlendirmek yerine, arama görünürlükleri sürekli izlenen bir metrik haline gelebilir.

Programatik SEO İzleme

Programatik SEO, binlerce veya yüz binlerce açılış sayfası üretebilir.

Bu projeleri manuel olarak izlemek gerçekçi değildir.

Ranktracker API'si, geliştiricilerin büyük anahtar kelime veri kümelerini işleyebilen ve elde edilen bilgileri otomatik olarak dahili analiz sistemlerine aktarabilen sıralama iş akışları oluşturmasına olanak tanır.

AI Destekli SEO Analizi

Ranktracker’ın REST API’si ve MCP Sunucusu, yapay zeka destekli SEO iş akışlarının bir parçası da olabilir.

Örneğin, yapay zeka sistemleri şu konularda yardımcı olabilir:

• Sıralama düşüşlerini belirleyin
• Sıralama değişikliklerini özetleme
• Hızla gelişen anahtar kelimeleri bulma
• Rakip görünürlüğünü karşılaştırın
• SERP değişikliklerini analiz edin
• SEO fırsatlarını önceliklendirin
• Dahili raporlar oluşturun
• Olağandışı sıralama hareketlerini araştırın

API yapılandırılmış verileri sağlarken, yapay zeka bu verilerin yorumlanmasına yardımcı olabilir.

Ranktracker API Kimler İçin Uygun?

Ranktracker API'si özellikle aşağıdakiler için kullanışlıdır:

• SEO ajansları
• Kurumsal SEO ekipleri
• SaaS şirketleri
• SEO yazılım şirketleri
• Geliştiriciler
• Veri mühendisleri
• BI ekipleri
• E-ticaret işletmeleri
• Ortaklık pazarlamacıları
• Yayıncılar
• Birden fazla lokasyonda faaliyet gösteren işletmeler
• Programatik SEO ekipleri
• AI otomasyon ekipleri

Sıralama verilerinin otomatik olarak alınması, taşınması, analiz edilmesi veya yönetilmesi gerekiyorsa, API genellikle manuel dışa aktarmalardan çok daha ölçeklenebilir bir çözümdür.

Neden Kendi Sıralama İzleme Altyapınızı Oluşturmak Yerine Ranktracker'ı Kullanmalısınız?

Büyük ölçekte arama sıralamalarını toplamak, bir Google araması yapmaktan çok daha fazlasını gerektirir.

Üretim amaçlı bir sıralama izleme sistemi şunları hesaba katmalıdır:

• Konumlar
• Diller
• Cihazlar
• En iyi 100 sonuç koleksiyonu
• SERP özellikleri
• AI Genel Bakışları
• Anahtar kelime yapılandırması
• Geçmiş sıralama verileri
• Rakipler
• Zamanlama
• Arama sonuçlarındaki değişiklikler
• Veri depolama
• Raporlama

Tüm bu altyapıyı şirket içinde kurmak ve sürdürmek, önemli miktarda geliştirme kaynağı gerektirebilir.

Ranktracker, sıralama izleme altyapısını yönetir ve elde edilen verileri yapılandırılmış bir API aracılığıyla sunar.

Böylece geliştiricileriniz, işletmenizin gerçekten ihtiyaç duyduğu uygulamayı, kontrol panelini, iş akışını veya analizi oluşturmaya odaklanabilir.

Ranktracker API'sını Kullanmaya Nasıl Başlayabilirsiniz?

Başlamak için sadece birkaç adım yeterlidir.

1. API Ayarlarınızı Açın

Doğrudan şu adrese gidin:

https://app.ranktracker.com/account/api

Bir API anahtarı oluşturun ve güvenli bir şekilde saklayın.

2. Hızlı Başlangıç Kılavuzunu Okuyun

Resmi hızlı başlangıç kılavuzunu izleyin:

https://developers.ranktracker.com/guides/quickstart/

3. İlk İsteğinizi Yapın

Örneğin:

curl https://api.ranktracker.com/v1/domains 
  -H "Authorization: tkn_usr_your_api_key_here"

4. API Referansını İnceleyin

REST API referansının tamamına buradan ulaşabilirsiniz:

https://developers.ranktracker.com/rest-api/

5. Oluşturmaya başlayın

Buradan Ranktracker'ı aşağıdakilere bağlamaya başlayabilirsiniz:

• Uygulamanız
• Raporlama yığınınız
• Veri ambarınız
• CRM'niz
• Şirket içi araçlarınız
• AI iş akışlarınız

Ranktracker API Belgeleri

Geliştirici belgelerinin tamamına şu adresten ulaşabilirsiniz:

Geliştirici belgeleri: https://developers.ranktracker.com/

API anahtarlarını oluşturma ve yönetme: https://app.ranktracker.com/account/api

Hızlı Başlangıç: https://developers.ranktracker.com/guides/quickstart/

Kimlik Doğrulama: https://developers.ranktracker.com/guides/authentication/

Temel kavramlar: https://developers.ranktracker.com/guides/concepts/

Sayfa numaralandırma: https://developers.ranktracker.com/guides/pagination/

Hatalar ve hız sınırları: https://developers.ranktracker.com/guides/errors-and-rate-limits/

Kullanım ve kota: https://developers.ranktracker.com/guides/usage-and-quota/

Toplu işlemler: https://developers.ranktracker.com/guides/bulk-operations/

Bir etki alanını izleme kılavuzu: https://developers.ranktracker.com/guides/tutorials/track-a-domain/

Sıralamaları depoya aktarma kılavuzu: https://developers.ranktracker.com/guides/tutorials/pull-rankings-to-a-warehouse/

Ses Payı eğitimi: https://developers.ranktracker.com/guides/tutorials/share-of-voice-report/

Toplu etiketleme eğitimi: https://developers.ranktracker.com/guides/tutorials/bulk-tag-keywords/

REST API referansı: https://developers.ranktracker.com/rest-api/

MCP Sunucusu: https://developers.ranktracker.com/mcp/

MCP istemcisini bağlama: https://developers.ranktracker.com/mcp/connect/

MCP aracı referansı: https://developers.ranktracker.com/mcp/tools/

Ranktracker API ile Çalışmaya Başlayın

Ranktracker API, Ranktracker'ı bir SEO kontrol panelinden, teknoloji yığınınızın içine doğrudan yerleştirilebilen bir altyapıya dönüştürür.

Bunu, alan adlarını ve anahtar kelimeleri yönetmek, rakipleri takip etmek, ilk 100 sıralamayı almak, SERP'leri analiz etmek, AI Genel Bakışlarını tespit etmek, Ses Payını izlemek, geçmiş sıralama verilerine erişmek, anahtar kelimeleri düzenlemek, raporlama boru hatları oluşturmak ve SEO bilgilerini işletmenizin geri kalanıyla entegre etmek için kullanabilirsiniz.

Geliştiriciler için, sıralama verilerini manuel olarak dışa aktarma ve taşıma ihtiyacını ortadan kaldırır.

Ajanslar için ise büyük ölçekli müşteri otomasyonunu mümkün kılar.

Kurumsal SEO ekipleri için ise sıralama bilgilerinin iç analitik ve veri altyapısının bir parçası haline gelmesini sağlar.

Ayrıca Ranktracker’ın MCP Sunucusu sayesinde, aynı temel SEO verileri yapay zeka asistanları ve ajanları için de erişilebilir hale getirilebilir.

Ranktracker API anahtarınızı oluşturun: https://app.ranktracker.com/account/api

Belgeleri okuyun: https://developers.ranktracker.com/

REST API referansını görüntüleyin: https://developers.ranktracker.com/rest-api/