3a85964305
New tools across 13 categories: - Email/Newsletter: beehiiv, klaviyo, postmark, brevo, activecampaign - Data Enrichment: clearbit, apollo - CRO/Testing: hotjar, optimizely - Analytics: plausible - Scheduling: calendly, savvycal - Forms: typeform - Messaging: intercom - Social: buffer - Video: wistia - Payments: paddle - Affiliate: partnerstack - Reviews: trustpilot, g2 - Push: onesignal - Webinar: demio, livestorm Each tool includes a zero-dependency CLI and integration guide. Registry and CLI README updated with all new entries. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
147 lines
3.2 KiB
Markdown
147 lines
3.2 KiB
Markdown
# Hotjar
|
|
|
|
Behavior analytics platform with heatmaps, session recordings, and surveys for understanding user experience.
|
|
|
|
## Capabilities
|
|
|
|
| Integration | Available | Notes |
|
|
|-------------|-----------|-------|
|
|
| API | ✓ | Surveys, Responses, Sites, Heatmaps, Recordings |
|
|
| MCP | - | Not available |
|
|
| CLI | ✓ | [hotjar.js](../clis/hotjar.js) |
|
|
| SDK | ✓ | JavaScript tracking snippet, Identify API, Events API |
|
|
|
|
## Authentication
|
|
|
|
- **Type**: OAuth 2.0 Client Credentials
|
|
- **Token endpoint**: `POST https://api.hotjar.io/v1/oauth/token`
|
|
- **Header**: `Authorization: Bearer {access_token}`
|
|
- **Get credentials**: Hotjar Dashboard > Integrations > API
|
|
- **Token expiry**: 3600 seconds (1 hour)
|
|
|
|
### Token Request
|
|
|
|
```bash
|
|
POST https://api.hotjar.io/v1/oauth/token
|
|
Content-Type: application/x-www-form-urlencoded
|
|
|
|
grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}
|
|
```
|
|
|
|
### Token Response
|
|
|
|
```json
|
|
{
|
|
"access_token": "<token>",
|
|
"token_type": "Bearer",
|
|
"expires_in": 3600
|
|
}
|
|
```
|
|
|
|
## Common Agent Operations
|
|
|
|
### List Sites
|
|
|
|
```bash
|
|
GET https://api.hotjar.io/v1/sites
|
|
|
|
Authorization: Bearer {access_token}
|
|
```
|
|
|
|
### List Surveys
|
|
|
|
```bash
|
|
GET https://api.hotjar.io/v1/sites/{site_id}/surveys
|
|
|
|
Authorization: Bearer {access_token}
|
|
```
|
|
|
|
### Get Survey Responses
|
|
|
|
```bash
|
|
GET https://api.hotjar.io/v1/sites/{site_id}/surveys/{survey_id}/responses?limit=100
|
|
|
|
Authorization: Bearer {access_token}
|
|
```
|
|
|
|
Supports cursor-based pagination with `cursor` and `limit` parameters.
|
|
|
|
### List Heatmaps
|
|
|
|
```bash
|
|
GET https://api.hotjar.io/v1/sites/{site_id}/heatmaps
|
|
|
|
Authorization: Bearer {access_token}
|
|
```
|
|
|
|
### List Recordings
|
|
|
|
```bash
|
|
GET https://api.hotjar.io/v1/sites/{site_id}/recordings
|
|
|
|
Authorization: Bearer {access_token}
|
|
```
|
|
|
|
### List Forms
|
|
|
|
```bash
|
|
GET https://api.hotjar.io/v1/sites/{site_id}/forms
|
|
|
|
Authorization: Bearer {access_token}
|
|
```
|
|
|
|
## Key Metrics
|
|
|
|
### Survey Response Data
|
|
- `response_id` - Unique response identifier
|
|
- `answers` - Array of question/answer pairs
|
|
- `created_at` - Response timestamp
|
|
- `device_type` - Desktop, mobile, tablet
|
|
|
|
### Heatmap Data
|
|
- `url` - Page URL
|
|
- `click_count` - Total clicks tracked
|
|
- `visitors` - Unique visitors
|
|
- `created_at` - Heatmap creation date
|
|
|
|
### Recording Data
|
|
- `recording_id` - Unique recording ID
|
|
- `duration` - Session duration
|
|
- `pages_visited` - Pages in session
|
|
- `device` - Device information
|
|
|
|
## Parameters
|
|
|
|
### Survey Responses
|
|
- `limit` - Results per page (default: 100)
|
|
- `cursor` - Pagination cursor from previous response
|
|
- `sort` - Sort order (default: created_at desc)
|
|
|
|
### Recordings
|
|
- `limit` - Results per page
|
|
- `cursor` - Pagination cursor
|
|
- `date_from` - Start date filter
|
|
- `date_to` - End date filter
|
|
|
|
## When to Use
|
|
|
|
- Analyzing user behavior patterns on landing pages
|
|
- Collecting qualitative feedback via on-site surveys
|
|
- Identifying UX issues through session recordings
|
|
- Understanding scroll depth and engagement via heatmaps
|
|
- Validating CRO hypotheses with user behavior data
|
|
- Form abandonment analysis
|
|
|
|
## Rate Limits
|
|
|
|
- 3000 requests/minute (50 per second)
|
|
- Rate limited by source IP address
|
|
- Cursor-based pagination for large result sets
|
|
|
|
## Relevant Skills
|
|
|
|
- page-cro
|
|
- ab-test-setup
|
|
- analytics-tracking
|
|
- ux-audit
|
|
- landing-page
|