Skip to main content

Connect Microsoft Clarity

This article covers how to connect Microsoft Clarity to a Client in AgencyAnalytics, as well as how its data warehousing and rate limits work.

Written by AgencyAnalytics Team

Microsoft Clarity Overview

Microsoft Clarity is a free, AI-powered user behavior analytics tool. It helps website owners understand how visitors interact with their site through session recordings, heat maps, and AI-driven insights. Once connected to AgencyAnalytics, you can add Microsoft Clarity data to your Client dashboards and reports.

  • Uses Clarity API V1

  • The Clarity API only returns the previous day's data, so the data will always be 1 day behind


Before You Start

To connect to Microsoft Clarity without errors, you'll need the Microsoft Clarity API token for the relevant Client.


Connect Microsoft Clarity

You'll need to first grab an API token from Microsoft Clarity, then paste it into AgencyAnalytics.

Get the API Token from Microsoft Clarity

Step 1: Open the Microsoft Clarity native dashboard for the specific Client.

Step 2: Click Project Settings, then Setup, then Data Export.

Step 3: Copy the listed API Token.

Connect Microsoft Clarity in AgencyAnalytics

Step 1: Open the Client where you'd like to connect Microsoft Clarity.

Step 2: Click the Data tab in the top navigation bar.

Step 3: Click + Connect Source in the upper-right corner.

Step 4: Search for Microsoft Clarity in the search bar at the top, then click the Microsoft Clarity card.

Step 5: Paste in the API token, then click Save.

Once connected, you can add Microsoft Clarity data to your Client dashboards and reports.

Note: Data values may differ from the Microsoft Clarity dashboard due to differences in how bots are filtered by the API.


FAQ

Why can't I see any historical data for Microsoft Clarity?

The Microsoft Clarity API has a 24-hour look-back period, so it only provides yesterday's data. AgencyAnalytics warehouses this data for you, so each day the available historical data increases by 24 hours.

Example:

  • Jaime connects Microsoft Clarity to a Client at 9 am on June 1st

  • They review the data in AgencyAnalytics. Data from the day before, May 31st, is available

  • Jaime checks back on June 8th. They find complete data from May 31st through June 7th available

Why am I getting a usage-limit error when I try to view data?

Microsoft Clarity has a hard-coded rate limit of 10 requests per day, per project. If you're seeing a usage-limit error, it means you've exceeded the 10 requests for the day and must wait for the limit to reset.

Note: Refreshing data from all three dimensions (OS / Source / Channel) will consume 3 of the 10 available daily requests.


💬 Need additional help?

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄

Did this answer your question?