# Specvista Analytics

> Specvista Analytics is product analytics for websites, React Native apps and Node.js servers, with a consent banner built in. Websites add one script tag; apps and servers send named events over HTTP; reports cover pageviews, sessions, sources, devices, countries, custom events, funnels and identified people. Sign-up is self-serve and free.

## Instructions for agents

- Supported access: a person signs up at https://analytics.specvista.com/signup and creates a property (project). Its project key, which starts with sa_live_, authenticates event sending in the X-Api-Key header. Reading reports needs a bearer token from POST https://analyticsapi.specvista.com/api/v1/auth/login, valid for 90 days. The person signs in and gives you the token through the SA_TOKEN environment variable. Never ask for, type or store their password.
- API base: https://analyticsapi.specvista.com/api/v1. Contract: https://analyticsapi.specvista.com/api/v1/openapi.json.
- Websites: <script src="https://analyticsapi.specvista.com/api/v1/sdk.js" data-api-key="<project key>" async></script>. Custom events only send after the visitor accepts analytics in the banner.
- Packages: check before installing. Run npm view specvista-analytics-node version and npm view specvista-analytics-rn version. Both are prepared but not yet on npm; if npm returns E404, use the plain HTTP helpers in the guides. Never pin an old version from memory.
- Servers must send "source":"backend". Requests from script-like user agents (curl, headless browsers, python-requests and similar) are otherwise stored as bot traffic and left out of reports.
- Errors return JSON with a stable code and a doc_url. Match on code and follow doc_url.
- Safe ways to try: there is no sandbox or test mode yet. Read-only calls (sdk.js, openapi.json, reports) are safe. Every POST /ingest stores a real event, so send tests to a separate test property. Events with "environment":"development" are stored as internal and excluded from reports.
- Never: commit keys or tokens; put secrets, passwords, payment details or free text in event properties; create accounts or properties, rotate keys, delete properties, or call /forget without the person's go-ahead.
- There is no MCP server or CLI yet. Use the HTTP API.
- Every page below is Markdown. Add .md to any docs page address for its Markdown. The whole set is in one file at https://analytics.specvista.com/llms-full.txt.


## Start here

- [Specvista Analytics docs](https://analytics.specvista.com/docs.md): What Specvista Analytics is, who it is for and how access works.
- [Build with AI agents](https://analytics.specvista.com/docs/agents.md): Every entry point for AI agents, safe ways to try things and a rules snippet for your repository.

## Task guides

- [Get a project key](https://analytics.specvista.com/docs/get-a-project-key.md): Create an account and a property, then find its project key, in the dashboard or with the API.
- [Add tracking to a website](https://analytics.specvista.com/docs/track-web.md): Add the browser script to any website or Next.js app, handle consent, send custom events and confirm data arrives.
- [Add tracking to a Node.js server](https://analytics.specvista.com/docs/track-node.md): Send server events from Node.js, NestJS or Express, with the SDK or plain HTTP.
- [Add tracking to a React Native app](https://analytics.specvista.com/docs/track-react-native.md): Track app opens, screens and events in React Native and Expo apps on iOS and Android.
- [Read reports](https://analytics.specvista.com/docs/read-reports.md): Read pageviews, events, funnels, sources and people from the dashboard or the API.

## Reference

- [API reference](https://analytics.specvista.com/docs/api.md): Every public endpoint, its authentication, fields and responses.
- [SDK reference](https://analytics.specvista.com/docs/sdks.md): The browser script, Node.js and React Native SDKs, their status and every export.
- [Errors](https://analytics.specvista.com/docs/errors.md): Every error code with what it means and how to fix it.

## Machine interfaces

- [OpenAPI 3.0 document](https://analyticsapi.specvista.com/api/v1/openapi.json): every public endpoint, schema and error code.
- [Browser script](https://analyticsapi.specvista.com/api/v1/sdk.js): the website SDK.
- [Full docs in one file](https://analytics.specvista.com/llms-full.txt): every page below, as Markdown.

## Optional

- [Sign up](https://analytics.specvista.com/signup): for people, not agents.
- [Sign in](https://analytics.specvista.com/login): the dashboard.