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