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

# Stream Sentiment V2

`POST /v2/reports/sentiment/stream`

## Request body

- SentimentV2Query
  - `category_id` string, required
  - `asset` string, required — The brand name to analyze (sentiment is extracted on name, not id).
  - `start_date` string, required — YYYY-MM-DD, ET, inclusive
  - `end_date` string, required — YYYY-MM-DD, ET, inclusive
  - `comparison_start_date` string, nullable — YYYY-MM-DD, ET, inclusive (with end).
  - `comparison_end_date` string, nullable — YYYY-MM-DD, ET, inclusive (with start).
  - `group_by` string[]
  - `metrics` string[], nullable
  - `interval` 'day' | 'week' | 'month'
  - `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
  - `sort` AppRoutesV2AnswerEngineInsightsReportsSentimentSortSpec
    - `field` 'occurrence' | 'positive_sentiment' | 'negative_sentiment'
    - `dir` 'asc' | 'desc'
  - `include_cited_websites` boolean — Return cited websites per row (only when grouping by `theme`/`claim`).
  - `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)