Harvv API

Access your behavioral analytics data programmatically. Use with the Claude Code plugin or build your own integrations.

Authentication

All requests require an API key in the Authorization header:

Authorization: Bearer hv_live_your_api_key_here

Create API keys at harvv.com → Settings → API Keys.

Endpoints

GET /v1/sites

List all your sites.

curl -H "Authorization: Bearer hv_live_xxx" https://harvv.com/v1/sites

GET /v1/sites/:id/stats

Get site analytics (sessions, visitors, dead clicks, rage clicks).

Param	Description
period	7d (default), 30d, or today

curl -H "Authorization: Bearer hv_live_xxx" "https://harvv.com/v1/sites/SITE_ID/stats?period=30d"

GET /v1/sites/:id/issues

Get detected UX issues with descriptions, severity, and fix suggestions.

Param	Description
status	Filter: open, quoted, approved, fixing, in_qa, resolved, dismissed

curl -H "Authorization: Bearer hv_live_xxx" "https://harvv.com/v1/sites/SITE_ID/issues?status=open"

GET /v1/sites/:id/issues/:issue_id

Get full details for a specific issue including fix suggestion.

curl -H "Authorization: Bearer hv_live_xxx" "https://harvv.com/v1/sites/SITE_ID/issues/123"

GET /v1/sites/:id/friction

Get top friction elements (dead clicks + rage clicks by element and page section).

Param	Description
period	7d (default) or 30d

curl -H "Authorization: Bearer hv_live_xxx" "https://harvv.com/v1/sites/SITE_ID/friction?period=30d"

POST /customer/api-keys

Create a new API key (requires JWT auth, not API key).

curl -X POST -H "Authorization: Bearer JWT_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"My Integration"}' https://harvv.com/customer/api-keys

Claude Code Plugin

Install Harvv directly in Claude Code:

/plugin install github:harvv/claude-plugin

Then use:

Command	What it does
`/harvv:install`	Install pixel into your project
`/harvv:issues`	See detected UX issues
`/harvv:fix 123`	Apply AI fix for issue #123
`/harvv:why`	Full conversion diagnosis

Rate Limits

Endpoint	Limit
/v1/*	60 requests/minute