Feature
Build Custom Dashboards with Our API
DataSaaS exposes your entire analytics dataset through a clean REST API. Build custom dashboards, automate reports, pipe data into your data warehouse, or integrate analytics into your internal tools.
Start free trialDataSaaS REST API documentation showing 27 endpoints for traffic, revenue, visitors, and funnels with bearer token authentication and JSON responses
27 Endpoints Covering All Analytics Data
The DataSaaS REST API gives you programmatic access to every report available in the dashboard and more. Query pageviews, visitors, sessions, traffic sources, revenue, funnels, and custom events. Each endpoint returns clean JSON with consistent response formats, making integration straightforward.
- Traffic endpoints: pageviews, visitors, sessions, bounce rate, and visit duration
- Source endpoints: referrers, UTM campaigns, channels, and search keywords
- Revenue endpoints: transactions, RPV by source, MRR trends, and top revenue sources
- Visitor endpoints: identified visitors, visitor profiles, and journey timelines
Bearer Token Authentication
Authenticate API requests with a bearer token generated from your dashboard. Each token is scoped to a specific website and can be revoked at any time. Tokens are transmitted over HTTPS only and never logged by the API server.
- Generate API tokens from Dashboard > Settings > API with one click
- Each token is scoped to a single website for security isolation
- Revoke tokens instantly if compromised — active sessions are terminated immediately
- All requests require HTTPS — plain HTTP requests are rejected
Rate Limiting and Pagination
The API enforces rate limits to ensure fair usage and consistent performance. Large result sets are automatically paginated with cursor-based pagination for efficient traversal. Rate limit headers are included in every response so your integration can handle throttling gracefully.
- Default rate limit of 60 requests per minute per token, with burst allowance
- Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) in every response
- Cursor-based pagination for efficient traversal of large datasets
- Configurable page size up to 1000 records per request
Filtering by Date Range and Dimension
Every endpoint accepts date range filters and dimension filters so you can query exactly the data you need. Filter by traffic source, country, device, browser, page path, or any combination. Date ranges support both absolute dates and relative shortcuts like 7d, 30d, and 90d.
- Date range filters: start_date and end_date in ISO 8601 format, or shortcuts like 7d and 30d
- Dimension filters: source, country, device, browser, os, page, and UTM parameters
- Combine multiple filters in a single request for precise data slicing
- Group-by parameter for creating custom breakdowns by any dimension
Frequently asked questions
How do I authenticate API requests?
Generate a bearer token from Dashboard > Settings > API. Include it in the Authorization header of every request as 'Bearer your_token_here'. Tokens are scoped to a single website and can be revoked at any time.
What are the rate limits?
The default rate limit is 60 requests per minute per token. Every response includes X-RateLimit-Remaining and X-RateLimit-Reset headers so your integration can handle throttling gracefully. Contact support if you need higher limits for production integrations.
Can I export data to my data warehouse?
Yes. Use the API to pull analytics data on a schedule and load it into your data warehouse, BI tool, or spreadsheet. The API returns clean JSON that maps directly to database tables. Many users run nightly scripts to sync data to BigQuery, Snowflake, or PostgreSQL.
Is there a client library or SDK?
The API is a standard REST API that works with any HTTP client. We do not provide official SDKs, but the endpoints return consistent JSON with standard HTTP status codes, so integrating with fetch, axios, or any language's HTTP library takes minutes.