---
title: Use the Usage Analytics Read API
slug: '2671'
canonical_url: https://docs.coveo.com/en/2671/
collection: coveo-analytics
source_format: adoc
---
# Use the Usage Analytics Read API
The Usage Analytics Read API service lets you access and manipulate the data you logged via the [Usage Analytics Write API](https://docs.coveo.com/en/1430/).

> **Notes**
>
> * Search integrations with Coveo often rely on [Coveo Administration Console](https://docs.coveo.com/en/183/) [Reports](https://docs.coveo.com/en/1674/), instead of directly relying on the UA Read API.
> 
> * {empty}
>  
> --
> All REST API string fields are case-sensitive unless otherwise specified.
> For example, [search queries aren't case-sensitive](https://docs.coveo.com/en/3074/).
> 
> To keep behavior consistent across the [Coveo Platform](https://docs.coveo.com/en/186/), the same value passed to different REST APIs must always be passed using the same case.
> For example, if the [unique product identifier](https://docs.coveo.com/en/n73f0502#define-a-unique-product-identifier), such as `ec_product_id`, is passed to the Commerce API in lowercase, then it should also be passed to the Usage Analytics Write API in lowercase.
> --

The articles in this section are only relevant if your use case isn't met by the [Administration Console](https://platform.cloud.coveo.com/login) ([platform-ca](https://platform-ca.cloud.coveo.com/login) | [platform-eu](https://platform-eu.cloud.coveo.com/login) | [platform-au](https://platform-au.cloud.coveo.com/login)):

* [Perform a combinedData request](https://docs.coveo.com/en/2672/)

* [Create and retrieve data exports](https://docs.coveo.com/en/2849/)

* [Filter syntax](https://docs.coveo.com/en/2727/)

* [List named filters](https://docs.coveo.com/en/2860/)

* [List dimensions](https://docs.coveo.com/en/2861/)

* [List metrics](https://docs.coveo.com/en/2862/)

A common scenario for using the UA Read API directly is when you wish to access content within the [Coveo Administration Console](https://docs.coveo.com/en/183/) and integrate it into your own application.
For example, you may want to retrieve and integrate [metric](https://docs.coveo.com/en/263/) values for specific [dimensions](https://docs.coveo.com/en/258/) (see [Perform a combinedData request](https://docs.coveo.com/en/2672/)).

Interactive generated reference documentation is also available through the [Swagger UI](https://platform.cloud.coveo.com/docs?urls.primaryName=UsageAnalyticsRead).