OPEN SOURCE ANALYTICS API

A clearer view
of what happened.

A small analytics API for the actions that matter. Collect pageviews and custom events. Ask for counts and breakdowns. No dashboard between you and the data.

Free access. Verify your email. No payment required. Read our privacy page and service terms.

02Pageview and custom event types
90 daysMaximum query range
120 / minEvents per site limit

CHOOSE A PLAN

One API. Two limits.

Free

USD $0

  • 1 verified site
  • 10,000 events per UTC month
  • 30 days of event data
Start Free

Pro

USD $9 / month

  • 5 verified sites
  • 100,000 events per UTC month
  • 365 days of event data

Only a verified paid Subscription grants Pro.

Choose Pro
01THE METHOD

AN API, NOT AN INTERFACE

The shortest path
from event to answer.

Register a site with a private account API token. Customer sites need DNS proof. Send a pageview or a custom event from its HTTPS origin. Ask the API for totals and grouped counts.

01 / REGISTER

Give a site a name.

The account API creates a site and returns a stable ID.

02 / COLLECT

Send one event.

The public route accepts bounded pageviews and custom events. Optional property labels stay short.

03 / QUERY

Get a count.

Request totals or group pages, event names, referrers, and allowed property values.

02THE CONTRACT

Plain requests.
Useful answers.

Use a documented HTTP contract. Keep the account token private. The event route checks the site origin; that check does not authenticate a sender.

Read the complete OpenAPI contract
ONE EVENT / JSON
POST /v1/collect/{siteId}
Origin: https://your-site.com

{
  "kind": "event",
  "path": "/guide",
  "name": "guide_open",
  "properties": {
    "section": "intro"
  }
}
204 NO CONTENTMAX 2 KB / EVENT
03THE BOUNDARY

COLLECT LESS. KNOW ENOUGH.

Count the event.
Not the person.

Site policy controls bounded URL queries, referrer detail, and other new event dimensions. YWG uses client IP and User-Agent transiently for monthly pseudonyms but stores no raw IP, raw User-Agent, or analytics cookies.

01Pageviews & events

Counts within a time range. Pseudonymous visitor and visit estimates report identity coverage.

02Small property labels

Up to eight on a custom event. Do not send personal data in labels or paths.

03Source you can inspect

The server uses AGPLv3. You can read the source and host a version yourself.

THE NEXT STEP

Start with
the contract.

Free signup is open. Verify your email to receive a private API token. Choose Free without payment or Pro for USD $9 per month through Stripe Checkout.