---
title: "Get Ad Changes Timeseries"
method: GET
path: "/ad_changes/timeseries"
---

# Get Ad Changes Timeseries

`GET /ad_changes/timeseries`

## Query parameters

- `group_by` 'change_source' | 'change_type' | 'actor' | 'routine'
- `granularity` 'hour' | 'day' | 'week', nullable
- `agent_session_id` integer, nullable
- `date_range[since]` union, required
  - string, date
  - string, date-time
  - string
- `date_range[until]` union
  - string, date
  - string, date-time
  - string
- `tz` string, nullable
- `start_of_week` 0 | 1
- `channel[]` string[], nullable
- `ad_platform_id[]` integer[], nullable
- `change_source[]` ChangeSource[], nullable
- `change_type[]` SemanticChangeType[], nullable
- `object_scope[]` AdChangeObjectScope[], nullable
- `actor[]` string[], nullable
- `routine[]` string[], nullable
- `hide_system` boolean

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable
- `X-Browser-Time-Zone` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- AdChangesTimeseriesResponse
  - `granularity` 'hour' | 'day' | 'week', required
  - `points` AdChangesTimeseriesPoint[], required
    - `bucket` string, date-time, required
    - `key` string, required
    - `count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/runconverge/apis/fastapi.md) · [All operations](https://skmtc.dev/runconverge/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runconverge/fastapi/revisions/1452e350bd1d/schema)