Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.saytics.com/llms.txt

Use this file to discover all available pages before exploring further.

The Saytics REST API gives you programmatic access to all platform functionality — track events from any language or framework, query reports, and manage user data without touching the dashboard.

Base URL

All API requests are made to the following base URL:
https://api.saytics.com/v1

Authentication

Every request to the Saytics API must include your API key in the Authorization header. See the authentication guide for details on key types and how to find your keys.
Authorization: Bearer YOUR_API_KEY

Rate limits

Rate limits apply per API key and vary by plan.
PlanRequests/minuteBatch size
Free100100 events
Starter500500 events
Pro2,0001,000 events
EnterpriseCustomCustom
When you exceed your rate limit, the API returns a 429 status code. Wait until the next minute window before retrying.

Response format

All responses use JSON. A successful response includes a status field; error responses include an error object with a code and message.
// Success
{
  "status": "ok",
  "received": 1
}

// Error
{
  "error": {
    "code": "invalid_key",
    "message": "The provided API key is invalid or revoked."
  }
}

HTTP status codes

CodeMeaning
200Success
400Bad request — check your request body
401Unauthorized — invalid or missing API key
429Rate limit exceeded
500Server error — contact support

Versioning

The current API version is v1, reflected in the base URL. When breaking changes are introduced, Saytics will notify you by email and post details in the changelog before the change takes effect.