hotjar website screenshot

hotjar

Hotjar is a behavior analytics and user feedback platform that helps businesses understand how users interact with their website through heatmaps, session recordings, surveys, and feedback widgets.

hotjar publishes 4 APIs on the APIs.io network, including Authentication API, Survey Responses API, Surveys API, and 1 more.

The hotjar catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

hotjar’s developer surface includes authentication and 7 more developer resources.

41.3/100 thin ▬ flat Agent 38/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
7 APIs 16 Features

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 41.3/100 · thin
Contract Quality 16.5 / 25
Developer Ergonomics 2.2 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 2.7 / 13
Governance 7.0 / 12
Discoverability 5.0 / 10
Agent readiness — 38/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/hotjar: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 7

Individual APIs this provider publishes, each with its own machine-readable definition.

Hotjar Events API

The Hotjar Events API is a client-side JavaScript API that allows developers to send custom events to Hotjar when specific actions take place on a website. These events can be u...

Hotjar Identify API

The Hotjar Identify API is a client-side JavaScript API that allows developers to pass user data to Hotjar, saving it as User Attributes. These attributes enable advanced filter...

Hotjar JavaScript SDK

The Hotjar JavaScript SDK (@hotjar/browser) is an npm package that provides a programmatic interface for integrating Hotjar directly into JavaScript applications. It allows deve...

hotjar Authentication API

OAuth 2.0 client credentials authentication endpoints for obtaining access tokens.

hotjar Survey Responses API

Endpoints for exporting and listing survey response data with cursor-based pagination.

hotjar Surveys API

Endpoints for listing surveys and retrieving survey details for a specific site.

hotjar User Lookup API

Endpoints for looking up user data and submitting deletion requests for GDPR compliance.

Scroll for all 7

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Hotjar REST API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Hotjar Plans Pricing

6 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Hotjar Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 16

Notable capabilities this provider offers.

Free: 5,000 monthly sessions on new Contentsquare platform
Growth: $49/month annual
Legacy Observe Plus $32/mo (100 daily sessions)
Legacy Observe Business $80/mo (500 daily sessions)
Legacy Observe Scale $171/mo
Pro / Enterprise: custom pricing
Heatmaps (click, scroll, move)
Session replay (anonymized)
Surveys and feedback widgets
Funnels and conversion tracking
Engage product for moderated user interviews
Insights API at insights.hotjar.com
OAuth + API tokens
Webhooks via Insights
Privacy controls (PII masking, IP suppression)
Migration to unified Contentsquare platform through 2026

Scroll for all 16

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Hotjar Context

0 classes · 7 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

hotjar API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 13

Standalone JSON Schema definitions for this provider's data models.

Error

2 properties

JSON SCHEMA

OAuthToken

3 properties

JSON SCHEMA

Hotjar Survey Response

4 properties

JSON SCHEMA

Hotjar Survey

9 properties

JSON SCHEMA

SurveyAnswer

2 properties

JSON SCHEMA

SurveyListResponse

2 properties

JSON SCHEMA

SurveyQuestion

7 properties

JSON SCHEMA

SurveyResponse

4 properties

JSON SCHEMA

SurveyResponseListResponse

2 properties

JSON SCHEMA

SurveyResponseTag

1 properties

JSON SCHEMA

Hotjar User Lookup Request

3 properties

JSON SCHEMA

UserLookupRequest

3 properties

JSON SCHEMA

UserLookupResponse

2 properties

JSON SCHEMA

Scroll for all 13

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Hotjar Structure

0 properties

JSON STRUCTURE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Hotjar Authentication

http · 1 scheme

SECURITY

Hotjar Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Hotjar Agentic Access

5 operations · 2 acting

5 operations · 2 acting

AGENTIC

Resources

Documentation 3

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Access & Security 2

Authentication, authorization, and security posture

Company 1

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: hotjar
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/hotjar.png
url: https://raw.githubusercontent.com/api-evangelist/hotjar/refs/heads/main/apis.yml
apis:
- aid: hotjar:events-api
  name: Hotjar Events API
  tags:
  - Analytics
  - Events
  - Heatmaps
  - Recordings
  - Surveys
  - Tracking
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.example.com
  humanURL: https://help.hotjar.com/hc/en-us/articles/36819965075473-Events-API-Reference
  properties:
  - url: https://help.hotjar.com/hc/en-us/articles/36819965075473-Events-API-Reference
    type: Documentation
  description: The Hotjar Events API is a client-side JavaScript API that allows developers to send custom events to Hotjar
    when specific actions take place on a website. These events can be used to filter collected Recordings and Heatmap data,
    trigger session capture, and target Surveys to appear based on user behavior. Events are sent using the Hotjar tracking
    code and are available on all pages where the tracking snippet is installed.
- aid: hotjar:identify-api
  name: Hotjar Identify API
  tags:
  - Analytics
  - Attributes
  - Personalization
  - Segmentation
  - Users
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.example.com
  humanURL: https://help.hotjar.com/hc/en-us/articles/36820006120721-Identify-API-Reference
  properties:
  - url: https://help.hotjar.com/hc/en-us/articles/36820006120721-Identify-API-Reference
    type: Documentation
  description: The Hotjar Identify API is a client-side JavaScript API that allows developers to pass user data to Hotjar,
    saving it as User Attributes. These attributes enable advanced filtering and segmentation of Hotjar data such as Recordings,
    Heatmaps, and Surveys. The Identify API must be called before the Events API in the execution order. It is used via the
    Hotjar tracking code on pages where the JavaScript snippet is installed.
- aid: hotjar:javascript-sdk
  name: Hotjar JavaScript SDK
  tags:
  - Analytics
  - Browser
  - JavaScript
  - SDK
  - Tracking
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  baseURL: https://api.example.com
  humanURL: https://github.com/hotjar/hotjar-js
  properties:
  - url: https://github.com/hotjar/hotjar-js
    type: Documentation
  description: The Hotjar JavaScript SDK (@hotjar/browser) is an npm package that provides a programmatic interface for integrating
    Hotjar directly into JavaScript applications. It allows developers to initialize Hotjar with a site ID, identify users,
    and send custom events without manually embedding the tracking script. The SDK supports modern JavaScript frameworks including
    React, Vue, and Angular, and provides methods for all Hotjar client-side APIs including identify and event tracking.
- aid: hotjar:hotjar-authentication-api
  name: hotjar Authentication API
  description: OAuth 2.0 client credentials authentication endpoints for obtaining access tokens.
  humanURL: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
  baseURL: https://api.hotjar.com
  tags:
  - Authentication
  properties:
  - type: OpenAPI
    url: openapi/hotjar-authentication-api-openapi.yml
  - type: Documentation
    url: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
- aid: hotjar:hotjar-survey-responses-api
  name: hotjar Survey Responses API
  description: Endpoints for exporting and listing survey response data with cursor-based pagination.
  humanURL: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
  baseURL: https://api.hotjar.com
  tags:
  - Survey Responses
  properties:
  - type: OpenAPI
    url: openapi/hotjar-survey-responses-api-openapi.yml
  - type: Documentation
    url: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
- aid: hotjar:hotjar-surveys-api
  name: hotjar Surveys API
  description: Endpoints for listing surveys and retrieving survey details for a specific site.
  humanURL: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
  baseURL: https://api.hotjar.com
  tags:
  - Surveys
  properties:
  - type: OpenAPI
    url: openapi/hotjar-surveys-api-openapi.yml
  - type: Documentation
    url: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
- aid: hotjar:hotjar-user-lookup-api
  name: hotjar User Lookup API
  description: Endpoints for looking up user data and submitting deletion requests for GDPR compliance.
  humanURL: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
  baseURL: https://api.hotjar.com
  tags:
  - User Lookup
  properties:
  - type: OpenAPI
    url: openapi/hotjar-user-lookup-api-openapi.yml
  - type: Documentation
    url: https://help.hotjar.com/hc/en-us/articles/36820005914001-Hotjar-API-Reference
modified: '2026-05-19'
common:
- type: AgenticAccess
  url: agentic-access/hotjar-agentic-access.yml
- type: DomainSecurity
  url: security/hotjar-domain-security.yml
- type: Authentication
  url: authentication/hotjar-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/hotjar
- type: JSONLD
  url: json-ld/hotjar-context.jsonld
- type: JSONSchema
  url: json-schema/hotjar-survey-schema.json
- type: JSONSchema
  url: json-schema/hotjar-survey-response-schema.json
- type: JSONSchema
  url: json-schema/hotjar-user-lookup-schema.json
- type: Features
  data:
  - 'Free: 5,000 monthly sessions on new Contentsquare platform'
  - 'Growth: $49/month annual'
  - Legacy Observe Plus $32/mo (100 daily sessions)
  - Legacy Observe Business $80/mo (500 daily sessions)
  - Legacy Observe Scale $171/mo
  - 'Pro / Enterprise: custom pricing'
  - Heatmaps (click, scroll, move)
  - Session replay (anonymized)
  - Surveys and feedback widgets
  - Funnels and conversion tracking
  - Engage product for moderated user interviews
  - Insights API at insights.hotjar.com
  - OAuth + API tokens
  - Webhooks via Insights
  - Privacy controls (PII masking, IP suppression)
  - Migration to unified Contentsquare platform through 2026
  sources:
  - https://contentsquare.com/pricing/
  updated: '2026-05-04'
description: Hotjar is a behavior analytics and user feedback platform that helps businesses understand how users interact
  with their website through heatmaps, session recordings, surveys, and feedback widgets.