Agent Analytics API
API version: 1.0.0
Auth
ApiKey X-API-Key in header | ApiKey token in query
Base URL
https://api.agentanalytics.sh
Setup
- Set your API key in the appropriate header
- GET /stats -- verify access
- POST /track -- create first track
Endpoints
32 endpoints across 19 groups. See references/api-spec.lap for full details.
track
| Method |
Path |
Description |
| POST |
/track |
Track a single event |
| POST |
/track/batch |
Track multiple events |
stats
| Method |
Path |
Description |
| GET |
/stats |
Aggregated stats overview |
events
| Method |
Path |
Description |
| GET |
/events |
Raw event log |
query
| Method |
Path |
Description |
| POST |
/query |
Flexible analytics query |
properties
| Method |
Path |
Description |
| GET |
/properties |
Discover event names and property keys |
| GET |
/properties/received |
Property keys by event name |
sessions
| Method |
Path |
Description |
| GET |
/sessions |
List sessions |
| GET |
/sessions/distribution |
Session duration histogram |
breakdown
| Method |
Path |
Description |
| GET |
/breakdown |
Top property values |
insights
| Method |
Path |
Description |
| GET |
/insights |
Period-over-period comparison |
pages
| Method |
Path |
Description |
| GET |
/pages |
Entry/exit page stats |
heatmap
| Method |
Path |
Description |
| GET |
/heatmap |
Day-of-week x hour traffic grid |
funnel
| Method |
Path |
Description |
| POST |
/funnel |
Funnel analysis |
retention
| Method |
Path |
Description |
| GET |
/retention |
Cohort retention analysis |
stream
| Method |
Path |
Description |
| GET |
/stream |
Live event stream (SSE) |
live
| Method |
Path |
Description |
| GET |
/live |
Live snapshot (real-time) |
projects
| Method |
Path |
Description |
| GET |
/projects |
List all projects |
| POST |
/projects |
Create a new project |
| GET |
/projects/{id} |
Get project details |
| PATCH |
/projects/{id} |
Update a project |
| DELETE |
/projects/{id} |
Delete a project |
account
| Method |
Path |
Description |
| GET |
/account |
Get account info |
| POST |
/account/revoke-key |
Revoke and regenerate API key |
experiments
| Method |
Path |
Description |
| GET |
/experiments/config |
Get experiment config for tracker.js |
| POST |
/experiments |
Create an A/B experiment |
| GET |
/experiments |
List experiments |
| GET |
/experiments/{id} |
Get experiment with live results |
| PATCH |
/experiments/{id} |
Update experiment status |
| DELETE |
/experiments/{id} |
Delete an experiment |
health
| Method |
Path |
Description |
| GET |
/health |
Health check |
tracker.js
| Method |
Path |
Description |
| GET |
/tracker.js |
JavaScript tracker script |
Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "Create a track?" -> POST /track
- "Create a batch?" -> POST /track/batch
- "List all stats?" -> GET /stats
- "List all events?" -> GET /events
- "Create a query?" -> POST /query
- "List all properties?" -> GET /properties
- "List all received?" -> GET /properties/received
- "List all sessions?" -> GET /sessions
- "List all breakdown?" -> GET /breakdown
- "List all insights?" -> GET /insights
- "List all pages?" -> GET /pages
- "List all distribution?" -> GET /sessions/distribution
- "List all heatmap?" -> GET /heatmap
- "Create a funnel?" -> POST /funnel
- "List all retention?" -> GET /retention
- "List all stream?" -> GET /stream
- "List all live?" -> GET /live
- "List all projects?" -> GET /projects
- "Create a project?" -> POST /projects
- "Get project details?" -> GET /projects/{id}
- "Partially update a project?" -> PATCH /projects/{id}
- "Delete a project?" -> DELETE /projects/{id}
- "List all account?" -> GET /account
- "Create a revoke-key?" -> POST /account/revoke-key
- "List all config?" -> GET /experiments/config
- "Create a experiment?" -> POST /experiments
- "List all experiments?" -> GET /experiments
- "Get experiment details?" -> GET /experiments/{id}
- "Partially update a experiment?" -> PATCH /experiments/{id}
- "Delete a experiment?" -> DELETE /experiments/{id}
- "List all health?" -> GET /health
- "List all tracker.js?" -> GET /tracker.js
- "How to authenticate?" -> See Auth section
Response Tips
- Check response schemas in references/api-spec.lap for field details
- List endpoints may support pagination; check for limit, offset, or cursor params
- Create/update endpoints typically return the created/updated object
CLI
# Update this spec to the latest version
npx @lap-platform/lapsh get agent-analytics-api -o references/api-spec.lap
# Search for related APIs
npx @lap-platform/lapsh search agent-analytics-api
References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas
Generated from the official API spec by LAP