REST API · v1 · Dokumentasi live

SEO API untuk stack Anda sendiri

Data SEO dan visibilitas AI Anda, lewat endpoint REST yang rapi.

Tarik data Google Search Console, peringkat, dan AI Tracker langsung ke produk, dasbor, atau data warehouse Anda. Autentikasi dengan Bearer key dari dasbor Anda, panggil REST `/v1`, dan dapatkan JSON bertipe — lapisan data kanonis yang sama yang menggerakkan SEOcrawl AI MCP. GA4, ekspor site audit lengkap, dan OAuth mitra multi-tenant akan menyusul.

Dapatkan API key Anda Jelajahi MCP

Autentikasi Bearer · 60 req/mnt · Lapisan data yang sama dengan MCP · Tanpa scraping

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, … }

} }

Autentikasi sekali. Panggil REST.

Buat token Bearer dari dasbor Anda dan sertakan di header Authorization. Key yang sama berlaku baik untuk REST API maupun server MCP.

Base URL

https://api.seocrawl.ai/v1

Header Authorization

Authorization: Bearer sca_live_your_token_here

Dapatkan API key Anda 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())

Endpoint

Satu lapisan data, dua permukaan

Setiap endpoint REST membaca dari lapisan kanonis yang sama dengan tool MCP — sehingga dasbor dan agen AI Anda selalu melihat angka yang identik. Grup-grup ini sudah live di v1; cakupan terus bertambah.

Properti

Cantumkan properti Search Console yang bisa Anda akses. Gunakan `id` setiap properti di path pada setiap endpoint data.

GET/v1/propertiesLive

Google Search Console

Klik, impresi, CTR, dan posisi rata-rata — per kueri, halaman, rentang tanggal, dan perbandingan antarperiode.

GET/v1/properties/{id}/gsc/summaryLive
GET/v1/properties/{id}/gsc/compareLive
GET/v1/properties/{id}/gsc/top-keywordsLive
GET/v1/properties/{id}/gsc/top-pagesLive
GET/v1/properties/{id}/gsc/keywords/detailLive
GET/v1/properties/{id}/gsc/pages/detailLive

AI Tracker

Baca prompt yang Anda pantau untuk penyebutan merek di ChatGPT, Claude, Gemini, dan Perplexity.

GET/v1/properties/{id}/ai-tracker/promptsLive

Tugas

Baca dan tulis tugas SEO — hubungkan papan tugas Anda ke stack manajemen proyek Anda sendiri.

GET/v1/properties/{id}/tasksLive
POST/v1/properties/{id}/tasksLive
GET/v1/properties/{id}/tasks/{ticketId}Live
PATCH/v1/properties/{id}/tasks/{ticketId}Live
POST/v1/properties/{id}/tasks/{ticketId}/commentsLive

GA4 & Indeksasi

Trafik, perujuk AI, dan status indeksasi. Titik sambungnya sudah siap; endpoint REST sedang diluncurkan.

GET/v1/properties/{id}/ga4/summarySegera
GET/v1/properties/{id}/indexation/summarySegera

Site Audit

Kesehatan crawl, on-page, teknis, dan daftar masalah — dataset audit lengkap, disajikan lewat REST.

GET/v1/properties/{id}/audit/summarySegera
GET/v1/properties/{id}/audit/issuesSegera

Mengapa API ini

Dibangun untuk produk, bukan scraper

REST API sungguhan dengan autentikasi Bearer, scope, dan rate limit — berbagi satu lapisan data kanonis dengan MCP sehingga angka tak pernah berbeda.

REST rapi, JSON bertipe

Resource yang dapat diprediksi, verb standar, respons JSON bertipe, dan error sesuai RFC (401 tidak terautentikasi, 403 scope_required, 429 dengan Retry-After). Tanpa scraping HTML, tanpa ekspor yang rapuh.

Satu lapisan data kanonis

Endpoint REST dan tool MCP adalah saudara di atas provider yang sama, dengan paritas yang diuji di CI. Dasbor dan agen AI Anda selalu melihat klik, impresi, dan posisi yang identik.

Key self-service

Buat dan cabut token Bearer dari dasbor Anda dalam hitungan detik. Key sca_live_ yang sama mengautentikasi baik REST API maupun server MCP — satu kredensial, dua permukaan.

Rate limit terdokumentasi

60 permintaan per menit dan 1.000 per jam per token, dengan respons 429 + Retry-After yang jelas. Limit REST adalah pool terpisah dari pemakaian MCP — yang satu tak pernah menghabiskan yang lain.

Akses ber-scope

Scope baca dan tulis yang kasar menjaga setiap endpoint, diberlakukan di firewall dengan respons step-up standar. Berikan sebuah key hanya apa yang dibutuhkannya.

Multi-tenant, segera hadir

Alur Google OAuth per-tenant agar mitra dapat menghubungkan setiap properti GSC pelanggan mereka di bawah satu akun — dengan isolasi data yang ketat. Sedang dikembangkan aktif; minta akses awal kepada kami.

Mulai dalam 3 langkah

Dari nol hingga panggilan terautentikasi pertama Anda dalam beberapa menit.

Buat sebuah key

Buka token API di dasbor Anda dan hasilkan token Bearer. Salin sekali — diawali dengan `sca_live_`.

Kirim header-nya

Sertakan `Authorization: Bearer sca_live_…` pada setiap permintaan ke `https://api.seocrawl.ai/v1`. Key yang sama juga berlaku dengan server MCP.

Tarik data

Panggil `GET /v1/properties` untuk memperoleh `id` properti, lalu akses `/v1/properties/{id}/…` untuk performa GSC, prompt AI Tracker, atau tugas — dan salurkan JSON langsung ke produk, dasbor, atau warehouse Anda.

Tiga cara menjangkau data Anda

Angka yang sama, permukaan berbeda — pilih yang sesuai dengan cara Anda membangun.

REST API

Untuk produk, dasbor, dan pipeline data. Autentikasi Bearer, JSON bertipe, rate limit. Anda sedang berada di halaman ini.

Server MCP

Untuk agen AI — Claude, ChatGPT, dan klien MCP apa pun mengueri data Anda dalam bahasa alami.

Jelajahi MCP

Terminal & CLI

Untuk skrip dan CI/CD — kendalikan data Anda dari agen terminal mana pun yang mendukung MCP.

Lihat CLI

Bandingkan semua integrasi

Siapa yang membangun di atas API

Tim yang menginginkan data SEO dan visibilitas AI di dalam sistem mereka sendiri.

SaaS & mitra

Sematkan metrik SEO live ke dalam UI produk Anda sendiri. Berikan pengguna Anda data Search Console dan visibilitas AI tanpa membangun pipeline-nya sendiri.

Agensi

Salurkan data setiap klien ke portal khusus, Looker Studio, atau lapisan pelaporan Anda — satu key, semua properti, tanpa ekspor manual.

Tim data

Datangkan data GSC, peringkat, dan AI Tracker ke warehouse Anda secara terjadwal. Gabungkan dengan pendapatan dan bangun model yang dibutuhkan dasbor Anda.

Developer

Otomatiskan pengecekan dan peringatan, sinkronkan tugas dengan tool PM Anda, dan hubungkan pemantauan visibilitas AI ke aplikasi yang sudah Anda rilis.

Pertanyaan yang sering diajukan

Apakah benar ada SEO API publik?

Ya — REST `/v1` API dengan autentikasi Bearer sudah live, mencakup performa Search Console, properti, prompt AI Tracker, dan tugas, dengan referensi publik lengkap diterbitkan di api.seocrawl.ai/docs. Cakupan yang lebih luas (GA4, ekspor site audit lengkap) dan OAuth mitra multi-tenant akan menyusul. Butuh sesuatu yang belum live? Minta akses awal kepada kami.

Bagaimana cara saya melakukan autentikasi?

Dengan token Bearer. Buat key `sca_live_` dari dasbor Anda dan kirim sebagai `Authorization: Bearer <key>` pada setiap permintaan. Tidak ada tahapan OAuth untuk akun Anda sendiri — cukup header-nya.

Apakah key-nya sama dengan MCP?

Ya. Token yang sama mengautentikasi baik REST API maupun server MCP, karena keduanya membaca dari satu lapisan data kanonis. Satu kredensial, dua permukaan — dan angka yang identik di antaranya.

Berapa rate limit-nya?

60 permintaan per menit dan 1.000 per jam per token. Jika melampauinya, Anda mendapatkan `429` dengan header `Retry-After`. Limit REST dilacak terpisah dari pemakaian MCP, sehingga keduanya tak pernah berebut anggaran yang sama.

Bisakah saya menghubungkan properti Search Console pelanggan saya?

Alur mitra multi-tenant itu — Google OAuth per-tenant agar Anda dapat menghubungkan setiap properti GSC pelanggan Anda di bawah akun Anda sendiri, dengan isolasi data yang ketat — sedang dikembangkan aktif. Jika Anda sedang membangun integrasi mitra, hubungi kami untuk akses awal.

Data apa yang bisa saya tarik hari ini?

Ringkasan Search Console dan perbandingan periode, kata kunci dan halaman teratas, detail satu kata kunci/halaman, daftar properti Anda, prompt AI Tracker, serta baca/tulis penuh pada tugas. Ini mencerminkan apa yang disediakan MCP, lewat REST.

Siap membangun di atas data SEO Anda?

Buat Bearer key dari dasbor Anda dan lakukan panggilan REST pertama Anda dalam hitungan menit — atau bicarakan akses mitra dan multi-tenant dengan kami.

Dapatkan API key Anda Pesan demo