Trafnova API

GET /api/v1/sites

Returns every site owned by the authenticated user, sorted by domain.

curl https://trafnova.com/api/v1/sites \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN"

{
  "sites": [
    {
      "id": 12,
      "domain": "example.com",
      "name": "Example",
      "installed_at": "2026-05-01T10:14:22Z",
      "last_seen_at": "2026-05-28T03:22:11Z",
      "alerts_enabled": true,
      "anomaly_z_threshold": 3.0
    }
  ]
}

GET /api/v1/sites/:id

Single site, including token + install_snippet so you can paste straight into the page.

{
  "id": 12, "domain": "example.com", "name": "Example",
  "installed_at": "2026-05-01T10:14:22Z", "last_seen_at": "2026-05-28T03:22:11Z",
  "alerts_enabled": true, "anomaly_z_threshold": 3.0,
  "token": "sfW1JvxBJDg7VQaT3HPY",
  "install_snippet": "<script>window.tn=window.tn||function(){(window.tn.q=window.tn.q||[]).push(arguments)}</script>\n<script defer data-token=\"sfW1JvxBJDg7VQaT3HPY\" src=\"https://cdn.trafnova.com/t.js\"></script>"
}

POST /api/v1/sites

Creates a site under the authenticated user. Returns 201 with the same shape as the single-site GET (token + install snippet included).

Request body

Unknown attributes (e.g. token, user_id, installed_at) are silently ignored.

curl -X POST https://trafnova.com/api/v1/sites \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"site":{"domain":"shop.example.com","name":"Shop"}}'

PATCH /api/v1/sites/:id

Partial update. Same permitted fields as create. 200 with the updated site_json on success, 422 on validation failure, 404 on cross-user access.

curl -X PATCH https://trafnova.com/api/v1/sites/12 \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"site":{"alerts_enabled":false,"name":"Shop (paused)"}}'

DELETE /api/v1/sites/:id

Hard delete. Cascades through the site's events, anomalies, goals, and GSC daily stats. 204 No Content on success, 404 on cross-user access.

curl -X DELETE https://trafnova.com/api/v1/sites/12 \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN"

GET /api/v1/sites/:site_id/goals

Lists every goal on a site you own.

curl https://trafnova.com/api/v1/sites/12/goals \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN"

{
  "goals": [
    { "id": 1, "site_id": 12, "name": "Checkout", "kind": "page", "target": "/checkout", "created_at": "2026-06-14T10:00:00Z" },
    { "id": 2, "site_id": 12, "name": "Signup", "kind": "event", "target": "Signup", "created_at": "2026-06-14T10:01:00Z" }
  ]
}

POST /api/v1/sites/:site_id/goals

201 Created with the goal JSON. 422 with field-level details on validation failure (blank name, bad kind, or a target already tracked for that site+kind).

curl -X POST https://trafnova.com/api/v1/sites/12/goals \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"goal": {"name": "Checkout", "kind": "page", "target": "/checkout"}}'

DELETE /api/v1/sites/:site_id/goals/:id

204 No Content on success, 404 on cross-user access.

curl -X DELETE https://trafnova.com/api/v1/sites/12/goals/1 \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN"

GET /api/v1/sites/:id/stats

The full per-site analytics payload that powers the dashboard - timeseries plus 14 top-N tables, in one shot.

Query parameters

Whitelisted dimensions: source, country, region, city, browser, os, device, page, hostname. Operators: is, is_not, contains, does_not_contain (enum-ish dims like country only support is / is_not).

# Last 30 days, only google.com referrals, with prev-period overlay
curl "https://trafnova.com/api/v1/sites/12/stats?range=30d&compare=1\
&filter[source][op]=is&filter[source][values][]=google.com" \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN"

Response keys (abridged):

{
  "range": "30d",
  "labels": ["Apr 29", "Apr 30", ...],
  "pageviews": [...],
  "visits": [...],
  "total_pv": 12450, "total_uv": 7821,
  "top_pages":     [{ "label": "/", "count": 4521, "title": "Home - Acme" }, ...],
  "entry_pages":   [...], "exit_pages": [...],
  "top_sources":   [...], "top_channels": [...],
  "top_countries": [...], "top_regions":  [...], "top_cities": [...],
  "top_browsers":  [...], "top_browser_versions": [...],
  "top_os":        [...], "top_os_versions":      [...],
  "top_devices":   [...], "top_hostnames":        [...],
  "top_campaigns": [...],
  "top_screen_sizes": [{ "label": "Mobile", "count": 1203 }, ...], "top_languages": [{ "label": "en-US", "count": 880 }, ...],
  "goals": [...],
  "event_properties": [...],
  "page_properties": [{ "event_name": "Pageviews", "total": 312, "keys": [{ "key": "author", "values": [...] }] }],
  "engagement": { "bounce_rate": 0.41, "avg_duration_seconds": 84, "views_per_visit": 1.9 }
}

CSV export

Append .csv + a dataset param to download a single table. Datasets: timeseries (default), top_pages, entry_pages, exit_pages, top_sources, top_channels, top_countries, top_regions, top_cities, top_browsers, top_browser_versions, top_os, top_os_versions, top_devices, top_hostnames, top_campaigns, top_screen_sizes, top_languages.

curl "https://trafnova.com/api/v1/sites/12/stats.csv?dataset=top_pages&range=7d" \
  -H "Authorization: Bearer $TRAFNOVA_TOKEN" \
  -o top_pages.csv

GET /api/v1/sites/:id/realtime

Last-5-minute distinct sessions + 30-bucket per-minute pageview histogram + top countries. Poll on a ~5s cadence. Filter params accepted (same shape as Stats).

{
  "visitors_now": 47,
  "page_views_now": 132,
  "labels":    ["18:34", "18:35", ..., "19:03"],
  "histogram": [3, 5, 4, 8, ...],
  "histogram_pv": [7, 9, 6, 14, ...],
  "top_countries": [{ "country_code": "US", "count": 18 }, ...],
  "top_sites": [{ "site_id": 1, "count": 12 }, ...],
  "top_countries_pv": [{ "country_code": "US", "count": 41 }, ...],
  "top_sites_pv": [{ "site_id": 1, "count": 30 }, ...]
}

The visitor widgets (histogram, top_sites, top_countries) count distinct sessions; the _pv variants count raw pageviews. The dashboard card's visitors/page-views toggle swaps between the two sets.

GET /api/v1/sites/:id/search_engines

Same payload shape as /stats, but pre-filtered to events where the referrer host matches a known search engine. Two extra keys: top_engines and search_landing_pages.