HTTP API
Stats & health
Queue depth, capacity, and liveness.
The panel below refreshes from the same data as GET /stats (via a same-origin proxy so your API key is not exposed in the browser).
Live API metrics
Loading…
GET /stats
Returns per-market queue depth and session capacity. Requires authentication when API_KEY is set on the server.
curl -sS "https://serp.lexis-solutions-apis.com/stats" \
-H "Authorization: Bearer YOUR_API_KEY"Response shape
{
"queues": {
"decodo:us": 0,
"decodo:de": 0
},
"capacity": {
"us": { "ready": 4, "active": 6 },
"de": { "ready": 2, "active": 1 }
},
"metrics": {
"requestsProcessed": 12045,
"latencyMs": { "p50": 420, "p99": 2100 }
}
}- queues — number of jobs waiting to run for each
vendor:countryqueue. - capacity.ready — search sessions available to take new jobs.
- capacity.active — sessions currently running a job.
- metrics — API process stats (per container, not cluster-wide when you run multiple API replicas):
- requestsProcessed — completed POST /serp calls since process start (
GET /statsand/healthare excluded). - latencyMs.p50 / latencyMs.p99 — POST /serp end-to-end response time percentiles from a rolling sample (up to the last 4,096 searches).
- requestsProcessed — completed POST /serp calls since process start (
Use this endpoint before high-volume bursts to confirm the service has headroom.
GET /health
Unauthenticated liveness probe. See Authentication.
curl -sS "https://serp.lexis-solutions-apis.com/health"{ "ok": true }