---
title: "Find Popularity"
method: POST
path: "/findPopularity"
tags: ["Popularity"]
---

# Find Popularity

`POST /findPopularity`

Returns latest information about the popularity and usage for assets

## Request body

- AssetLocator[]
  - `type` string, required — Identifier for the datastore type of origin.
  - `product` string — Commercial name of the datastore of origin.
  - `keys` string[], required — Ordered list of names for each member of the hierarchy of an item.

## Response `200`

List of popularity scores

- FindPopularityResponse[]
  - `assetLocator` AssetLocator[], required
    - `type` string, required — Identifier for the datastore type of origin.
    - `product` string — Commercial name of the datastore of origin.
    - `keys` string[], required — Ordered list of names for each member of the hierarchy of an item.
  - `popularity` Popularity
    - `score` string
    - `calculatedAt` string, date-time
  - `usageData` UsageData
    - `fromDate` string, date-time
    - `toDate` string, date-time
    - `queryCount` integer
    - `distinctUsers` integer
  - `errorMessage` string

## Other responses

- `400` — The request is not valid.
- `401` — The client is not authenticated.
- `403` — The user lacks permissions.
- `404` — Resource not found.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)