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.

Inizia la prova gratuita Vedi i prezzi

TL;DR

Troppo lungo; non letto

Mostra riepilogo

Che cos’è l’API SEO di Screpy?

L’API SEO di Screpy è un’API REST per gli account membro a pagamento che espone progetti Screpy accessibili, crawl completati, Rank Tracker, dati e gestione dei prompt di AI Visibility salvati, confronti, Core Web Vitals e uptime tramite richieste JSON autenticate. È pensata per software personalizzati, sistemi di report e automazioni; usa una chiave API REST invece delle credenziali OAuth MCP.

Accesso e contesto dell’account

Le chiavi API SEO di Screpy si creano in Impostazioni → App collegate e vengono inviate come token Bearer in ogni richiesta REST.
L’API SEO di Screpy è disponibile per gli account membro a pagamento e controlla idoneità, limiti delle funzioni e accesso al progetto a ogni richiesta.
L’API SEO di Screpy elenca i progetti posseduti o condivisi con l’account autenticato, iniziando da GET /projects.
L’API SEO di Screpy restituisce utilizzo dell’account, limiti del piano, disponibilità residua e funzioni disponibili prima di avviare crawl o elaborare grandi risultati.

Progetti, crawl e confronti

L’API SEO di Screpy elenca, crea, aggiorna ed elimina i progetti accessibili per applicazioni SEO personalizzate e flussi per clienti.
L’API SEO di Screpy usa un UID di progetto per le richieste specifiche e restituisce un UID di crawl dalla lista del progetto selezionato.
L’API SEO di Screpy restituisce stato del crawl, riepiloghi dei crawl completati, indicatori di salute, conteggi dei problemi e totali per i flussi SEO tecnici.
L’API SEO di Screpy confronta due crawl completati per consentire a una dashboard o automazione di analizzare i cambiamenti tra riferimenti SEO tecnici.

Record dei crawl e dati di monitoraggio

L’API SEO di Screpy restituisce pagine, link, immagini, risultati on-page e Quick Wins da un crawl completato selezionato.
L’API SEO di Screpy mantiene insieme l’ambito del progetto e del crawl e supporta la paginazione per grandi risultati.
L’API SEO di Screpy restituisce Core Web Vitals e dati di uptime tramite endpoint di salute separati, perché prestazioni e disponibilità sono segnali diversi.
L’API SEO di Screpy può restituire data: null quando non è disponibile un controllo di salute corrispondente. Le integrazioni devono verificare la configurazione del monitoraggio prima di considerarlo un errore del sito.

Collega il tuo prodotto ai dati SEO.

Crea una chiave API REST, scopri i progetti accessibili al tuo account e usa identificatori stabili nei tuoi dashboard, automazioni o applicazioni.

Scopri di più su accesso api rest

Crea chiavi API REST in Impostazioni → App collegate
Autentica le richieste con un token Bearer
Scopri progetti propri e condivisi prima di scegliere un UID
Leggi utilizzo e limiti delle funzioni prima dei flussi costosi

GET /v1/projects 200 OK

{
  "data": [
    {
      "uid": "prj_8f3a1",
      "name": "Example site",
      "domain": "example.com",
      "role": "owner"
    }
  ]
}

Esegui flussi di crawl dal tuo stack.

Collega gestione dei progetti, stato dei crawl, riepiloghi completati e confronti ai sistemi che il tuo team usa già per le operazioni SEO.

Scopri di più su progetti e crawl

Crea e gestisci progetti Screpy accessibili tramite endpoint REST
Usa UID di progetto e crawl per leggere sito e crawl selezionati
Monitora avanzamento, indicatori di salute, problemi e totali
Confronta crawl completati per analizzare release, migrazioni o cambi di contenuto

GET /v1/projects/{project_uid}/crawls 200 OK

{
  "data": [
    {
      "uid": "crw_42c91",
      "status": "completed",
      "health": { "score": 91 },
      "issues": { "critical": 2, "warnings": 14 }
    }
  ]
}

Trasforma i record SEO in automazioni.

Usa record di crawl completati, Quick Wins, controlli delle prestazioni e segnali di uptime come input strutturati per report, notifiche e flussi SEO interni.

Scopri di più su dati dei crawl e salute

Recupera pagine, link, immagini e risultati on-page da un crawl completato
Usa Quick Wins per opportunità prioritarie di Search Console
Pagina grandi dataset senza mescolare record di crawl diversi
Mantieni Core Web Vitals e uptime accanto ai dati da seguire

POST /v1/comparisons/crawls 200 OK

{
  "data": {
    "change": {
      "health_score": 4,
      "critical_issues": -3,
      "indexable_pages": 12
    }
  }
}

Endpoint dell’API SEO per flussi personalizzati

Costruisci direttamente sui dati e flussi Screpy importanti per il tuo prodotto: accesso all’account, progetti, crawl, Rank Tracker, AI Visibility salvata, record dettagliati, confronti e salute del sito.

Chiavi API REST

Crea una chiave API REST in Impostazioni → App collegate e autentica ogni richiesta con un token Bearer.

Utilizzo dell’account

Leggi limiti del piano, disponibilità delle funzioni e utilizzo residuo prima di avviare crawl o elaborare molti record.

Gestione dei progetti

Elenca, crea, aggiorna ed elimina i progetti Screpy disponibili per la chiave API REST nel tuo flusso personalizzato.

Flussi di crawl

Leggi la lista dei crawl di un progetto e usa l’UID restituito per collegare i risultati selezionati alla tua applicazione.

Riepiloghi dei crawl

Restituisci stato, indicatori di salute, conteggi dei problemi, totali e avanzamento per report e monitoraggio SEO tecnico.

Confronti dei crawl

Confronta due crawl completati quando il tuo prodotto deve mostrare cosa è cambiato tra riferimenti SEO tecnici.

Record delle pagine

Recupera record di pagina e dettagli esatti per l’analisi SEO tecnica a livello URL in un’interfaccia personalizzata.

Record di link e immagini

Recupera link, immagini e contesto della pagina sorgente da un crawl completato selezionato.

Risultati on-page

Usa il contesto dell’audit on-page e i record del crawl per creare una revisione SEO tecnica mirata delle URL importanti.

Quick Wins

Porta le opportunità prioritarie di Search Console in una dashboard o automazione interna con il contesto del progetto e dell’intervallo di report.

API Rank Tracker

Leggi visibilità, cronologia delle keyword, risultati salvati e segmenti; aggiungi o elimina keyword monitorate e gestisci segmenti basati su URL.

API AI Visibility

Leggi dati salvati di riepilogo, menzioni, risposte, citazioni, prompt e fonti; aggiungi o elimina logicamente prompt monitorati entro il limite del piano.

Dati Core Web Vitals

Recupera i risultati Core Web Vitals disponibili tramite l’API di salute per flussi SEO orientati alle prestazioni.

Dati di uptime

Recupera stato di uptime e incidenti recenti per mostrare i segnali di disponibilità accanto ai dati SEO tecnici.

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.

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.

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 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.

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.

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.

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 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.

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.