Skip to content
/ vaas Public

VAAS: The Vercel Analytics API Scraper, now featuring Vercel Speed Insights.

Notifications You must be signed in to change notification settings

versecafe/vaas

Repository files navigation

VAAS

Retrieving your Vercel Analytics data for external use has never been easier.

image image

Get back data in your prefered format

JSON CSV YAML XML TOML
[
  {
    "key": "2024-03-24",
    "views": 32,
    "visitors": 24
  },
  {
    "key": "2024-03-25",
    "views": 183,
    "visitors": 72
  },
  {
    "key": "2024-03-26",
    "views": 569,
    "visitors": 216
  }
]
key,total,devices

2024-03-24,32,24
2024-03-25,183,72
2024-03-26,569,216
dataset:
  - key: 2024-03-24
    total: 32
    devices: 24
  - key: 2024-03-25
    total: 183
    devices: 72
  - key: 2024-03-26
    total: 569
    devices: 216
<?xml version="1.0" encoding="UTF-8"?>
<dataset>
  <data>
    <key>2024-03-24</key>
    <total>32</total>
    <devices>24</devices>
  </data>
  <data>
    <key>2024-03-25</key>
    <total>183</total>
    <devices>72</devices>
  </data>
  <data>
    <key>2024-03-26</key>
    <total>569</total>
    <devices>216</devices>
  </data>
</dataset>
[[data]]
key = "2024-03-24"
total = 32
devices = 24

[[data]]
key = "2024-03-25"
total = 183
devices = 72

[[data]]
key = "2024-03-26"
total = 569
devices = 216

Filters

Basic Filter Options

{"path":{"values":["/path/to/page"],"operator":"eq"}}
{ "referrer": { "values": ["https://duckduckgo.com"], "operator": "eq" } }
{ "country": { "values": ["US"], "operator": "eq" } }
{ "device": { "values": ["Desktop"], "operator": "eq" } }
{ "os": { "values": ["Mac"], "operator": "eq" } }
{ "browser": { "values": ["Chrome"], "operator": "eq" } }
{ "event_name": { "values": ["Event"], "operator": "eq" } }
{ "event_data": { "properties": { "quiz": "Property Name" }, "operator": "eq" }

Building advanced filter queries

{ "event_name": { "values": ["Test Submission"], "operator": "eq" } }

Filter further by specific event properties

{
  "event_name": { "values": ["Test Submission"], "operator": "eq" },
  "event_data": {
    "properties": { "quiz": "MV2G Intelligence Assessment" },
    "operator": "eq"
  }
}

Add external filter such as Nation

{
  "event_name": { "values": ["Test Submission"], "operator": "eq" },
  "event_data": {
    "properties": { "quiz": "MV2G Intelligence Assessment" },
    "operator": "eq"
  },
  "country": { "values": ["US"], "operator": "eq" }
}

Run it yourself

Vaas has no env vars, so all you need to do is clone the repo and run the following commands:

bun i && bun dev

About

VAAS: The Vercel Analytics API Scraper, now featuring Vercel Speed Insights.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published