PureStats
Sign in

PureStats documentation

Events API

Send server-side analytics events to PureStats.

Use the Events API for backend-side events, webhook conversions or systems where browser tracking is not reliable.

Endpoint

POST https://purestats.io/api/event
Content-Type: application/json

Example payload

{
  "domain": "example.com",
  "name": "Payment Completed",
  "url": "https://example.com/checkout/success",
  "path": "/checkout/success",
  "referrer": "https://example.com/pricing",
  "props": {
    "plan": "pro",
    "billing_cycle": "annual"
  }
}

Validation

The API validates:

  • Domain or alias.
  • URL and path format.
  • Bot or spam signals.
  • Payload size.
  • Required fields.

Invalid payloads are rejected and should not enter analytics tables.

Authentication

Browser tracker calls rely on domain validation. Server-side integrations should use configured API credentials when available for your deployment.

Retry behavior

For important backend events, retry temporary failures with backoff. Do not retry validation errors without changing the payload.