Chiavi con ambito per organizzazione con permessi espliciti per scope
Developer API
SEO automation API per agenzie, team SaaS e DevOps
Pianifica crawl notturni, abilita i deploy in CI e gestisci le proprietà con chiavi API con ambito per organizzazione — Agency per 50+ siti.
CI e cron
Gestisci i deploy in GitHub Actions o esegui scansioni batch notturne
Le stesse chiavi API alimentano i controlli PR e l’automazione del portfolio — limita la profondità di crawling sulle pull request, esegui scansioni complete su main e avvisa quando i job falliscono.
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
“Il nostro team operations esegue POST /scans/batch ogni notte su 40 proprietà dei clienti. I webhook avvisano Slack quando un job fallisce e esportiamo i log di attività API ogni mese per la conformità.”
Automazione del portfolio per agenzie su XenonFlare Agency
- 40 siti ogni notte
- Scansioni batch + webhook
- Correlazione GSC + crawl
Cosa ottieni
xf_test_… per la sandbox CI — le scritture sono no-op
Lo stesso tipo di job di SEO-scan sotto il cofano
Filtra per stato, propertyId e tipo
Endpoint di utilizzo
GET /usage and GET /limits for plan quotas
Parità con l’app
Funziona insieme a WordPress apply e alla sincronizzazione con GSC
Specifica OpenAPI
Per Insomnia, codegen e client API
FAQ
Per chi è pensata la SEO API?
Per agenzie che monitorano i portafogli clienti, team SaaS che proteggono i siti di marketing e team di engineering che eseguono controlli SEO in CI prima dei deploy in produzione.
L’API include i dati di Google Search Console?
Sì — con gsc:read sulla tua chiave API dopo aver collegato Search Console nell’app web. Automatizza i crawl con jobs:write; recupera query e JSON della pagina via GET /properties/:id/gsc/*. Consulta la reference dei campi GSC.
Quali sono i rate limit predefiniti?
Le richieste in lettura sono limitate per chiave API per ora; le scritture hanno un limite orario più basso e anche un limite di sicurezza giornaliero a livello di organizzazione. Consulta la documentazione API per i valori predefiniti attuali.
Pronto ad automatizzare?
Passa a Starter, Growth o Agency, crea chiavi API con ambito e segui le guide per l’integrazione con cron o CI. Le agenzie con 50+ siti client dovrebbero partire da Agency.