CLI and analytics API

Everything on the Analytics page can be read with an API key, and you can send events and notes from your own code.

API key

Go to Dashboard → API Keys → Create key. Tick Analytics read to read numbers. Tick Write too if you want to send events or notes. Keys start with spintaxify_.

Send it as a header on every call:

Authorization: Bearer spintaxify_xxx

Endpoints

All live under https://spintaxifycms.com/api/v1/projects/YOUR-SITE-ID

Method	Path	What it does
GET	/analytics?period=7d	Totals, chart, pages, sources, places, devices (plus goals, revenue, AI bots with those scopes)
GET	/analytics/live	Who is on the site in the last 5 minutes
POST	/analytics/events	Count a goal from your server: name, user_id, path, props
GET	/analytics/notes	Notes on the chart (since, until)
POST	/analytics/notes	Add a note: text, at
DELETE	/analytics/notes?id=	Delete a note
GET	/analytics/visitors	Identified visitors (q to search)
GET	/analytics/visitors?user_id=42	One visitor's journey

Periods: today, yesterday, 7d, 30d, 3mo, 6mo, 12mo, all.

Command line

A small tool that runs on Node 18 or newer, nothing else to install:

curl -fsSL https://spintaxifycms.com/cli/spintaxify.mjs -o spintaxify.mjs
node spintaxify.mjs login spintaxify_xxx
node spintaxify.mjs stats YOUR-SITE-ID --period 7d
node spintaxify.mjs live YOUR-SITE-ID
node spintaxify.mjs event YOUR-SITE-ID paid --user 42 --prop plan=pro
node spintaxify.mjs note YOUR-SITE-ID "Sent the newsletter"
node spintaxify.mjs visitors YOUR-SITE-ID --user 42

Run node spintaxify.mjs help for the full list. Add --json to get raw JSON for scripts.

AI assistants

The same data is available to Claude, ChatGPT and other assistants through MCP. See REST API and MCP.