Data APIs
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:country queue.
  • 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 /stats and /health are excluded).
    • latencyMs.p50 / latencyMs.p99 — POST /serp end-to-end response time percentiles from a rolling sample (up to the last 4,096 searches).

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 }

On this page