How do I authenticate with the SEOAudits API?

SEOAudits uses JWT tokens stored in HttpOnly Secure cookies. Include the JWT in the Authorization: Bearer header for API-only integrations.

What are the rate limits?

Rate limits vary by plan: Free (30/min), Pro (120/min), Agency (300/min), Enterprise (1,000/min).

Can I use the API for CI/CD integration?

Yes. Many teams run SEOAudits audits automatically on every deployment, breaking the build if the SEO score drops below a threshold.

SEOAudits REST API

Integrate SEO auditing into your applications, CI/CD pipelines, and dashboards. Create audits programmatically, fetch results in real-time, and build custom workflows on top of SEOAudits's scoring engine.

TL;DR: SEOAudits's REST API lets you create audits, fetch results, and manage workspaces programmatically. Perfect for CI/CD pipelines and custom dashboards.

What Is the SEOAudits API?

The SEOAudits REST API is a programmatic interface built on Rust and Axum that enables automated SEO auditing, workspace management, and real-time progress streaming via standard HTTP requests.

The API is built on Rust + Axum and designed for performance and reliability. It uses JWT authentication via HttpOnly cookies and returns JSON responses with consistent error formatting.

Whether you are building a white-label SEO dashboard, integrating audits into your CI/CD pipeline, or automating client reporting, the SEOAudits API provides the data and control you need.

API Endpoints

All endpoints are prefixed with https://api.seoaudits.dev and require authentication for write operations.

POST

/api/audits

Create a new SEO audit for a given URL. Returns audit ID and job ID for tracking.

GET

/api/audits

List all audits for the current workspace with pagination.

GET

/api/audits/:id

Get detailed audit results including score, issues, pages, and metadata.

GET

/api/audits/:id/job

Check the status of an audit job (queued, running, completed, failed).

GET

/api/audits/:id/stream

Server-Sent Events stream for real-time audit progress updates.

GET

/api/audits/:id/pages/:page_id

Get detailed page-level data including Lighthouse metrics and GEO score.

GET

/api/workspace

Get current workspace details including members and subscription status.

GET

/api/workspaces

List all workspaces the authenticated user has access to.

POST

/api/billing/checkout

Create a Stripe Checkout session for plan upgrades.

GET

/api/billing/portal

Generate a Stripe Customer Portal session for managing subscriptions.

Common Use Cases

CI/CD Integration

Run SEO audits automatically on every deployment. Break the build if the score drops below a threshold or critical issues are introduced.

White-Label Dashboards

Build custom client dashboards that pull audit data from SEOAudits via API. Display scores, issue counts, and improvement trends in your own UI.

Automated Reporting

Schedule daily or weekly audits via the API and generate custom reports in PDF, CSV, or any format you need.

Multi-Site Monitoring

Monitor dozens of client sites from a single integration. Create audits, track scores over time, and alert on regressions.

Authentication

SEOAudits uses JWT tokens stored in HttpOnly Secure cookies with SameSite=Strict. When you authenticate via the magic link flow, the API sets an access_token cookie that is automatically sent with every request.

For API-only integrations, include the JWT in the Authorization: Bearer <token> header. Tokens expire after 15 minutes and are refreshed automatically via the /api/auth/refresh endpoint.

All authenticated endpoints require a valid token and operate within the context of the user's current workspace. Workspace switching is handled via the /api/workspace/switch endpoint.

Rate Limits

Plan	Requests / Minute	Audits / Month
Free	30	1
Pro	120	10
Agency	300	40
Enterprise	1,000	200+

Start building with SEOAudits

Get API Access

Questions about the API? Read the documentation.