Documentation

These are the developer docs for Tidings, a lightweight product-analytics service for developers and small product teams. Tidings has one moving part: your application POSTs JSON events to a single HTTP endpoint, and your team reads them back as live feeds, user histories, funnels, retention, and dashboards. There is no SDK to install — anything that can make an HTTP request is already integrated.

Examples use $TIDINGS_API for your API origin — locally that's http://localhost:8000.

Overview

Everything below is that one endpoint from every angle: how to authenticate, the event payload, batching, and copy-paste snippets. Want your coding assistant to wire it up? Jump to Set up with AI.

Quickstart

  1. Create an account and your first project. Every project gets a default API key.
  2. Copy the key from Settings → API keys in the app. Keys look like td_…
  3. Send an event:
terminalbash
$ curl -X POST $TIDINGS_API/api/v1/events/ \
    -H 'X-API-Key: td_your_key_here' \
    -H 'Content-Type: application/json' \
    -d '{"name": "first_event", "distinct_id": "user_1"}'

{"accepted": 1}

Building for the browser? Use the snippet — one script tag that handles the anonymous id, page views and sign-in for you.

Open the events explorer — your event is already there.

Where to next