# Agent Analytics API API

**Canonical:** https://apis.io/apis/agentanalytics-sh/agent-analytics-api-api/  
**Provider:** Agent Analytics — https://apis.io/providers/agentanalytics-sh/  
**Base URL:** https://api.agentanalytics.sh  
**Documentation:** https://docs.agentanalytics.sh/llms.txt

Agent Analytics API API is one of 2 APIs that [Agent Analytics](https://apis.io/providers/agentanalytics-sh/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Web analytics platform with an HTTP API that AI agents can query.

## Operations (60 of 67)

| Method | Path | Summary |
|---|---|---|
| POST | `/agent-sessions/start` | Start an agent-session signup/login flow |
| GET | `/agent-sessions/authorize/{id}` | Browser approval page for an auth request |
| POST | `/agent-sessions/poll` | Poll detached auth status |
| POST | `/agent-sessions/exchange` | Exchange an approved auth request for an agent session |
| POST | `/agent-sessions/refresh` | Refresh an agent session access token |
| POST | `/agent-sessions/revoke` | Revoke an agent session |
| POST | `/track` | Track a single event |
| POST | `/track/batch` | Track multiple events |
| POST | `/identify` | Link anonymous user to authenticated identity |
| GET | `/stats` | Aggregated stats overview |
| GET | `/events` | Raw event log |
| POST | `/events` | Raw event log by user ID or email lookup |
| POST | `/journey` | Customer journey by user ID or email lookup |
| POST | `/query` | Flexible analytics query |
| GET | `/properties` | Discover event names and property keys |
| GET | `/properties/received` | Property keys by event name |
| GET | `/replays/settings` | Get project replay settings |
| PUT | `/replays/settings` | Enable, disable, or update project replay settings |
| GET | `/replays` | List replay metadata |
| DELETE | `/replays` | Disable and delete replay data |
| GET | `/replays/usage` | Get replay storage and ingestion usage |
| GET | `/replays/{replayId}` | Get replay metadata and committed chunks |
| DELETE | `/replays/{replayId}` | Delete one replay |
| POST | `/replays/{replayId}/open` | Create a short-lived sandboxed viewer link |
| GET | `/sessions` | List sessions |
| GET | `/breakdown` | Top property values |
| GET | `/insights` | Period-over-period comparison |
| GET | `/pages` | Entry/exit page stats |
| GET | `/sessions/distribution` | Session duration histogram |
| POST | `/paths` | Bounded session path analysis |
| GET | `/heatmap` | Day-of-week x hour traffic grid |
| POST | `/funnel` | Funnel analysis |
| GET | `/retention` | Cohort retention analysis |
| GET | `/stream` | Live event stream (SSE) |
| GET | `/live` | Live snapshot (real-time) |
| POST | `/website-scans` | Create public landing-page website analysis preview |
| POST | `/cli/website-scans` | Create authenticated npx website analysis |
| GET | `/website-scans/{id}` | Resume a website analysis |
| GET | `/project-context` | Get project analytics context |
| PUT | `/project-context` | Set project analytics context |
| GET | `/portfolio-context` | Get account portfolio context |
| PUT | `/portfolio-context` | Set account portfolio context |
| GET | `/portfolios` | List identity lookup portfolios |
| POST | `/portfolios` | Create an identity lookup portfolio |
| GET | `/portfolios/{idOrSlug}` | Get an identity lookup portfolio |
| PATCH | `/portfolios/{idOrSlug}` | Update an identity lookup portfolio |
| DELETE | `/portfolios/{idOrSlug}` | Delete an empty identity lookup portfolio |
| 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 |
| GET | `/account` | Get account info |
| GET | `/bot-traffic` | Filtered automated traffic for one project |
| GET | `/account/usage` | Read account usage, pricing, and human payment handoff |
| GET | `/account/all-sites` | Historical all-sites overview |
| GET | `/account/bot-traffic` | Filtered automated traffic across all active projects |
| GET | `/account/agent-sessions` | List active and historical agent sessions for the account |
| POST | `/account/revoke-key` | Revoke and regenerate API key |
| POST | `/account/feedback` | Submit product or workflow feedback |

…and 7 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agentanalytics-sh/openapi/_original/agentanalytics-sh-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agentanalytics-sh/json-schema/agentanalytics-sh-payment-handoff-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentanalytics-sh/json-schema/agentanalytics-sh-query-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentanalytics-sh/json-schema/agentanalytics-sh-stats-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentanalytics-sh/json-schema/agentanalytics-sh-funnel-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentanalytics-sh/json-schema/agentanalytics-sh-funnel-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentanalytics-sh/json-schema/agentanalytics-sh-track-request-schema.json

## Other Agent Analytics APIs (1)

- [Agent Analytics API](https://apis.io/apis/agentanalytics-sh/agent-analytics-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentanalytics-sh/agent-analytics-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentanalytics-sh/.