SEO API

Screpy projelerinizden gelen yapılandırılmış JSON ile özel SEO raporları ve otomasyonlar oluşturun. Proje kapsamlı REST API üzerinden tarama bulgularını, anahtar kelime sıralamalarını, backlink, kayıtlı AI Visibility ve izleme sonuçlarını alın; desteklenen işlemlerle iş akışınızı yönetin.

API başlangıç rehberini okuyun Screpy hesabı oluştur

Erişilebilir projeleri listeleyin

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Örnek yanıtın bir bölümü. REST erişimi ücretli üyelik gerektirir; anahtar yalnızca sahibi olduğunuz veya sizinle paylaşılmış, erişebildiğiniz projeleri döndürür.

SEO API Kimlik Doğrulaması

Ayarlar → Bağlı Uygulamalar bölümünde REST anahtarı oluşturun ve sunucunuzdan bearer token olarak gönderin. Entegrasyonunuzun ihtiyaç duyduğu izinleri seçin.

Salt okunur anahtarlar veri alır; okuma ve yazma anahtarları desteklenen değişiklikleri de sağlar.
Anahtar oluşturulurken kopyalayın: yalnızca bir kez gösterilir. Herkese açık tarayıcı koduna eklemeyin.
Anahtarları Bağlı Uygulamalar'dan iptal edin. En fazla 20 etkin anahtar kullanılabilir; bir yıl sonra süreleri dolar.

Kimlik doğrulama rehberini okuyun

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

API Erişimini Kontrol Edin

REST erişimi ücretli üyelik gerektirir. Proje üyeliği ve projenin özellikleri kullanma hakkı da hangi kayıtlara ve işlemlere erişebileceğinizi belirler.

Hesap uç noktaları planınızı, özelliklerinizi ve erişilebilir proje sayısını gösterir.
Kullanım raporları özellik sınırlarını içerir; kullanılan ve kalan miktarlar şu anda yalnızca sahibi olduğunuz projeler için hesaplanır.
Null kullanım değerleri sıfır tüketim değil, mevcut olmayan değerlerdir.

Hesap uç noktalarını inceleyin

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

SEO Projelerini Yönetin

Sahibi olduğunuz ve paylaşılan projeleri listeleyin, proje özetini alın veya sahip olunan proje hakkınız dahilinde proje oluşturun. Sonraki isteklerde döndürülen proje UID'lerini kullanın.

Adları, hedef pazar ve saat dilimi tercihlerini, desteklenen tarama veya izleme ayarlarını güncelleyin.
Alan adı değişikliği yeni proje gerektirir; ayar güncellemek tamamlanmış sonuçları değiştirmez.
Proje oluşturulurken kapasite ve site doğrulaması kontrol edilir.
Projeyi yalnızca sahibi silebilir.

Proje uç noktalarını inceleyin

example.comProje

example.orgProje

example.netProje

Web Sitesi Taraması Başlatın

Yazma erişimiyle tarama başlatın ve döndürülen tarama UID'sini saklayın. Tarama arka planda çalışır; sonuçları almadan önce durumunu takip edin.

Devam eden bir tarama veya devre dışı tarayıcı yeni taramanın başlamasını engelleyebilir.
Tarama özetleri ve veri kümeleri başarıyla tamamlanmış tarama gerektirir; bitmemiş sonuçlar çakışma yanıtı döndürür.
Anlık kayıtları raporlarken veya karşılaştırırken proje ve tarama referanslarını birlikte tutun.

Tarama uç noktalarını inceleyin

1
İnceleme/guides
Açık
2
Oluşturuldu/shop
Açık
Tamamlandıexample.com
Bekliyor

SEO Tarama Verilerini Alın

Seçilen tamamlanmış taramadan teknik SEO raporları oluşturun. Sayfa ayrıntılarını alın, bağlantı ve görselleri bulundukları kaynak sayfalara kadar takip edin.

Sayfalar HTTP durumu, başlık, açıklama, başlık etiketleri, canonical, tarama derinliği ve süre bilgilerini içerir.
Bağlantı kayıtları hedefleri, bağlantı metinlerini, nofollow durumunu ve kaynak sayfa bağlamını gösterir.
Görsel kayıtları alt metin, boyut, erişim durumu ve kaynak sayfaları içerir.
Desteklenen alan filtrelerini ve sayfalanmış kayıtları kullanın; tam HTML dışa aktarımı veya SQL arayüzü sunulmaz.

Tarama verisi uç noktalarını inceleyin

/guides/seo200

Dizine eklendi

Projeleri ve Taramaları Karşılaştırın

Projeler arasında veya tamamlanmış tarama kayıtları üzerinden teknik SEO özetlerini karşılaştırın. Yeniden üretilebilir karşılaştırmalar için belirli tarama referanslarını saklayın.

Proje karşılaştırmaları iki ila beş erişilebilir proje kabul eder; son tamamlanmış taramalar veya seçilen kayıtlar kullanılır.
İki tarama karşılaştırması sağlık, sayfa ve sorun sayılarındaki değişimi ikinci eksi birinci olarak döndürür.
Bunlar özet karşılaştırmalarıdır; tek tek URL'leri araştırmak için tarama kayıtlarını ayrıca alın.

Karşılaştırma uç noktalarını inceleyin

Önce62→Sonra87

SEO Quick Wins Verilerini Alın

Öncelikli fırsatları kaynak ve raporlama dönemiyle iş akışınıza taşıyın. Tamamlanmış tarama referansı erişimi doğrular; her fırsatı o taramanın anlık kaydı haline getirmez.

Bağlı veriler mevcutsa Search Console fırsatları üst sıralara yakın sorguları, CTR, anahtar kelime çakışmasını, düşüşleri ve görünürlük değişimlerini kapsar.
İç bağlantı bulguları yanıtın meta verisinde belirtilen en son proje taramasına dayanabilir.
Trafikten türetilen bulgular ilgili bağlantı, izinler ve yeterli veri gerektirir.
Rapor türlerini, tarih aralığını, uyarıları ve veri durumunu koruyun; boş rapor sitenin sorunsuz olduğunu kanıtlamaz.

Quick Wins'i inceleyin

linen shirt#11

Gösterimler

2.860

Sıralama Takibini Yönetin

Kayıtlı anahtar kelime görünürlüğünü, analiz geçmişini ve sıralama sonuçlarını hedef pazar ve cihaz bağlamında okuyun. Rastgele canlı arama sonuçları istemek yerine takip edilen kümeyi yönetin.

Anahtar kelimeleri arama, cihaz ve URL tabanlı segmentle filtreleyin; eşleşmeyen kelimeler de incelenebilir.
İstek başına en fazla 100 anahtar kelime ekleyin; ilk analiz hemen dönmez, kuyruğa alınır.
Yazma erişimiyle takip edilen kelimeleri silin, segmentleri önizleyin, oluşturun, güncelleyin veya kaldırın.
REST üzerinden canlı SERP sorgusu, elle yeniden analiz veya Rank Tracker CSV/XLSX dışa aktarımı sunulmaz.

Rank Tracker uç noktalarını inceleyin

Sıralamalar

+24 Sıralama

AI Visibility Verilerine Erişin

Kayıtlı AI yanıtlarını marka anılmaları, atıflar ve kaynak bulgularıyla ilişkilendirin. Kendi raporlarınızda istem, ülke, dil ve platform bağlamını koruyun.

Özetleri, anılmaları, yanıtları, atıfları, takip edilen istemleri ve kaynak alan adı veya URL etkinliğini okuyun.
Proje kapasitesi dahilinde istek başına en fazla 20 istem ekleyin veya yazma erişimiyle takip edilen istemleri kaldırın.
İstem önerileri, elle yeniden analiz ve AI Visibility dışa aktarımları REST işlemleri değildir.

AI Visibility'yi inceleyin

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Backlink Analizi Yapın

Projenin backlink profilini veya seçenekler arasından seçilen, önceden eklenmiş rakibi inceleyin. Kendi otorite raporlarınız için bağlantıları yönlendiren alan adlarıyla ilişkilendirin.

Özet metrikleri, yönlendiren alan adlarını ve seçilen alan adının backlink kayıtlarını alın.
Backlink fırsatlarını ve desteklenen kayıp ya da bozuk alan adı veri kümelerini inceleyin.
Hedef, filtre, sıralama ve imleç bağlamını koruyun; herhangi bir alan adı için sınırsız sorgu sunulmaz.
CSV/XLSX tablo dışa aktarımları mevcut sayfayı kapsar. Devam etmek için X-Next-Cursor kullanın.

Backlink Checker'ı inceleyin

example.org
example.net
example.edu

example.com84 Bağlantılar

Disavow Kayıtlarını Yönetin

İncelenmiş alan adı veya URL kayıtlarını notlarıyla projede saklayın, ardından Google biçimine uygun metin dosyası hazırlayın. Disavow kararlarını siz verirsiniz.

Yazma erişimiyle istek başına en fazla 100 kayıt eklenebilir veya mevcut kayıtlar silinebilir.
Projenin disavow metnini sayfalanmış tablo dışa aktarımlarından ayrı olarak alın.
Dosyayı inceleyip elle gönderin; kayıt saklamak Google'a gönderim yapmaz veya backlink kaldırmaz.

Disavow Management'ı inceleyin

disavow.txtİnceleme

domain:example.org
https://example.net/links

Alan adıexample.org
URLexample.net/links

Web Sitesi Sağlık Verilerini Alın

Raporlarınızda sayfa performansını site erişilebilirliğinden ayırın. Bu uç noktalar mevcut kontrolleri döndürür, istek üzerine yeni ölçüm yapmaz.

Performans, son kontrol edilen ana sayfanın FCP, LCP, CLS, TTFB, TBT ve Speed Index değerlerini döndürür; tüm sayfaları veya eksiksiz geçmişi kapsamaz.
Uptime son 30 günü özetler; durum, yanıt süresi ve tarih içeren en yeni 160 kontrolü döndürür.
Performans yoksa data:null döner; uptime kontrolü yoksa özet değerleri null, kontrol listesi boş kalır.

Sağlık uç noktalarını inceleyin

example.comLaboratuvar

LCP2,1 s
TBT180 ms
CLS0,04

SEO Verilerini Sayfalayın

Büyük veri kümelerini yönetilebilir sayfalar halinde alın ve istek bağlamını veri akışınız boyunca koruyun. Yanıtı panel metriğine çevirmeden önce verinin mevcut olduğunu doğrulayın.

Desteklenen listeler varsayılan olarak 50, en fazla 100 kayıt döndürür; dönen sonraki sayfa bağlantılarını veya opak imleçleri takip edin.
Sayfalar arasında filtreleri, hedefleri ve raporlama dönemlerini sabit tutun. Geçersiz parametreler reddedilir.
Eksik sonuçları sıfırla değiştirmek yerine yetkilendirme, bitmemiş tarama, mevcut olmayan veri ve istek sınırı hatalarını açıkça işleyin.

API hata rehberini okuyun

JSONcursor_2

SEO API hakkında konuşun. SEO MCP ile.

AI asistanınızı SEO MCP ile Screpy projenize bağlayın. Bir proje seçin, özetini inceleyin ve yetkilendirilmiş erişimle desteklenen tarama, sıralama ve arama verilerini araştırın.

Screpy SEO MCP’yi keşfedin AI asistanınızı bağlayın

SEO API Sık Sorulan Sorular

REST erişimini seçmek, kayıtları işlemek ve güvenilir entegrasyon kurmak için pratik yanıtlar.

API istek sınırları nelerdir?

Dakikada temel sınır anahtar başına 300, hesap başına 900 istektir. Ağır uç noktalar ek olarak anahtar başına 60, hesap başına 180; yazma uç noktaları 30 ve 90 isteğe izin verir. Kontroller birlikte uygulanır. HTTP 429 yanıtını işleyin ve belirtilen bekleme süresinden sonra yeniden deneyin.

REST API paneldeki her özelliği sunar mı?

Hayır. Desteklenen REST işlemleri API referansında listelenir. Map Tracker sonuçları, makale üretimi, PDF raporları veya tüm ham analiz verileri için REST uç noktası yoktur. Rank Tracker ve AI Visibility için de yukarıda açıklanan işlem ve dışa aktarım sınırları vardır.

Proje UID'sini ve tarama UID'sini nasıl bulurum?

GET /projects isteğiyle erişilebilir projeyi seçin, ardından tarama listesini alın. Dönen proje ve tarama UID'lerini birlikte kullanın. Özet ve tarama verisi uç noktaları başarıyla tamamlanmış tarama gerektirir.

Eksik veri sitenin SEO sorunu olmadığını mı gösterir?

Hayır. Null değerler, boş kayıtlar, uyarılar ve veri erişim hataları farklı anlamlara gelir. Performans kontrolünün olmaması site arızası, kullanım değerinin olmaması sıfır tüketim değildir. Sonuç çıkarmadan önce yanıtı ve özellik kurulumunu kontrol edin.

Her API sonucu güncel veya canlı mı?

Hayır. Tarama kayıtları seçilen anlık kayda aittir; sıralamalar ve AI Visibility kayıtlı analizleri kullanır. Quick Wins rapor kaynağına ve tarih aralığına bağlıdır. Sağlık uç noktaları mevcut kontrolleri döndürür. Raporlarda mevcut tarihleri ve kaynak bağlamını koruyun.

SEO API ile SEO MCP arasındaki fark nedir?

SEO API, kendi yazılımınız için REST istekleri ve REST bearer anahtarıyla kullanılır. SEO MCP, desteklenen araçları Model Context Protocol ve kendi yetkilendirmesi üzerinden uyumlu AI asistanlarına sunar. MCP kimlik bilgileri REST erişimini doğrulamaz; mevcut işlemler de aynı değildir.

Salt okunur anahtar her POST isteğinde çalışır mı?

Hayır. POST proje ve tarama karşılaştırmaları mevcut kayıtları analiz ettiği için okuma erişimi kabul eder. Kayıt oluşturma veya değiştirme, tarama başlatma ve segment önizleme okuma ve yazma erişimi gerektirir. İzinleri HTTP yönteminden çıkarmak yerine belgelenmiş kapsamı kontrol edin.

API verilerini CSV veya Excel olarak aktarabilir miyim?

Backlink tablo uç noktaları mevcut sayfa için CSV/XLSX destekler; devamı X-Next-Cursor ile alınır. Disavow metni ayrıca dışa aktarılır. Rank Tracker ve AI Visibility CSV/XLSX aktarımları yalnızca panelde bulunur; diğer yapılandırılmış API yanıtlarını kendi raporlama kodunuzda kullanabilirsiniz.