API SEO

Crea report SEO e automazioni con il JSON strutturato dei tuoi progetti Screpy. Recupera evidenze di scansione, posizioni delle keyword, backlink, AI Visibility archiviata e risultati di monitoraggio tramite una REST API per progetto, con azioni supportate per gestire il tuo lavoro.

Leggi la guida introduttiva all'API Crea un account Screpy

Elenca i progetti accessibili

                GET https://api.screpy.com/v1/projects
Authorization: Bearer YOUR_API_KEY

{
  "data": [{
    "uid": "a1b2c3d4e5",
    "name": "Example Site",
    "domain": "example.com",
    "crawler_enabled": true,
    "created_at": "2026-09-24T09:00:00Z",
    "updated_at": "2026-09-24T09:00:00Z"
  }],
  "links": { "next": null },
  "meta": { "next_cursor": null }
}

Estratto di risposta illustrativo. L'accesso REST richiede un account membro a pagamento; la chiave restituisce solo progetti propri o condivisi a cui hai accesso.

Autentica la SEO API

Crea una chiave REST in Impostazioni → App collegate e inviala come token bearer dal tuo server. Scegli i permessi necessari all'integrazione.

Le chiavi di sola lettura recuperano dati; quelle di lettura e scrittura consentono anche le modifiche supportate.
Copia il segreto alla creazione: viene mostrato una sola volta. Non inserirlo nel codice pubblico del browser.
Revoca le chiavi in App collegate. Sono consentite fino a 20 chiavi attive, con scadenza dopo un anno.

Leggi la guida all'autenticazione

GET/projectsJSON

Authorization: Bearer
••••••••••••••••••••••••

Verifica l'accesso API

REST richiede un account membro a pagamento. Anche l'appartenenza al progetto e le funzionalità a cui il progetto ha diritto determinano dati e azioni disponibili.

Gli endpoint account mostrano piano, funzionalità e numero di progetti accessibili.
I report di utilizzo includono i limiti delle funzionalità, ma consumo e disponibilità residua sono attualmente calcolati solo per i progetti di tua proprietà.
I valori di utilizzo null sono indisponibili, non consumo zero.

Esplora gli endpoint account

GET/projects200

{
  "data": [
    { "domain": "example.com" }
  ]
}

Gestisci i progetti SEO

Elenca progetti propri e condivisi, recupera una panoramica o crea progetti entro la quota di quelli di tua proprietà. Usa gli UID restituiti nelle richieste successive.

Aggiorna nomi, preferenze di mercato e fuso orario e impostazioni di scansione o monitoraggio supportate.
Cambiare dominio richiede un nuovo progetto; modificare impostazioni non riscrive risultati completati.
La creazione verifica capacità e validità del sito.
Solo il proprietario può eliminare il progetto.

Esplora gli endpoint progetti

example.comProgetto

example.orgProgetto

example.netProgetto

Avvia scansioni del sito

Avvia una scansione con accesso in scrittura e conserva il suo UID. La scansione procede in background: segui lo stato prima di recuperare i risultati.

Una scansione in corso o il crawler disattivato può impedire un nuovo avvio.
Riepiloghi e dataset richiedono una scansione completata con successo; risultati incompleti restituiscono un conflitto.
Mantieni insieme i riferimenti di progetto e scansione nei report e nei confronti delle istantanee.

Esplora gli endpoint scansioni

1
Revisione/guides
Aperto
2
Generato/shop
Aperto
Completatoexample.com
In attesa

Recupera dati di scansione SEO

Crea report di SEO tecnica da una scansione completata selezionata. Recupera dettagli delle pagine e risali alle pagine di origine di link e immagini.

Le pagine includono stato HTTP, titoli, descrizioni, intestazioni, canonical, profondità di scansione e tempi.
I link mostrano destinazioni, testi di ancoraggio, stato nofollow e contesto della pagina di origine.
Le immagini includono testo alternativo, dimensioni, stato di recupero e pagine di origine.
Usa filtri di campo supportati e dati paginati; non è un export HTML completo né un'interfaccia SQL.

Esplora gli endpoint dati di scansione

/guides/seo200

Indicizzato

Confronta progetti e scansioni

Confronta riepiloghi di SEO tecnica tra progetti o istantanee di scansioni completate. Conserva riferimenti espliciti per confronti riproducibili.

I confronti accettano da due a cinque progetti accessibili, usando le ultime scansioni completate o istantanee selezionate.
Il confronto tra due scansioni restituisce variazioni di salute, pagine e problemi come secondo valore meno primo.
Sono confronti di riepiloghi; recupera separatamente i record di scansione per indagare singoli URL.

Esplora gli endpoint confronti

Prima62→Dopo87

Recupera SEO Quick Wins

Porta opportunità prioritarie nel tuo lavoro con fonte e periodo di riferimento. Un riferimento di scansione completata verifica l'accesso, ma non rende ogni opportunità un'istantanea di quella scansione.

Con dati collegati disponibili, Search Console offre opportunità su query vicine alle prime posizioni, CTR, cannibalizzazione, cali e variazioni di visibilità.
Le evidenze di link interni possono riferirsi all'ultima scansione del progetto indicata nei metadati.
Le evidenze basate sul traffico richiedono la connessione pertinente, i permessi e dati sufficienti.
Conserva tipi di report, intervallo, avvisi e disponibilità; un report vuoto non dimostra l'assenza di problemi.

Esplora Quick Wins

linen shirt#11

Impressioni

2860

Gestisci il monitoraggio ranking

Leggi visibilità delle keyword, storico analisi e risultati archiviati nel contesto di mercato e dispositivo. Gestisci le keyword monitorate invece di richiedere ricerche arbitrarie in tempo reale.

Filtra keyword per ricerca, dispositivo e segmento basato sugli URL, comprese quelle senza corrispondenza.
Aggiungi fino a 100 keyword per richiesta; l'analisi iniziale viene accodata, non restituita subito.
Elimina keyword monitorate e visualizza in anteprima, crea, aggiorna o rimuovi segmenti con accesso in scrittura.
REST non offre SERP in tempo reale, rianalisi manuali o export CSV/XLSX di Rank Tracker.

Esplora gli endpoint Rank Tracker

Posizionamenti

+24 Posizione

Accedi ad AI Visibility

Collega risposte IA archiviate a menzioni del brand, citazioni ed evidenze delle fonti. Conserva contesto di prompt, paese, lingua e piattaforma nei tuoi report.

Leggi panoramiche, menzioni, risposte, citazioni, prompt monitorati e attività di domini o URL di origine.
Aggiungi fino a 20 prompt per richiesta entro la capacità del progetto o rimuovi prompt monitorati con accesso in scrittura.
Suggerimenti di prompt, rianalisi manuale ed export AI Visibility non sono operazioni REST.

Esplora AI Visibility

example.com [1]
example.org [2]

1example.org/guides

2example.net/research

Analizza i backlink

Leggi il profilo backlink di un progetto o di un concorrente già aggiunto, scelto tra le opzioni disponibili. Collega i singoli link ai domini di riferimento nei tuoi report di autorevolezza.

Recupera metriche generali, domini di riferimento e backlink di un dominio selezionato.
Esamina gap di backlink e dataset supportati di domini persi o con link interrotti.
Conserva destinazione, filtri, ordinamento e cursore; non consente ricerche illimitate su qualsiasi dominio.
Gli export CSV/XLSX delle tabelle coprono la pagina corrente. Continua con X-Next-Cursor.

Esplora Backlink Checker

example.org
example.net
example.edu

example.com84 Link

Gestisci i record disavow

Conserva nel progetto domini o URL esaminati con relative note e prepara un file di testo nel formato Google. Le decisioni di disconoscimento restano tue.

L'accesso in scrittura permette fino a 100 nuove voci per richiesta o l'eliminazione di record esistenti.
Esporta il testo disavow del progetto separatamente dalle tabelle paginate.
Esamina e invia il file manualmente; salvare un record non lo invia a Google e non rimuove un backlink.

Esplora Disavow Management

disavow.txtRevisione

domain:example.org
https://example.net/links

Dominioexample.org
URLexample.net/links

Leggi la salute del sito

Separa prestazioni delle pagine e disponibilità del sito nei report. Questi endpoint restituiscono controlli esistenti, non una nuova misurazione su richiesta.

Le prestazioni restituiscono l'ultima homepage controllata con FCP, LCP, CLS, TTFB, TBT e Speed Index, non tutte le pagine né uno storico completo.
Uptime riepiloga gli ultimi 30 giorni e restituisce fino ai 160 controlli più recenti con stato, tempo di risposta e data.
Senza prestazioni viene restituito data:null; senza controlli uptime, i valori del riepilogo restano null e la lista è vuota.

Esplora gli endpoint salute

example.comLaboratorio

LCP2,1 s
TBT180 ms
CLS0,04

Pagina i dati SEO

Recupera dataset grandi in pagine gestibili mantenendo il contesto della richiesta nel tuo processo. Verifica la disponibilità prima di trasformare risposte in metriche.

Le liste supportate restituiscono 50 record per default e fino a 100; segui link successivi o cursori opachi.
Mantieni filtri, destinazioni e periodi coerenti tra pagine. I parametri non validi vengono rifiutati.
Gestisci esplicitamente errori di autorizzazione, scansione incompleta, dati indisponibili e limiti di richieste, senza sostituire risultati mancanti con zero.

Leggi la guida agli errori API

JSONcursor_2

Parla di API SEO. Con SEO MCP.

Collega l’assistente al progetto Screpy tramite SEO MCP. Seleziona un progetto, esamina il riepilogo e indaga i dati supportati di scansione, posizionamento e ricerca con accesso circoscritto.

Scopri Screpy SEO MCP Collega il tuo assistente IA

Domande sulla SEO API

Risposte pratiche per scegliere l'accesso REST, trattare i dati e creare un'integrazione affidabile.

Quali sono i limiti di richieste API?

Al minuto, il limite base è 300 richieste per chiave e 900 per account. Gli endpoint pesanti consentono inoltre 60 per chiave e 180 per account; quelli di scrittura, 30 e 90. I controlli si applicano insieme. Gestisci HTTP 429 e riprova dopo l'attesa consentita.

In cosa differiscono SEO API e SEO MCP?

SEO API serve al software che sviluppi, con richieste REST e una chiave bearer REST. SEO MCP espone strumenti supportati agli assistenti IA compatibili tramite Model Context Protocol e la propria autorizzazione. Le credenziali MCP non autenticano REST e le operazioni disponibili non sono identiche.

REST espone tutte le funzioni del dashboard?

No. La documentazione API elenca le operazioni REST supportate. Non esistono endpoint REST per risultati Map Tracker, generazione articoli, report PDF o tutti i dati analitici grezzi. Rank Tracker e AI Visibility hanno anche i limiti di azioni ed export descritti sopra.

Dati mancanti significano assenza di problemi SEO?

No. Valori null, record vuoti, avvisi ed errori di disponibilità hanno significati diversi. Una verifica prestazioni mancante non è un guasto del sito e un utilizzo indisponibile non è consumo zero. Controlla risposta e configurazione prima di concludere.

Come trovo UID di progetto e scansione?

Chiama GET /projects, seleziona un progetto accessibile e recupera la sua lista di scansioni. Usa insieme gli UID restituiti. Gli endpoint di riepilogo e dati richiedono una scansione completata con successo.

Posso esportare i dati API in CSV o Excel?

Gli endpoint di tabelle backlink supportano CSV/XLSX della pagina corrente con X-Next-Cursor per proseguire. Il testo disavow ha un export separato. Gli export CSV/XLSX di Rank Tracker e AI Visibility restano nel dashboard; altre risposte strutturate possono alimentare il tuo codice di reportistica.

Una chiave di sola lettura funziona con ogni POST?

No. I confronti POST di progetti e scansioni accettano lettura perché analizzano dati esistenti. Creare o modificare record, avviare scansioni e visualizzare anteprime di segmenti richiede lettura e scrittura. Verifica i permessi documentati anziché dedurli dal metodo HTTP.

Tutti i risultati API sono attuali o in tempo reale?

No. I record di scansione appartengono all'istantanea selezionata; ranking e AI Visibility usano analisi archiviate. Quick Wins segue fonte e periodo del report. Gli endpoint salute restituiscono controlli esistenti. Mantieni date disponibili e contesto delle fonti nei report.