REST API · v1 · Canlı dokümantasyon

SEO API kendi altyapınız için

SEO ve AI görünürlük verileriniz, temiz bir REST uç noktası üzerinden.

Google Search Console, sıralama ve AI Tracker verilerini doğrudan ürününüze, panelinize veya veri ambarınıza çekin. Panelinizden bir Bearer anahtarı ile kimlik doğrulayın, REST `/v1`'i çağırın ve tipli JSON alın — SEOcrawl AI MCP'yi çalıştıran aynı kanonik veri katmanı. GA4, tam site denetimi dışa aktarımı ve çok kiracılı iş ortağı OAuth'u sırada.

API anahtarınızı alın MCP'yi keşfedin

Bearer kimlik doğrulama · 60 istek/dk · MCP ile aynı veri katmanı · Scraping yok

seocrawl — REST /v1

$ curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \

-H "Authorization: Bearer sca_live_…"

{ "data": {

"period": { "from": "2026-06-09", "to": "2026-07-06" },

"metrics": {

"clicks": 2388, "impressions": 811019,

"ctr": 0.00294, "position": 22.87

"metrics_diff": { "clicks": 584, … }

} }

Bir kez kimlik doğrulayın. REST'i çağırın.

Panelinizden bir Bearer token oluşturun ve onu Authorization başlığında iletin. Aynı anahtar hem REST API'de hem de MCP sunucusunda çalışır.

Temel URL

https://api.seocrawl.ai/v1

Authorization başlığı

Authorization: Bearer sca_live_your_token_here

API anahtarınızı alın Read the API docs

cURLJavaScriptPython

# cURL — resolve a property id, then query it
curl https://api.seocrawl.ai/v1/properties \
  -H "Authorization: Bearer sca_live_…"

curl "https://api.seocrawl.ai/v1/properties/$ID/gsc/summary?range=last_28_days" \
  -H "Authorization: Bearer sca_live_…"

// JavaScript
const res = await fetch(
  "https://api.seocrawl.ai/v1/properties/" + id + "/gsc/summary?range=last_28_days",
  { headers: { Authorization: "Bearer sca_live_…" } }
);
const data = await res.json();

# Python
import requests
r = requests.get(
  f"https://api.seocrawl.ai/v1/properties/{id}/gsc/summary",
  params={"range": "last_28_days"},
  headers={"Authorization": "Bearer sca_live_…"},
)
print(r.json())

Uç noktalar

Tek veri katmanı, iki yüzey

Her REST uç noktası, MCP araçlarıyla aynı kanonik katmandan okur — böylece paneliniz ve AI ajanlarınız her zaman aynı sayıları görür. Bu gruplar v1'de canlı; kapsam sürekli genişliyor.

Mülkler

Erişebildiğiniz Search Console mülklerini listeleyin. Her veri uç noktasının yolunda ilgili mülkün `id`'sini kullanın.

GET/v1/propertiesCanlı

Google Search Console

Tıklama, gösterim, TO ve ortalama konum — sorguya, sayfaya, tarih aralığına ve dönemler arası kıyasa göre.

GET/v1/properties/{id}/gsc/summaryCanlı
GET/v1/properties/{id}/gsc/compareCanlı
GET/v1/properties/{id}/gsc/top-keywordsCanlı
GET/v1/properties/{id}/gsc/top-pagesCanlı
GET/v1/properties/{id}/gsc/keywords/detailCanlı
GET/v1/properties/{id}/gsc/pages/detailCanlı

AI Tracker

ChatGPT, Claude, Gemini ve Perplexity genelinde marka anılmaları için izlediğiniz prompt'ları okuyun.

GET/v1/properties/{id}/ai-tracker/promptsCanlı

Görevler

SEO görevlerini okuyup yazın — görev panonuzu kendi proje yönetimi altyapınıza bağlayın.

GET/v1/properties/{id}/tasksCanlı
POST/v1/properties/{id}/tasksCanlı
GET/v1/properties/{id}/tasks/{ticketId}Canlı
PATCH/v1/properties/{id}/tasks/{ticketId}Canlı
POST/v1/properties/{id}/tasks/{ticketId}/commentsCanlı

GA4 ve İndeksleme

Trafik, AI yönlendirmeleri ve indeksleme durumu. Bağlantı noktası hazır; REST uç noktaları yayına alınıyor.

GET/v1/properties/{id}/ga4/summaryYakında
GET/v1/properties/{id}/indexation/summaryYakında

Site Denetimi

Tarama sağlığı, sayfa içi, teknik ve sorun listeleri — tam denetim veri seti, REST üzerinden sunulur.

GET/v1/properties/{id}/audit/summaryYakında
GET/v1/properties/{id}/audit/issuesYakında

Neden bu API

Scraper'lar için değil, ürünler için tasarlandı

Bearer kimlik doğrulama, kapsamlar ve hız limitleriyle gerçek bir REST API — MCP ile tek bir kanonik veri katmanı paylaşır, böylece sayılar asla çelişmez.

Temiz REST, tipli JSON

Öngörülebilir kaynaklar, standart HTTP fiilleri, tipli JSON yanıtları ve RFC uyumlu hatalar (401 kimlik doğrulanmadı, 403 scope_required, Retry-After ile 429). HTML scraping yok, kırılgan dışa aktarımlar yok.

Tek kanonik veri katmanı

REST uç noktaları ve MCP araçları, aynı sağlayıcılar ü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.

Self servis anahtarlar

Bearer token'ları saniyeler içinde panelinizden oluşturun ve iptal edin. Aynı sca_live_ anahtarı hem REST API'yi hem de MCP sunucusunu kimlik doğrular — tek kimlik bilgisi, iki yüzey.

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.

Kapsamlı erişim

Kaba okuma ve yazma kapsamları her uç noktayı korur, güvenlik duvarında standart yükseltme yanıtlarıyla uygulanır. Bir anahtara yalnızca ihtiyacı olanı verin.

Çok kiracılı, yakında

Kiracı başına bir Google OAuth akışı; böylece iş ortakları müşterilerinin GSC mülklerinin her birini tek bir hesap altında bağlayabilir — sıkı veri yalıtımıyla. Aktif geliştirme aşamasında; erken erişim için bize ulaşın.

3 adımda başlayın

Sıfırdan ilk kimlik doğrulamalı çağrınıza birkaç dakikada ulaşın.

Bir anahtar oluşturun

Panelinizde API token'ları sayfasını açın ve bir Bearer token oluşturun. Bir kez kopyalayın — `sca_live_` ile başlar.

Başlığı gönderin

`https://api.seocrawl.ai/v1`'e yaptığınız her istekte `Authorization: Bearer sca_live_…` iletin. Aynı anahtar MCP sunucusunda da çalışır.

Veri çekin

Bir mülk `id`'si almak için `GET /v1/properties` çağırın, ardından GSC performansı, AI Tracker prompt'ları veya görevler için `/v1/properties/{id}/…` adresine gidin — ve JSON'u doğrudan ürününüze, panelinize veya ambarınıza aktarın.

Verilerinize ulaşmanın üç yolu

Aynı 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.

MCP sunucusu

AI ajanları için — Claude, ChatGPT ve herhangi bir MCP istemcisi verilerinizi doğal dilde sorgular.

MCP'yi keşfedin

Terminal ve CLI

Betikler ve CI/CD için — verilerinizi MCP uyumlu herhangi bir terminal ajanından yönetin.

CLI'yi görün

Tüm entegrasyonları karşılaştırın

API üzerine kimler geliştiriyor

SEO ve AI görünürlük verilerini kendi sistemlerinde isteyen ekipler.

SaaS ve iş ortakları

Canlı SEO metriklerini kendi ürün arayüzünüze gömün. Hatları kendiniz kurmadan kullanıcılarınıza Search Console ve AI görünürlük verileri sunun.

Ajanslar

Her müşterinin verisini özel bir portala, Looker Studio'ya veya raporlama katmanınıza aktarın — tek anahtar, tüm mülkler, elle dışa aktarım yok.

Veri ekipleri

GSC, sıralama ve AI Tracker verilerini ambarınıza planlı olarak indirin. Bunu gelirle birleştirin ve panellerinizin ihtiyaç duyduğu modelleri kurun.

Geliştiriciler

Kontrolleri ve uyarıları otomatikleştirin, görevleri PM aracınızla senkronize edin ve AI görünürlük izlemesini zaten yayınladığınız uygulamalara bağlayın.

Sıkça sorulan sorular

Gerçekten herkese açık bir SEO API var mı?

Evet — Bearer kimlik doğrulamalı bir REST `/v1` API canlı; Search Console performansını, mülkleri, AI Tracker prompt'larını ve görevleri kapsıyor ve tam herkese açık referans api.seocrawl.ai/docs adresinde yayında. Daha geniş kapsam (GA4, tam site denetimi dışa aktarımı) ve çok kiracılı iş ortağı OAuth'u sırada. Henüz canlı olmayan bir şeye mi ihtiyacınız var? Erken erişim için bize yazın.

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.

MCP ile aynı anahtar mı?

Evet. Aynı token hem REST API'yi hem de MCP sunucusunu kimlik doğrular, çünkü ikisi de tek bir kanonik veri katmanından okur. Tek kimlik bilgisi, iki yüzey — ve ikisinde de aynı sayılar.

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.

Müşterilerimin Search Console mülklerini bağlayabilir miyim?

O çok kiracılı iş ortağı akışı — müşterilerinizin GSC mülklerinin her birini kendi hesabınız altında sıkı veri yalıtımıyla bağlamanızı sağlayan kiracı başına bir Google OAuth — aktif geliştirme aşamasında. Bir iş ortağı entegrasyonu geliştiriyorsanız erken erişim için bize ulaşın.

Bugün hangi verileri çekebilirim?

Search Console özeti ve dönem karşılaştırmaları, en iyi anahtar kelimeler ve sayfalar, tek anahtar kelime/sayfa detayı, mülk listeniz, AI Tracker prompt'ları ve görevlerde tam okuma/yazma. MCP'nin sunduğunun REST üzerinden bir aynasıdır.

SEO verileriniz üzerine geliştirmeye hazır mısınız?

Panelinizden bir Bearer anahtarı oluşturun ve ilk REST çağrınızı dakikalar içinde yapın — ya da iş ortağı ve çok kiracılı erişim için bizimle konuşun.

API anahtarınızı alın Demo ayarlayın