API clients / Go

Analytics API client

This client is new in v4 of the Go API clients.

The Analytics API client is part of the algoliasearch-client-go package. To install it, run:

Copy 
1

go get github.com/algolia/algoliasearch-client-go

To use the Analytics client, add this import to your files:

Copy 
1

import "github.com/algolia/algoliasearch-client-go/v4/algolia/analytics"

To create an instance of the client:

Copy 
1
2
3
4
5

client, err := analytics.NewClient("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", analytics.US)
if err != nil {
  // The client can fail to initialize if you pass an invalid parameter.
  panic(err)
}

Make sure to use the region that matches your Algolia application’s analytics region: analytics.US for the United States or analytics.DE for Europe. You can check your analytics region in the Infrastructure > Analytics section of the Algolia dashboard.

List of methods

Each method makes one request to the Analytics API.

Searches

client.GetTopSearches Retrieve top searches
client.GetSearchesCount Retrieve number of searches
client.GetSearchesNoResults Retrieve top searches without results
client.GetNoResultsRate Retrieve no results rate
client.GetTopHits Retrieve top search results

Clicks

client.GetSearchesNoClicks Retrieve top searches without clicks
client.GetNoClickRate Retrieve no click rate
client.GetAverageClickPosition Retrieve average click position
client.GetClickPositions Retrieve click positions
client.GetClickThroughRate Retrieve click-through rate
client.GetConversionRate Retrieve conversion rate
client.GetAddToCartRate Retrieve add-to-cart rate
client.GetPurchaseRate Retrieve purchase rate
client.GetRevenue Retrieve revenue data

Users

client.GetUsersCount Retrieve number of users
client.GetTopCountries Retrieve top countries

Filters

client.GetTopFilterAttributes Retrieve top filters
client.GetTopFilterForAttribute Retrieve top filter values
client.GetTopFiltersNoResults Retrieve top filters for a search without results

Status

client.GetStatus Retrieve update status
Did you find this page helpful?