On-Page API

Lighthouse ve On-Page SEO API

Herhangi bir sayfanın performans, erişilebilirlik, en iyi uygulamalar ve SEO skorlarını, Core Web Vitals değerlerini ve başarısız denetimlerini tek istekte alın. Aynı endpoint sayfanın SEO denetimini yapar ve ana içeriğini bölümler ya da Markdown olarak çıkarır.

Tek Endpoint, Üç Rapor Lighthouse Skorları ve Core Web Vitals Türkçe Denetim Başlıkları Sayfa Başına Sabit Ücret Engellenen Sayfada Ücret Yok
Python API Example
import requests

response = requests.post(
    "https://data.semust.com/v1/on-page",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "type": "lighthouse",
        "url": "https://www.example.com/",
        "device": "mobile",
        "language": "tr",
    },
    timeout=90,  # longer than ?wait= (60 seconds by default)
)

data = response.json()
if response.status_code == 202:
    # Still running: collect it later from data["poll_url"]
    print(f"Task {data['task_id']} is still running")
elif response.status_code == 200:
    page = data["data"]
    print("Scores:", page["scores"])
    print("LCP:", page["metrics"]["largest_contentful_paint_ms"], "ms")
    for audit in page["failed_audits"][:5]:
        print(audit["category"], "-", audit["title"])
else:
    # e.g. PAGE_BLOCKED: the site refused the audit (not charged)
    print(data["code"], data["error"])
Cookshop
ideasoft
Yapı Kredi
beko logo
vialand
defacto
koton
venividi logo
Cookshop
ideasoft
Yapı Kredi
beko logo
vialand
defacto
koton
venividi logo

12.000+ markanın güvendiği Semust ile şimdi tanışın.

Tek Endpoint

lighthouse, audit ve content raporları `type` parametresiyle seçilir. Tek istek şekli, tek kimlik doğrulama, tek hata formatı.

Ham Rapor Değil, Sonuç

Yüzlerce kilobaytlık ham Lighthouse raporu yerine 0–100 skorlar, milisaniye cinsinden metrikler ve tasarruf miktarıyla sıralanmış başarısız denetimler gelir.

Sabit Ücret

Lighthouse için sayfa başına 0,0055 USD, SEO denetimi için 0,000165 USD (JavaScript ile 0,00165 USD), içerik çıkarma için 0,000165 USD.

On-Page API ile Neler Yapabilirsiniz?

data.semust.com/v1/on-page endpoint'i ile sayfa performansını, teknik SEO durumunu ve içeriği ölçün.

lighthouse; performans, erişilebilirlik, en iyi uygulamalar ve SEO skorlarını, Core Web Vitals değerlerini ve başarısız denetimleri döndürür. audit; sayfa skorunu, meta etiketleri, başlıkları, içerik ölçülerini, linkleri, boyutu, yükleme süresini ve bulunan sorunları verir. content ise sayfanın ana içeriğini başlık–metin bölümleri hâlinde ya da istenirse Markdown olarak çıkarır. Üçü de aynı istek şekli ve kimlik doğrulamayla çalışır.

// One endpoint, three reports
POST /v1/on-page

{ "type": "lighthouse", "url": "https://www.example.com/", "device": "mobile" }
{ "type": "audit", "url": "https://www.example.com/", "javascript": true }
{ "type": "content", "url": "https://www.example.com/blog/", "markdown": true }

// Languages the audit titles can be returned in (free)
GET /v1/on-page/languages

Tek bir platform,Organik başarı hikayeleri:

Batuhan Durmaz

Batuhan Durmaz

SEO Uzmanı

SEMUST SEO çalışmalarımız için oldukça değerli verileri çok basit ve anlaşılır bir şekilde bize sunmakta olan harika bir araç. Rakip araçlara baktığımızda çok uygun fiyatlara, çok iyi veriler elde etmek mümkün. Ben SEMUST'ı hem yerli hem de global projelerde anahtar kelime analizleri, Google search console verisi, Sıralama takibi ve içerik üretimi için kullanıyorum. Oldukça da memnunum.

Selen Çetin

Selen Çetin

SEO Uzmanı

Semust'la ilk olarak LinkedIn'de karşılaşmıştım, o zamanlar yeni yeni duyuluyordu. Merak edip denemiştim, şimdi severek kullandığım araçlardan biri haline geldi. Özellikle manuel olarak yapmam gereken birçok işi tek tıkla halletmesi, işimi ciddi anlamda kolaylaştırıyor. İlk kullandığım zamandan bu yana ne kadar hızlı geliştiğini görmek de ayrıca güven veriyor.

Aykut Özcan

Aykut Özcan

SEO Director - Digital UP

Digital UP SEO Ajansı olarak, SEO süreçlerimizde Semust'un sunduğu analiz ve raporlama araçlarından büyük ölçüde faydalanıyoruz. Anahtar kelime takibinden rekabet analizine, site sağlığı taramalarından backlink denetimine kadar birçok kritik alanda bize hız ve derinlik kazandırıyor. Özellikle veri odaklı stratejiler geliştirmemizde sağladığı kapsamlı içgörüler sayesinde, müşterilerimizin arama motorlarındaki performansını istikrarlı biçimde artırıyoruz. Semust, ajansımızın büyüme yolculuğunda güçlü bir destekçidir.

On-Page API Sıkça Sorulan Sorular

On-Page API Nedir ve Nasıl Çalışır?

On-Page API, bir sayfanın hızını, erişilebilirliğini, teknik SEO durumunu ve içeriğini programatik olarak ölçmenizi sağlayan bir arayüzdür. Bir tarayıcı eklentisini açıp sayfaları tek tek denetlemek yerine, kendi uygulamanızdan tek bir HTTP isteğiyle sonucu yapılandırılmış JSON olarak alırsınız; saklayabilir, raporlarınıza aktarabilir ya da bir dağıtımdan sonra otomatik olarak çalıştırabilirsiniz.

Semust On-Page API tek bir endpoint üzerinden çalışır: data.semust.com/v1/on-page adresine gönderdiğiniz POST isteğinde type parametresiyle üç rapordan birini seçersiniz — lighthouse, audit veya content. Kimlik doğrulama header tabanlıdır ve her yanıt JSON'dur.

Lighthouse Skorları Neden Önemli?

Lighthouse; bir sayfanın performansını, erişilebilirliğini, en iyi uygulamalara uyumunu ve temel SEO gereksinimlerini aynı ölçekte puanlar. Bu skorlar, bir sayfanın kullanıcıya ne kadar hızlı ve sorunsuz açıldığını gösterir; yavaş ve kayan sayfalar hem ziyaretçi kaybettirir hem de arama performansını olumsuz etkileyebilir.

Skorları API üzerinden düzenli olarak ölçtüğünüzde bir değişikliğin performansı ne zaman bozduğunu hemen görürsünüz. Başarısız denetimler tahmini tasarruflarıyla geldiği için ekibiniz önce en çok kazandıracak işe odaklanabilir.

Core Web Vitals Metrikleri

Core Web Vitals, sayfa deneyimini ölçen temel metriklerdir. Largest Contentful Paint en büyük içeriğin ne zaman göründüğünü, Cumulative Layout Shift sayfanın yüklenirken ne kadar kaydığını, Total Blocking Time ise ana iş parçacığının ne kadar süre kilitlendiğini gösterir.

lighthouse raporu bu değerleri First Contentful Paint, Speed Index ve Time to Interactive ile birlikte ayrı alanlarda verir; süreler milisaniye cinsindendir. Değerleri doğrudan kendi panolarınıza ve uyarılarınıza bağlayabilirsiniz.

On-Page API Fiyatlandırması

Fiyatlandırma sayfa başına sabittir: lighthouse 0,0055 USD, audit 0,000165 USD, JavaScript ile oluşturulan sayfalar için audit 0,00165 USD ve content 0,000165 USD. Ücret seçtiğiniz cihaza, kategorilere ya da dile göre değişmez.

Aynı istek 15 dakika boyunca önbellekten yanıtlanır ve canlı yanıtla aynı ücreti öder; bu süre, bir düzeltmeden sonra yeniden ölçüm yapmanızı engellemeyecek kadar kısadır. Engellenen ya da yüklenemeyen sayfalar ve diğer tüm hatalar ücretlendirilmez.

Tek Sayfa Teknik SEO Denetimi

audit raporu, bir sayfanın arama motorlarına nasıl göründüğünü tek istekte özetler: HTTP durumu, title ve description uzunlukları, canonical adresi, H1 ve diğer başlıkların sayısı, kelime sayısı ve okunabilirlik, iç ve dış link sayıları, görseller, scriptler, stil dosyaları, sayfa boyutu ve yükleme süresi.

Tespit edilen sorunlar ayrı bir listede gelir; böylece bir sayfada neyin düzeltilmesi gerektiğini doğrudan görürsünüz. Yeni yayınlanan sayfaları ya da bir şablon değişikliğinden etkilenen sayfaları hızlıca kontrol etmek için idealdir.

İçerik Çıkarma ve Markdown

content raporu sayfanın ana içeriğini menü, alt bilgi ve kenar çubuğu gibi tekrar eden alanlardan ayırır. İçerik, başlık seviyesi, başlık ve metinden oluşan bölümler hâlinde gelir; varsa sayfadaki e-posta ve telefon bilgileri de ayrıca verilir.

markdown: true ile aynı içeriği Markdown olarak da alırsınız. Bu, rakip içerik analizi, içerik boşluğu çalışmaları, özetleme ve büyük dil modelleriyle çalışan iş akışları için temiz bir girdi sağlar.

Engellenen Sayfalar ve Dürüst Sonuçlar

Bot korumaları otomatik denetimleri engellediğinde birçok araç, gerçek sayfa yerine engel sayfasını ölçer ve yanıltıcı skorlar üretir. On-Page API bunu yapmaz: site isteği reddettiğinde PAGE_BLOCKED, sayfa yüklenemediğinde PAGE_UNAVAILABLE hatası döner ve ücret alınmaz.

Hatalar sabit bir kod, okunabilir bir mesaj ve bir ipucu içerir; Accept-Language: tr göndererek mesajları Türkçe alabilirsiniz. Böylece otomasyonunuz hatalı bir ölçümü gerçek bir sonuç sanmaz.

On-Page API Entegrasyonu

Entegrasyon için tek ihtiyacınız, hesap panelinizdeki API Erişimi sayfasından oluşturacağınız ve SEMUST-API-USER ile SEMUST-API-PASSWORD header'larında göndereceğiniz API kullanıcı adı ve şifresidir. İstekler standart HTTP POST'tur, yanıtlar JSON'dur. Yanlış yazılmış bir parametre hatada adıyla ve bir öneriyle bildirilir.

İstekler task olarak çalışır. 60 saniyeden uzun süren bir istek task_id içeren bir 202 döndürür ve sonucu GET /v1/tasks/{task_id} ile alırsınız. Sonuçlar task bittikten sonra 72 saat saklanır. Zaman aşımından sonra güvenle tekrar denemek için Idempotency-Key gönderin: aynı anahtar aynı task'ı döndürür ve bir kez ücretlendirilir.

Daha fazla organik trafik 

  • 14 gün ücretsiz deneme
  • Kurulum gerekmez
  • Search Console entegrasyonu