Skip to main content
The Extended API is a set of low-latency edge utilities that complement the Main API. Use it for high-volume operations where round-trip latency matters: email address validation, DNS lookups for domain setup, SMS number validation, and AI subject-line scoring.

​
Base URL

Both the Main API and Extended API now serve from the same hostname. The Extended API ships the wire-level conventions live today (Spotzee-Version, X-Request-Id, RFC 7807 error envelope). The Main API is rolling those conventions out in stages. See API conventions for the full set.

​
Authentication

All requests require a bearer token. The same API keys used for the Main API are accepted here. See Authentication.

​
Capabilities

​
When to use Extended over Main

​
Versioning

The Extended API is dated like the Main API. Pin a version with the Spotzee-Version request header (see API versioning). The current release is 2026-04-28. The OpenAPI specification is published at:

​
Rate limits and quota

Two separate gates apply to Extended API traffic. Edge rate limit. Spotzee’s edge network enforces a per-source-IP cap of 4,000 requests per 10 seconds across apix.spotzee.com/api/*, with a 10-second block when exceeded. Over-limit traffic receives 429 Too Many Requests with the canonical error envelope. The cap counts every request, authenticated or not. Credit-based quota. Metered endpoints require available credits, and the cost varies by route. Check your balance in the Spotzee app before high-volume runs; the generated Extended API reference does not expose a public Quota endpoint. Per-API-key sliding-window rate limits and a doubled budget for MCP traffic are rolling out alongside the Main API hardening rollout. The Extended API does not honour those today.

​
Errors

See the Extended API errors reference.

​
Next

Authentication

API keys and scopes.

Errors

Status codes and error bodies.