Skip to main content
GET
/
1
/
clusters
/
mapping
/
top
curl
curl --request GET \
  --url https://algolia_application_id.algolia.net/1/clusters/mapping/top \
  --header 'accept: application/json' \
  --header 'x-algolia-api-key: ALGOLIA_API_KEY' \
  --header 'x-algolia-application-id: ALGOLIA_APPLICATION_ID'
{
  "topUsers": [
    {}
  ]
}
Since it can take a few seconds to get the data from the different clusters, the response isn’t real-time. Requires Admin API key

Authorizations

​
x-algolia-application-id
string
header
required

Your Algolia application ID.

​
x-algolia-api-key
string
header
required

Your Algolia API key with the necessary permissions to make the request. Permissions are controlled through access control lists (ACL) and access restrictions. The required ACL to make a request is listed in each endpoint's reference.

Response

OK

User IDs and clusters.

​
topUsers
object[]
required

Key-value pairs with cluster names as keys and lists of users with the highest number of records per cluster as values.

Last modified on March 23, 2026