Con un token Bearer. Genera una chiave `sca_live_` dal tuo dashboard e inviala come `Authorization: Bearer ` a ogni richiesta. Nessuna danza OAuth per il tuo account — solo l'header.

API REST · v1 · Docs live

API SEO per il tuo stack

I tuoi dati SEO e di visibilità nell'IA, su un endpoint REST pulito.

Recupera i dati di Google Search Console, di ranking e di AI Tracker direttamente nel tuo prodotto, dashboard o data warehouse. Autenticati con una chiave Bearer dal tuo dashboard, chiama la REST `/v1` e ricevi JSON tipizzato — lo stesso livello dati canonico che alimenta il MCP di SEOcrawl AI. GA4, l'export completo dell'audit del sito e l'OAuth multi-tenant per i partner arrivano a breve.

Ottieni la tua chiave API Esplora il MCP

Auth Bearer · 60 req/min · Lo stesso livello dati del MCP · Nessuno 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, … }

} }

Autenticati una volta. Chiama la REST.

Genera un token Bearer dal tuo dashboard e passalo nell'header Authorization. La stessa chiave funziona sia sull'API REST sia sul server MCP.

URL base

https://api.seocrawl.ai/v1

Header Authorization

Authorization: Bearer sca_live_your_token_here

Ottieni la tua chiave API 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

Un livello dati, due superfici

Ogni endpoint REST legge dallo stesso livello canonico degli strumenti MCP — così il tuo dashboard e i tuoi agenti IA vedono sempre numeri identici. Questi gruppi sono live in v1; la copertura si amplia di continuo.

Proprietà

Elenca le proprietà di Search Console a cui hai accesso. Usa l'`id` di ogni proprietà nel path di ogni endpoint dati.

GET/v1/propertiesLive

Google Search Console

Clic, impression, CTR e posizione media — per query, pagina, intervallo di date e periodo su periodo.

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

Leggi i prompt che monitori per le menzioni del brand su ChatGPT, Claude, Gemini e Perplexity.

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

Task

Leggi e scrivi task SEO — collega la tua board dei task al tuo stack di project management.

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 e indicizzazione

Traffico, referrer IA e stato di indicizzazione. La connessione è pronta; gli endpoint REST sono in fase di rilascio.

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

Audit del sito

Salute del crawl, on-page, tecnico ed elenchi di problemi — l'intero dataset dell'audit, esposto via REST.

GET/v1/properties/{id}/audit/summaryPresto
GET/v1/properties/{id}/audit/issuesPresto

Perché questa API

Costruita per i prodotti, non per gli scraper

Una vera API REST con auth Bearer, scope e limiti di richieste — che condivide un unico livello dati canonico con il MCP, così i numeri non discordano mai.

REST pulita, JSON tipizzato

Risorse prevedibili, verbi standard, risposte JSON tipizzate ed errori conformi agli RFC (401 non autenticato, 403 scope_required, 429 con Retry-After). Nessuno scraping di HTML, nessun export fragile.

Un unico livello dati canonico

Gli endpoint REST e gli strumenti MCP sono fratelli sugli stessi provider, con la parità testata in CI. Il tuo dashboard e i tuoi agenti IA vedono sempre clic, impression e posizioni identici.

Chiavi self-service

Genera e revoca token Bearer dal tuo dashboard in pochi secondi. La stessa chiave sca_live_ autentica sia l'API REST sia il server MCP — una credenziale, due superfici.

Limiti di richieste documentati

60 richieste al minuto e 1,000 all'ora per token, con risposte chiare 429 + Retry-After. I limiti REST sono un pool separato dall'uso del MCP — l'uno non affama mai l'altro.

Accesso con scope

Scope grossolani di lettura e scrittura proteggono ogni endpoint, applicati al firewall con risposte di step-up standard. Concedi a una chiave solo ciò di cui ha bisogno.

Multi-tenant, in arrivo

Un flusso Google OAuth per tenant così che i partner possano collegare ciascuna delle proprietà GSC dei loro clienti sotto un unico account — con rigoroso isolamento dei dati. In sviluppo attivo; chiedici l'accesso anticipato.

Inizia in 3 passi

Da zero alla tua prima chiamata autenticata in un paio di minuti.

Genera una chiave

Apri API tokens nel tuo dashboard e genera un token Bearer. Copialo una sola volta — inizia con `sca_live_`.

Invia l'header

Passa `Authorization: Bearer sca_live_…` a ogni richiesta verso `https://api.seocrawl.ai/v1`. La stessa chiave funziona anche con il server MCP.

Recupera i dati

Chiama `GET /v1/properties` per ottenere un `id` di proprietà, poi interroga `/v1/properties/{id}/…` per le performance di GSC, i prompt di AI Tracker o i task — e convoglia il JSON direttamente nel tuo prodotto, dashboard o warehouse.

Tre modi per raggiungere i tuoi dati

Gli stessi numeri, una superficie diversa — scegli quella adatta al tuo modo di costruire.

API REST

Per prodotti, dashboard e pipeline di dati. Auth Bearer, JSON tipizzato, limiti di richieste. Sei su questa pagina.

Server MCP

Per gli agenti IA — Claude, ChatGPT e qualsiasi client MCP interrogano i tuoi dati in linguaggio naturale.

Esplora il MCP

Terminale e CLI

Per script e CI/CD — pilota i tuoi dati da qualsiasi agente di terminale compatibile con MCP.

Vedi la CLI

Confronta tutte le integrazioni

Chi costruisce sull'API

Team che vogliono dati SEO e di visibilità nell'IA all'interno dei propri sistemi.

SaaS e partner

Integra metriche SEO live nell'UI del tuo prodotto. Offri ai tuoi utenti dati di Search Console e di visibilità nell'IA senza costruire tu stesso le pipeline.

Agenzie

Convoglia i dati di ogni cliente in un portale su misura, in Looker Studio o nel tuo livello di reporting — una chiave, tutte le proprietà, nessun export manuale.

Team dati

Fai atterrare i dati di GSC, di ranking e di AI Tracker nel tuo warehouse su base pianificata. Uniscili al fatturato e costruisci i modelli di cui i tuoi dashboard hanno bisogno.

Sviluppatori

Automatizza controlli e avvisi, sincronizza i task con il tuo strumento di PM e collega il monitoraggio della visibilità nell'IA alle app che già rilasci.

Domande frequenti

Esiste davvero un'API SEO pubblica?

Sì — un'API REST `/v1` autenticata con Bearer è live, e copre le performance di Search Console, le proprietà, i prompt di AI Tracker e i task, con l'intera reference pubblica pubblicata su api.seocrawl.ai/docs. Una copertura più ampia (GA4, export completo dell'audit del sito) e l'OAuth multi-tenant per i partner arrivano a breve. Ti serve qualcosa che non è ancora live? Chiedici l'accesso anticipato.

Come mi autentico?

Con un token Bearer. Genera una chiave `sca_live_` dal tuo dashboard e inviala come `Authorization: Bearer <key>` a ogni richiesta. Nessuna danza OAuth per il tuo account — solo l'header.

È la stessa chiave del MCP?

Sì. Lo stesso token autentica sia l'API REST sia il server MCP, perché entrambi leggono da un unico livello dati canonico. Una credenziale, due superfici — e numeri identici tra loro.

Quali sono i limiti di richieste?

60 richieste al minuto e 1,000 all'ora per token. Se li superi ottieni un `429` con un header `Retry-After`. I limiti REST sono tracciati separatamente dall'uso del MCP, così i due non competono mai per lo stesso budget.

Posso collegare le proprietà di Search Console dei miei clienti?

Quel flusso multi-tenant per i partner — un Google OAuth per tenant per collegare ciascuna delle proprietà GSC dei tuoi clienti sotto il tuo account, con rigoroso isolamento dei dati — è in sviluppo attivo. Se stai costruendo un'integrazione partner, contattaci per l'accesso anticipato.

Quali dati posso recuperare oggi?

Il riepilogo di Search Console e i confronti tra periodi, le keyword e le pagine top, il dettaglio di una singola keyword/pagina, il tuo elenco di proprietà, i prompt di AI Tracker e lettura/scrittura complete sui task. Rispecchia ciò che il MCP espone, via REST.

Pronto a costruire sui tuoi dati SEO?

Genera una chiave Bearer dal tuo dashboard e fai la tua prima chiamata REST in pochi minuti — oppure parlaci di un accesso partner e multi-tenant.

Ottieni la tua chiave API Prenota una demo