REST API
Full programmatic access to your data. Query reports, export segments, and build custom integrations with our comprehensive API.
What You Can Do
The API gives you access to everything in KISSmetrics - reports, users, events, and exports.
Query Reports
Execute any report type programmatically - funnels, cohorts, revenue, A/B tests, and more.
POST /queries/reportsPOST /queries/metricsGET /reportsPeople Search
Find users by behavior, properties, or segments. Get counts or full user lists.
POST /queries/peoplePOST /queries/people/countSQL Queries
Run custom SQL against your KISSmetrics data for advanced analysis.
POST /queries/sqlData Export
Export query results to CSV or directly to your S3 bucket.
POST /exports/csvPOST /exports/s3GET /exports/{id}/statusAccount Data
List all events, properties, reports, and metrics in your account.
GET /eventsGET /propertiesGET /productsA/B Test Analysis
Get statistical analysis of your experiments with confidence intervals.
POST /queries/ab-testSimple to Use
RESTful endpoints with JSON responses. Works with any language or platform.
// Query a funnel report
const response = await fetch('https://api.kissmetrics.io/v1/queries/reports', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
report_id: 'funnel_123',
date_range: {
start: '2024-01-01',
end: '2024-01-31'
},
filters: {
property: 'plan',
operator: 'equals',
value: 'premium'
}
})
});
const data = await response.json();
// Returns funnel steps with conversion ratesCommon Use Cases
See how teams use the API to extend KISSmetrics.
Automated Reporting
Pull report data into your dashboards, spreadsheets, or BI tools on a schedule.
Example:
Fetch weekly funnel metrics and push to a Google Sheet every Monday.
Custom Dashboards
Build internal dashboards that combine KISSmetrics data with other sources.
Example:
Display real-time conversion rates alongside support ticket volume.
Segment Sync
Export user segments and sync them to tools without native integrations.
Example:
Push high-value users to a custom ad audience daily.
Data Warehouse
Feed processed analytics into your data warehouse for cross-platform analysis.
Example:
Export cohort data to Snowflake for joining with financial data.
Alerting
Build custom alerts based on metric thresholds or anomalies.
Example:
Slack notification when conversion rate drops below 3%.
Internal Tools
Power internal apps with real-time user data and insights.
Example:
Show customer health scores in your account management tool.
Authentication
API access uses Bearer token authentication. Generate API keys in your account settings.
Authorization: Bearer YOUR_API_KEYRate Limits
API requests are rate limited to ensure platform stability. Standard limits apply to all plans.
- • 100 requests per minute
- • 10,000 requests per day
- • Higher limits available on request
Ready to build?
Full API access included with every plan. No extra fees.