# 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/reports
POST /queries/metrics
GET /reports
```

### People Search

Find users by behavior, properties, or segments. Get counts or full user lists.

```
POST /queries/people
POST /queries/people/count
```

### SQL Queries

Run custom SQL against your KISSmetrics data for advanced analysis.

```
POST /queries/sql
```

### Data Export

Export query results to CSV or directly to your S3 bucket.

```
POST /exports/csv
POST /exports/s3
GET /exports/{id}/status
```

### Account Data

List all events, properties, reports, and metrics in your account.

```
GET /events
GET /properties
GET /products
```

### A/B Test Analysis

Get statistical analysis of your experiments with confidence intervals.

```
POST /queries/ab-test
```

## Common 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 HTTP Basic authentication. Use your API key as the username with an empty password.

```
Authorization: Basic BASE64(YOUR_API_KEY:)
```

### Rate Limits

API requests are rate limited to ensure platform stability. Standard limits apply to all plans.

- • 15 requests per minute
- • Higher limits available on request

## Ready to build?

Full API access included with every plan. No extra fees.