Queue für Full-Site-SEO-Scan-Jobs
Developer API
Site-Audit-API — Crawls in die Queue stellen und Ergebnisse programmgesteuert lesen
Crawls vor Releases in die Queue stellen. Bis zum Abschluss abfragen und Report-Links abrufen — kein Dashboard nötig.
Async-Jobs
Crawls in die Queue stellen, bis zum Abschluss abfragen, Report-Links abrufen
Die Site Audit API verwendet dasselbe Async-Job-Modell wie CI- und cron-Integrationen — POST zum Queueing, GET zum Abfragen und anschließend geteilte Reports auflisten, wenn der Scan fertig ist.
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/scansEinen eigenen Crawler bauen vs. XenonFlare API
Bauen Sie intern, wenn…
- Headless Browser — Höflichkeits-Queues und Crawl-Infrastruktur
- Bewertungsregeln — Problem-Taxonomie und Report-Speicherung
- Integrator-Authentifizierung — Rate Limits, Idempotenz und Job-Polling
- Monitoring — wenn Crawler auf Bot-Schutz oder TLS-Probleme treffen
Nutzen Sie XenonFlare, wenn…
- Warteschlange für Full-Site-Scans — mit POST /properties/:id/scans
- Job-Status abfragen — Score und Issue-Anzahl per GET /jobs/:id
- Eingeschränkte Bearer-Keys — Test-Keys für CI und OpenAPI-Codegen
- Gleiche Crawl-Engine — wie Web-App mit GSC-Overlay + API
Workflow der Kunden
“Wir überwachen 40 Kundensites über ein internes Dashboard. Nachts gestartete Batch-Scans, Webhook-Alerts, wenn ein Crawl fehlschlägt, und CSV-Aktivitäts-Exports für das Reporting — ohne sich bei jeder Property einzuloggen.”
Digitale Agentur, die die XenonFlare Developer API in Growth nutzt
- 40 Properties
- POST /scans/batch
- Webhook-Delivery-Historie
- Aktivität als CSV exportieren
Typischer Integrations-Flow
- Erstellen Sie einen Starter- oder Growth-Workspace und einen API-Key mit jobs:write
- Property-IDs auflösen via GET /properties
- Einen Scan in die Queue stellen mit POST /properties/:id/scans
- GET /jobs/:id abfragen, bis der Status „completed“ oder „failed“ ist
Das bekommen Sie
Status, Fortschritt und Ergebnisse abfragen
Liste aktiver, gemeinsam genutzter Audit-Report-Links
jobs:read/write, reports:read, properties:read
Idempotency-Key
Sichere Retries bei Write-Requests
Rate Limits
1.000 Reads/Std. und 60 Writes/Std. pro Key (500 Org-Writes/Tag)
FAQ
Können Agenturen den API-Zugriff an Kunden weiterverkaufen?
Agenturen betreiben einen Growth-Workspace mit den Kunden-Properties darin und nutzen eingeschränkte Keys für Dashboards und nächtliche Scans. Lieferung über Shared Links, Webhooks oder Ihr Portal — Kunden müssen keine API-Keys besitzen.
Welcher Plan enthält die Site Audit API?
Für Developer-API-Zugriff benötigen Sie Starter oder Growth. Der Free-Plan enthält die Web-App und kostenlose xenonflare.com-Tools, aber keine API-Keys.
Wie unterscheidet sich das vom kostenlosen Audit-Tool?
Kostenlose Tools geben einen One-Page-Snapshot ohne Konto. Die API stellt Full-Site-Crawls in die Queue, die mit Ihrem Workspace verknüpft sind — inklusive Job-Historie, Plan-Crawl-Limits und teilbaren Reports.
Welche API-Rate-Limits gibt es?
Standardmäßig: 1.000 Read-Requests pro Stunde pro Key, 60 Write-Requests pro Stunde pro Key und 500 Write-Requests pro Organisation pro Tag. Bis zu 5 aktive Keys pro Workspace. Details finden Sie in den Developer API-Dokumenten.
Developer API in bezahlten Workspace-Plänen
Erstellen Sie API-Keys in der Web-App, nachdem Sie aufgestockt haben. Das Free-Tier umfasst das Dashboard und kostenlose Marketing-Tools — nicht REST-Keys.