API Overview

Access your analytics data programmatically with Databuddy's REST API. Most endpoints require authentication and are rate-limited for security. Public exceptions: /health, GET /v1/query/types, the public feature-flag routes under /public/v1/flags/*, and the /.well-known/* discovery routes.

Base URLs

Quick Start

1. Get your API key from Dashboard → Organization Settings → API Keys

2. List your websites:

curl -H "x-api-key: dbdy_your_api_key" \
https://api.databuddy.cc/v1/query/websites

3. Query analytics data:

curl -X POST -H "x-api-key: dbdy_your_api_key" \
-H "Content-Type: application/json" \
-d '{
  "parameters": ["summary_metrics", "top_pages"],
  "preset": "last_30d"
}' \
"https://api.databuddy.cc/v1/query?website_id=web_123"

Use date presets like last_7d, last_30d, this_month instead of explicit dates for convenience.

API Sections

Available Query Types

Website Analytics

Query types for website_id:

This is a subset. Use GET /v1/query/types for the full list.

Link Shortener Analytics

Query types for link_id:

Health Check

Check API availability:

GET /health

{
"status": "ok"
}