API SEO
L’API SEO di Screpy è un’API REST per portare dati di progetti, crawl, Rank Tracker, AI Visibility salvata, pagine, monitoraggio e opportunità nei tuoi prodotti, dashboard e automazioni. Usa risposte JSON strutturate per creare flussi SEO sui dati accessibili al tuo account Screpy.
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.
/projectsJSONAuthorization: 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.
/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.
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.
- 1RevisioneAperto
/guides - 2GeneratoAperto
/shop - CompletatoIn attesa
example.com
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.
/guides/seo200
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.
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.
linen shirt#11
Impressioni
2860Gestisci 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.
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.
example.com [1]
example.org [2]
example.org/guidesexample.net/researchAnalizza 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.
- example.org
- example.net
- example.edu
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.
disavow.txtRevisionedomain: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.
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.
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.
- Screpy: Ciao! Vediamo API SEO per example.com. Cosa vuoi sapere?
- Tu: Elenca i miei progetti Screpy e apri il riepilogo di example.com.
- Screpy: Seleziona example.com e controlla l’ultima scansione completata e i dati disponibili. L’assistente accede solo ai progetti accessibili al tuo account Screpy. Contesto del progetto: Progetto: example.com. Scansione: Ultima esecuzione completata.
- Tu: Trasformalo in un breve piano d’azione.
- Screpy: Terrò separati i risultati dalle raccomandazioni. Esamina le prove, scegli una modifica e controlla poi i risultati. I prossimi passi: Esamina: Controlla fonte e data di ogni risultato.. Decidi: Scegli la prima modifica.. Verifica: Confronta i risultati dopo la modifica..
- Tu: Puoi spiegare le prove con parole semplici?
- Screpy: Sì. Chiedi di un risultato supportato e spiegherò cosa mostra, da dove proviene e quali incertezze restano. I dati mancanti restano indisponibili; le raccomandazioni non sono correzioni automatiche.
Domande sull’API SEO.
Scopri come l’API REST di Screpy autentica le richieste, delimita progetti e crawl ed espone dati per prodotti SEO e automazioni personalizzate.
Chi può usare l’API SEO di Screpy?
L’API REST di Screpy è disponibile per gli account membro a pagamento. Ogni richiesta controlla idoneità, limiti delle funzioni e accesso al progetto richiesto.
Come creo una chiave API SEO di Screpy?
Crea una chiave API REST in Impostazioni → App collegate e inviala come token Bearer in ogni richiesta. Le credenziali OAuth MCP non autenticano l’API REST di Screpy.
Come trovo UID di progetto e UID di crawl?
Inizia con GET /projects per elencare i progetti disponibili alla chiave API. Usa l’UID del progetto selezionato con la lista dei crawl, che restituisce l’UID necessario alle richieste di dati.
Quali dati può restituire l’API SEO di Screpy?
Per un crawl completato selezionato, l’API REST può restituire pagine, link, immagini, risultati on-page e Quick Wins. Mantieni insieme l’ambito del progetto e del crawl nei report e nelle automazioni.
Posso recuperare Core Web Vitals e uptime tramite API?
Sì. Core Web Vitals e uptime sono esposti tramite endpoint di salute separati perché sono segnali diversi. Una risposta data: null può indicare che non è ancora disponibile un controllo corrispondente.
Posso usare AI Visibility tramite API?
Sì. L’API legge dati salvati di riepilogo, menzioni, risposte, citazioni, prompt e fonti e può aggiungere o eliminare logicamente prompt monitorati. Gli export CSV ed Excel restano disponibili solo nella dashboard; suggerimenti e rianalisi manuale non sono disponibili via API.
Posso gestire Rank Tracker tramite API?
Sì. L’API supporta riepilogo Rank Tracker, elenco e gestione delle keyword, cronologia e risultati salvati e anteprima o gestione dei segmenti. Non offre export CSV/XLSX, ricerche SERP live o rianalisi manuale.
L’API SEO di Screpy può confrontare i crawl?
Sì. L’API dei confronti accetta due riferimenti di crawl completati e restituisce un confronto strutturato per analizzare i cambiamenti tra i riferimenti.
Qual è la differenza tra API SEO di Screpy e SEO MCP?
L’API SEO di Screpy è un’API REST per prodotti, dashboard e automazioni personalizzate autenticata con una chiave REST. Screpy SEO MCP espone strumenti Screpy strutturati agli assistenti AI compatibili tramite OAuth e Model Context Protocol.