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 Leggi la documentazione Esplora il MCP

SEOcrawl AI REST API — curl request and typed JSON response

SEOcrawl AI REST API examples in cURL, JavaScript and Python

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

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. Tutti i dettagli nella pagina dedicata all'API di Google Search Console.

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

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 Leggi la documentazione Prenota una demo