Skip to main content

Overview

The Analytics API allows you to send both client-side and server-side events into Unify. There are three types of events you can send:
  • Page events capture page visits on your website or web application
  • Track events capture actions or other custom activities that you define
  • Identify events capture visitor identity information (e.g., their email address)
These event types form the building blocks to track visitor behavior and actions on your marketing website, web application, or other custom software.

Usage

Request format

The base URL for all API requests to the Analytics API is:
https://api.unifyintent.com/analytics/v1
Note that the base URL uses a different domain than other Unify APIs.

Authentication

When sending requests to the Analytics API from client devices, you should use your write key rather than an API key. Write keys are safe to expose publicly whereas API keys are not.To prevent exposure of sensitive API keys, if you send a request to the Analytics API that contains an API key by accident, Unify will immediately expire the key as a precautionary measure.
Write keys are used to authenticate requests to the Analytics API. You can find your write key in Unify by navigating to Settings -> Unify Intent Client. To authenticate a request, include the following header in your request:
X-Write-Key: <token>
Replace <token> with your Unify write key.

Rate limits

The Analytics API is rate-limited by default to 100,000 requests per five minute window. We are able to provide higher limits upon request if needed.

OpenAPI specification

The OpenAPI specification can be found here.
I