Developer API

Authentication

Use Firebase session cookies, Authorization: Bearer <firebase-id-token>, or X-API-Key: aiso_… for programmatic access.

Base URLs

• /api/v1/scans — create and list scans
• /api/v1/scans/{id} — fetch scan results
• /api/v1/scans/{id}/competitors — competitor analysis
• /api/v1/scans/{id}/simulate — AI answer simulation
• /api/v1/scans/{id}/faqs — FAQ generation
• /api/v1/scans/{id}/schemas — schema generation
• /api/v1/scans/{id}/export/pdf — PDF export

OpenAPI spec

Download the full schema at /api/openapi or /api/v1/openapi.

API keys

Create keys in Settings → API Keys after upgrading to Agency and creating a team organization.