Use the Usage Analytics Write API

This is for:

Developer
In this article

The usage analytics (UA) Write API service allows you to log all user interactions with search interfaces and, optionally, other interfaces, such as support case creation interfaces or your indexed web sites. You can then use UA reports to monitor the usage and adoption of your Coveo-powered implementation. Coveo Machine Learning (Coveo ML) models feed the UA events to continuously improve the relevance of your search results, query suggestions, and content recommendations.

Note

Search integrations with the Coveo Platform typically rely on the Coveo JavaScript Search Framework or the Atomic or Headless libraries rather than on the UA Write API (and other APIs) directly.

If, for some legitimate reason, you can’t use the Coveo JavaScript Search Framework or the Atomic or Headless libraries in your custom search integration with the Coveo Platform, see Use the REST APIs to build a search UI.

How do I start?

This section includes a general article about logging UA events as well as documentation specific to each UA Write API endpoint:

It also includes a troubleshooting article that covers UA Write API error codes.

Interactive generated reference documentation is also available through the Swagger UI.