Bruno API Collection
The Zenovay Bruno collection is a free, open-source set of pre-configured requests for every public External API endpoint. Bruno stores requests as plain .bru files in a folder you check into git — nothing leaves your machine.
Bruno is the open-source alternative to Postman: no cloud account, no telemetry, no per-seat pricing.
Download
curl -O https://docs.zenovay.com/downloads/bruno-zenovay-collection.zip
unzip bruno-zenovay-collection.zip
# Open the bruno-zenovay-collection/ directory in the Bruno desktop app.Or grab it directly: bruno-zenovay-collection.zip (~16 KB).
What's inside
The collection contains 16 ready-to-run requests across these categories:
| Category | Requests |
|---|---|
| Account | GET /usage |
| Websites | GET /websites, GET /websites/:id |
| Analytics | GET /analytics/:id, /visitors, /pages, /countries, /technology |
| Pro features | GET /heatmaps/:id/pages, /replays/:id/sessions, /errors/:id/groups |
| Insights | GET /insights/:id, /anomalies/:id, /retention/:id, /revenue/:id/ltv |
| Query Studio | POST /query/:id |
Each request comes with:
- The full URL pre-filled with
{{baseUrl}} - The correct
X-API-Keyheader pulled from environment - A description of every query parameter
- An example response in the documentation tab
Setup (60 seconds)
- Install Bruno — usebruno.com/downloads (macOS, Windows, Linux).
- Open the collection — File → Open Collection → select the unzipped
bruno-zenovay-collection/folder. - Pick the environment — top-right dropdown → choose production (defaults to
https://api.zenovay.com/api/external/v1). - Add your API key — open the environment, set
apiKeyto a key from app.zenovay.com → Settings → API Keys.
That's it. Click any request and hit Send.
Your API key never commits. Bruno stores environment values in .env-style files under environments/ — the collection's .gitignore excludes them. The committed file (environments/production.bru) only contains the variable names, not the secrets.
Why Bruno over Postman?
- Local-first — no cloud sync, no team account required
- Git-native —
.brufiles diff cleanly in PRs - No telemetry — nothing phones home
- Free for teams — no per-seat pricing on shared collections
If you already use Postman, the OpenAPI spec at api.zenovay.com/openapi.json imports cleanly there too. See the OpenAPI spec page.
Source
The collection lives in the public api-zenovay repo under bruno/. Open issues or PRs there if you spot a request that's missing or out of date.
Related
- API Getting Started — make your first API call from the command line
- Authentication — how API keys + permission levels work
- Rate Limits — per-tier quotas and headers
- API Playground — interactive in-browser testing