# Get analytics data based on a query

Fetches detailed analytics data. The request body specifies the dimensions, measures, time dimensions, and filters for the query.

Note: Always include pageviews.account_id in filters for better performance, as data is chunked on workspace/account_id.

Endpoint: POST /analytics
Version: 1.0.0

## Request fields (application/json):

  - `query` (object, required)
    The main analytics query object.

  - `query.total` (boolean)
    Whether to include a total count.

  - `query.dimensions` (array, required)
    A list of dimensions to group the data by (e.g., pageviews.account_id).

  - `query.timeDimensions` (array, required)
    A list of time dimensions for date-based slicing.

  - `query.timeDimensions.granularity` (string, required)
    The aggregation period (e.g., day).
    Enum: "day", "week", "month", "year"

  - `query.timeDimensions.dimension` (string, required)
    The time dimension member (e.g., pageviews.timestamp).

  - `query.timeDimensions.dateRange` (array, required)
    The start and end dates for the query (e.g., ["2025-07-01", "2025-08-01"]).

  - `query.measures` (array, required)
    A list of measures (metrics) to calculate (e.g., pageviews.unique_clients).

  - `query.limit` (integer)
    The maximum number of results to return.

  - `query.filters` (array)
    A list of filters to apply to the data.

  - `query.filters.member` (string, required)
    The dimension or measure member to filter on (e.g., pageviews.account_id).

  - `query.filters.operator` (string, required)
    The filter operator.
    Enum: "equals", "notEquals", "contains", "notContains", "startsWith", "endsWith", "gt", "gte", "lt", "lte", "in", "notIn", "set", "notSet"

  - `query.filters.values` (array, required)
    The values to filter by.

## Response 200 fields (application/json):

  - `query` (object)
    The final query object used by the server (may include defaults/modifications).

  - `data` (array)
    The resulting analytics data rows.

  - `lastRefreshTime` (string)
    Timestamp of the last data refresh.

  - `annotation` (object)
    Metadata and annotations about the dimensions and measures.

  - `total` (integer)
    The total number of rows.


## Response 400 fields

## Response 401 fields