Skip to content

Analytics API

Tracify's Analytics API allows you to query attribution and metrics data from your account. We've made available several endpoints at different levels of granularity to help you get the data you need.

This API is currently in --Beta--.

We're actively working to improve it, and your feedback is welcome.

Generating an API Token

To use the Analytics API, you'll need to generate an API token. You can do this by making a request to our login endpoint using a Tracify user account. The user account must have access to the site you want to query. Tokens are valid for 24 hours, so if you're buidling a long-running application you'll need to renew your token regularly.

The login endpoint is https://hive2.tracify.ai/v1/tracify/api/account/login. It takes two parameters:

  • email: your Tracify user email address
  • password: your Tracify user password, hashed with SHA-256

Note: If you would prefer to use a service account please request one from your account manager.

Important

Do not send your password to the login endpoint in plain text.

CURL Example:

curl -X POST https://hive2.tracify.ai/v1/tracify/api/account/login \
-H "Content-Type: application/json" \
-d '{"email": "your_email_address", "password": "sha265_hash_of_your_password"}'

Response structure:

{"result":{"session":"very-long-tracify-token"},"success":true}

Use the session value in the response to make subsequent requests to the Analytics API.

Using Swagger

You can use the swagger UI below to explore the endpoints and parameters.

  • Press the "Authorize" button to, and save your API token
  • Expand each endpoint to see the parameters and responses
  • Click the "Try it out" button to test the endpoint