---
title: "Returns a single aggregated value for a metric during a period of time"
method: GET
path: "/v2/analytics/competitors/{competitorId}/aggregation"
tags: ["Competitors Api Service"]
---

# Returns a single aggregated value for a metric during a period of time

`GET /v2/analytics/competitors/{competitorId}/aggregation`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/analytics/competitors/{competitorId}/aggregation`
- Auth: none declared

## Path parameters

- `competitorId` string, required

## Query parameters

- `network` string, required
- `metric` string, required
- `from` string, required
- `to` string, required
- `timezone` string
- `subject` string
- `scope` string

## Response `200`

OK

- JsonOkResponseDouble
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` number, double

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)