Metti in coda i job per la SEO-scan full-site
Developer API
Site audit API — accoda i crawl e leggi i risultati via codice
Accoda i crawl prima dei rilasci. Controlla fino al completamento e recupera i link del report — niente dashboard richieste.
Job asincroni
Accoda crawl, attendi il completamento e recupera i link dei report
Site Audit API usa lo stesso modello di job asincroni delle integrazioni CI e cron — POST per accodare, GET per controllare, poi elenca i report condivisi quando la scansione è finita.
Quick start (curl)
Replace $XF_API_KEY and property IDs with values from your workspace. Full reference: Developer API docs.
curl -s -X POST \
-H "Authorization: Bearer $XF_API_KEY" \
-H "Idempotency-Key: scan-$(date +%s)" \
-H "Content-Type: application/json" \
-d @scan-body.json \
https://api.xenonflare.com/api/v1/properties/$XF_PROPERTY_ID/scansCostruisci il tuo crawler oppure usa l’API di XenonFlare
Costruisci internamente quando…
- Browser headless — code di cortesia, e infrastruttura di crawling
- Regole di scoring — tassonomia delle issue, e archiviazione dei report
- Autenticazione integratori — limiti di velocità, idempotenza e polling dei job
- Monitoraggio — quando i crawler incontrano protezioni anti-bot o problemi TLS
Usa XenonFlare quando…
- Code di scansioni full-site — con POST /properties/:id/scans
- Verifica stato job — punteggio e conteggio delle issue tramite GET /jobs/:id
- Chiavi Bearer con ambito — chiavi di test per CI, e codegen OpenAPI
- Stesso motore di crawling — come app web con overlay GSC + API
Workflow del cliente
“Monitoriamo 40 siti client da un’unica dashboard interna. Scan batch notturni, alert webhook quando un crawl fallisce e export attività CSV per il reporting del cliente — senza dover accedere a ogni singola proprietà.”
Digital agency che usa XenonFlare Developer API su Growth
- 40 proprietà
- POST /scans/batch
- Cronologia consegne webhook
- Export attività CSV
Flusso di integrazione tipico
- Crea un workspace Starter o Growth e una chiave API con jobs:write
- Risolvi gli ID delle proprietà tramite GET /properties
- Metti in coda una scansione con POST /properties/:id/scans
- Verifica GET /jobs/:id finché lo stato non è completato o fallito
Cosa ottieni
Controlla stato, avanzamento e risultati
Elenca i link attivi ai report audit condivisi
jobs:read/write, reports:read, properties:read
Idempotency-Key
Retry sicuri sulle richieste di scrittura
Limiti di velocità
1.000 letture/ora e 60 scritture/ora per chiave (500 scritture per organizzazione/giorno)
FAQ
Le agenzie possono rivendere l’accesso API ai clienti?
Le agenzie eseguono un solo workspace Growth con le proprietà dei clienti al suo interno, usando chiavi con ambito per dashboard e scansioni notturne. Consegna tramite link condivisi, webhook o il tuo portale — i clienti non devono tenere chiavi API.
Quale piano include la Site Audit API?
L’accesso API per sviluppatori richiede Starter o Growth. Il piano Free include l’app web e gli strumenti gratuiti su xenonflare.com, ma non include chiavi API.
In cosa è diverso dallo strumento di audit gratuito?
Gli strumenti Free offrono una panoramica di una pagina senza account. L’API mette in coda crawl full-site collegati al tuo workspace, con cronologia dei job, limiti di crawling per piano e report condivisibili.
Quali sono i rate limits dell’API?
I default sono 1.000 richieste di lettura per ora per chiave, 60 richieste di scrittura per ora per chiave e 500 richieste di scrittura per organizzazione al giorno. Fino a 5 chiavi attive per workspace. Per i dettagli, consulta la documentazione Developer API.
Developer API sui piani workspace a pagamento
Crea le API keys nell’app web dopo l’upgrade. Il piano free include la dashboard e gli strumenti di marketing gratuiti — non le REST keys.