---
title: "Get user facet info"
method: POST
path: "/api/v2/product-analytics/users/facet_info"
tags: ["Rum Audience Management"]
---

# Get user facet info

`POST /api/v2/product-analytics/users/facet_info`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/product-analytics/users/facet_info`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`

Get facet information for user attributes including possible values and counts

## Request body

- FacetInfoRequest: Request body for retrieving facet value information for a specified attribute with optional filtering.
  - `data` FacetInfoRequestData: The data object containing the resource type and attributes for the facet info request.
    - `attributes` FacetInfoRequestDataAttributes: Attributes for the facet info request, specifying which facet to query and optional filters to apply.
      - `facet_id` string, required: The identifier of the facet attribute to retrieve value information for.
      - `limit` integer, required: Maximum number of facet values to return in the response.
      - `search` FacetInfoRequestDataAttributesSearch: Query-based search configuration for filtering the audience context when retrieving facet values.
        - `query` string: The filter expression used to scope the audience from which facet values are retrieved.
      - `term_search` FacetInfoRequestDataAttributesTermSearch: Term-level search configuration for filtering facet values by an exact or partial term match.
        - `value` string: The term string to match against facet values.
    - `id` string: Unique identifier for the facet info request resource.
    - `type` 'users_facet_info_request', required: Users facet info request resource type.

## Response `200`

Successful response with facet information

- FacetInfoResponse: Response containing facet information for an attribute, including its distinct values and occurrence counts.
  - `data` FacetInfoResponseData: The data object containing the resource type and attributes for the facet info response.
    - `attributes` FacetInfoResponseDataAttributes: Attributes of the facet info response, containing the facet result data.
      - `result` FacetInfoResponseDataAttributesResult: The facet query result containing discrete value counts or a numeric range for the requested facet.
        - `range` FacetInfoResponseDataAttributesResultRange: The numeric range of a facet attribute, representing the minimum and maximum observed values.
          - `max` object: The maximum observed value for the numeric facet attribute.
          - `min` object: The minimum observed value for the numeric facet attribute.
        - `values` FacetInfoResponseDataAttributesResultValuesItems[]: List of discrete facet values with their occurrence counts.
          - `count` integer: The number of records that have this facet value.
          - `value` string: The facet value (for example, a browser name or country code).
    - `id` string: Unique identifier for the facet info response resource.
    - `type` 'users_facet_info', required: Users facet info resource type.

## Other responses

- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)