Public API

Open endpoints — no authentication required. Base URL: https://siteviews.vercel.app

GET/api/public/analytics

Paginated visitor records with full location, device, browser, network, and session details.

Query Parameters

hostnamerequired— e.g. siteviews.netlify.app

pageoptional— Page number (default: 1)

limitoptional— Results per page (default: 10)

Example Request

https://siteviews.vercel.app/api/public/analytics?hostname=siteviews.netlify.app&page=1&limit=10

Example Response

{
  "status": 200,
  "success": true,
  "message": "SiteViews analytics data retrieved successfully",
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 312,
    "pages": 32
  },
  "data": [
    {
      "project": {
        "name": "my-project",
        "hostname": "siteviews.netlify.app"
      },
      "location": {
        "ip": "142.93.51.204",
        "coordinates": {
          "latitude": 40.7128,
          "longitude": -74.006
        },
        "city": "New York",
        "region": "New York",
        "country": {
          "code": "US",
          "name": "United States"
        },
        "continent": {
          "code": "NA",
          "name": "North America"
        },
        "timezone": "America/New_York"
      },
      "network": {
        "isp": "DigitalOcean LLC",
        "org": "DigitalOcean",
        "connectionType": "Broadband",
        "asn": {
          "number": 14061,
          "org": "DigitalOcean LLC",
          "code": "AS14061 - DigitalOcean LLC"
        }
      },
      "locale": {
        "currency": {
          "code": "USD",
          "name": "US Dollar"
        },
        "language": {
          "code": "en",
          "name": "English"
        }
      },
      "device": {
        "platform": "MacIntel",
        "memory": 16,
        "screen": {
          "width": 2560,
          "height": 1440
        }
      },
      "browser": {
        "codeName": "Mozilla",
        "language": "en-US",
        "engine": "Blink",
        "version": "5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
        "online": true
      },
      "session": {
        "success": true,
        "dateTime": "4/12/2025, 3:45:22 PM",
        "createdAt": "2025-04-12T15:45:22.000Z"
      }
    },
    "...rest"
  ]
}

GET/api/public/heatmap

Day-by-day hit map for a hostname in a given year, plus current-year and all-time totals.

Query Parameters

hostnamerequired— e.g. siteviews.netlify.app

yearoptional— Defaults to current year

Example Request

https://siteviews.vercel.app/api/public/heatmap?hostname=siteviews.netlify.app&year=2025

Example Response

{
  "status": 200,
  "success": true,
  "message": "SiteViews heatmap retrieved successfully",
  "data": {
    "year": 2025,
    "current_year": 798,
    "all_time": 3085,
    "heatmap": [
      {
        "date": "2025-01-01",
        "count": 0
      },
      {
        "date": "2025-01-02",
        "count": 4
      },
      {
        "date": "2025-01-03",
        "count": 7
      },
      {
        "date": "2025-01-04",
        "count": 2
      },
      {
        "date": "...",
        "count": "..."
      }
    ]
  }
}

Public API

Alerts & Updates