Sites API: List and Retrieve Your Tracked TinyTrack Sites

The Sites endpoint lets you programmatically list every website you have registered in your TinyTrack account and retrieve detailed information about individual sites. Use the id values returned here as the site_id parameter in the Stats and Events endpoints.

List Sites

Retrieve all sites associated with your account. GET /v1/sites No query parameters are required for this endpoint.

Example Request

cURL

curl https://api.tinytrack.io/v1/sites \
  -H "Authorization: Bearer tt_live_xxxxxxxxxxxx"

Example Response

{
  "data": [
    {
      "id": "site_abc123",
      "domain": "blog.acme.dev",
      "created_at": "2024-01-15T10:00:00Z",
      "tracking_active": true
    }
  ],
  "meta": { "total": 1 }
}

Response Fields

string

required

The unique identifier for the site. Use this value as the site_id parameter in Stats and Events requests.

string

required

The registered domain for the site (e.g. blog.acme.dev). This matches the data-site attribute in your tracking snippet.

string

required

The date and time the site was added to your TinyTrack account, formatted as an ISO 8601 UTC timestamp (e.g. 2024-01-15T10:00:00Z).

boolean

required

Whether the TinyTrack snippet is actively receiving events for this site. true means data is flowing; false means no events have been received recently or tracking has been paused.

Get a Single Site

Retrieve the details for one specific site by its ID. GET /v1/sites/{site_id}

Path Parameters

string

required

The unique ID of the site to retrieve. Obtain this value from the List Sites endpoint.

Example Request

cURL

curl https://api.tinytrack.io/v1/sites/site_abc123 \
  -H "Authorization: Bearer tt_live_xxxxxxxxxxxx"

Example Response

{
  "data": {
    "id": "site_abc123",
    "domain": "blog.acme.dev",
    "created_at": "2024-01-15T10:00:00Z",
    "tracking_active": true
  }
}

The response returns the same site object as described in the List Sites response fields above. If no site with the given site_id exists in your account, the API returns HTTP 404:

{
  "error": "not_found",
  "message": "No site found with ID site_abc123",
  "status": 404
}

Managing Sites in the Dashboard

You can add, rename, and delete sites from the Sites section of your TinyTrack dashboard at tinytrack.io. The API is read-only for sites — create and remove sites through the UI, then reference them here by their id.

Each site you add receives a unique id that never changes, even if you update the domain. Always use the id (not the domain string) to reference sites in API calls.

Overview

Endpoints

Sites API: List and Retrieve Your Tracked TinyTrack Sites

List Sites

Example Request

Example Response

Response Fields

Get a Single Site

Path Parameters

Example Request

Example Response

Managing Sites in the Dashboard

​List Sites

​Example Request

​Example Response

​Response Fields

​Get a Single Site

​Path Parameters

​Example Request

​Example Response

​Managing Sites in the Dashboard

List Sites

Example Request

Example Response

Response Fields

Get a Single Site

Path Parameters

Example Request

Example Response

Managing Sites in the Dashboard