---
title: "Stream Citations V2"
method: POST
path: "/v2/reports/citations/stream"
tags: ["Reports", "Reports"]
---

# Stream Citations V2

`POST /v2/reports/citations/stream`

## Request body

- CitationsV2Query
  - `category_id` string, required
  - `start_date` string, required — YYYY-MM-DD, ET, inclusive
  - `end_date` string, required — YYYY-MM-DD, ET, inclusive
  - `group_by` string[]
  - `metrics` string[], nullable
  - `interval` 'day' | 'week' | 'month'
  - `scope` 'all' | 'owned' — `all` (every cited domain) or `owned` (only your owned domains, for easy client-side totals).
  - `filter` FilterNode — A leaf (`field`/`op`/`value`) or an `and`/`or`/`not` group.
    - `and` FilterNode[], nullable
    - `or` FilterNode[], nullable
    - `not` FilterNode — recursive
    - `field` string, nullable
    - `op` string, nullable
    - `value` unknown
  - `limit` integer, nullable — Page size; default 10, max 50.
  - `max_results` integer, nullable — Stream endpoint only: cap the number of streamed rows (default: all).
  - `cursor` string, nullable

## Response `200`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/cooper-square-technologies/apis/external-api.md) · [All operations](https://skmtc.net/cooper-square-technologies/apis/external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cooper-square-technologies/external-api/versions/ab03b3c80494/schema)