Microsoft Clarity Data Export API
Project live insights data export
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-clarity-data-export-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Microsoft Clarity Data Export API
description: 'The Microsoft Clarity Data Export API lets project admins download
dashboard insights programmatically. Returns JSON for the last 1-3
days, broken down by up to three dimensions (Browser, Device,
Country/Region, OS, Source, Medium, Campaign, Channel, URL).
Authentication is via a Bearer JWT API token generated in the
Clarity project settings. Max 10 requests per project per day;
responses limited to 1000 rows and not paginated.'
version: v1
contact:
name: Kin Lane
email: kin@apievangelist.com
license:
name: Microsoft Terms of Use
url: https://www.microsoft.com/en-us/legal/terms-of-use
servers:
- url: https://www.clarity.ms
description: Microsoft Clarity production
security:
- bearer_token: []
tags:
- name: Data Export
description: Project live insights data export
paths:
/export-data/api/v1/project-live-insights:
get:
tags:
- Data Export
summary: Fetch project live insights
description: 'Fetches dashboard data for a Clarity project over the last 1, 2,
or 3 days, broken down by up to three dimensions. Returns
metrics including Traffic, Engagement Time, Scroll Depth,
Popular Pages, Browser, Device, OS, Country/Region, Page Title,
Referrer URL, Dead Click Count, Excessive Scroll, Rage Click
Count, Quickback Click, Script Error Count, and Error Click
Count.'
operationId: getProjectLiveInsights
parameters:
- name: numOfDays
in: query
required: true
description: Number of days for export (1, 2, or 3)
schema:
type: integer
enum:
- 1
- 2
- 3
- name: dimension1
in: query
schema:
type: string
enum:
- Browser
- Device
- Country/Region
- OS
- Source
- Medium
- Campaign
- Channel
- URL
- name: dimension2
in: query
schema:
type: string
enum:
- Browser
- Device
- Country/Region
- OS
- Source
- Medium
- Campaign
- Channel
- URL
- name: dimension3
in: query
schema:
type: string
enum:
- Browser
- Device
- Country/Region
- OS
- Source
- Medium
- Campaign
- Channel
- URL
responses:
'200':
description: Insights data
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/MetricEntry'
'400':
description: Bad request - invalid request parameters
'401':
description: Unauthorized - missing, invalid, or expired token
'403':
description: Forbidden - token not authorized for operation
'429':
description: Too Many Requests - exceeded daily limit (10/project/day)
components:
schemas:
MetricEntry:
type: object
properties:
metricName:
type: string
example: Traffic
information:
type: array
items:
type: object
additionalProperties: true
securitySchemes:
bearer_token:
type: http
scheme: bearer
bearerFormat: JWT
description: API access token generated by the project admin from the Clarity settings page