---
title: "List Signal Reactions"
method: GET
path: "/{brand_id}/signals/reactions"
tags: ["signals"]
---

# List Signal Reactions

`GET /{brand_id}/signals/reactions`

## Request

- Base URL: `https://api.scrunchai.com/v1`
- URL: `https://api.scrunchai.com/v1/{brand_id}/signals/reactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/scrunch/apis/scrunch-data-api/docs/:brand_id/signals/reactions/get.ts> (a function with typed inputs; its response is checked against the schema)

List reactions users have set on this brand's signals, newest first. This is **brand-wide** — it returns every user's reactions, not just the caller's — so an integration can export the team's aggregate feedback. Filter by `fingerprint` to get reactions for one signal identity, or by `reaction` to get e.g. everything marked `useful`.

## Path parameters

- `brand_id` integer, required

## Query parameters

- `fingerprint` string, nullable: Only reactions on this signal fingerprint.
- `reaction` 'useful' | 'not_useful' | 'dismissed' | 'actioned', nullable: Only reactions with this value.
- `limit` integer: Maximum number of reactions to return.
- `offset` integer: Number of reactions to skip (pagination).

## Response `200`

Successful Response

- CollectionResponseAPISignalReaction
  - `total` integer, required
  - `offset` integer
  - `limit` integer, nullable
  - `items` APISignalReaction[], required
    - `user_id` integer, required: ID of the user the reaction belongs to.
    - `insight_id` integer, required: Signal ID the reaction was last set on.
    - `fingerprint` string, required: Stable signal identity the reaction follows across re-detections.
    - `reaction` 'useful' | 'not_useful' | 'dismissed' | 'actioned', required: The reaction value.
    - `reason` string, nullable: Free-text reason, when provided.
    - `surface` 'in_app' | 'email' | 'slack' | 'api', required: Where the reaction was set: `in_app`, `email`, `slack`, or `api`.
    - `created_at` string, date-time, required: When the reaction was first set (UTC).
    - `updated_at` string, date-time, required: When the reaction was last changed (UTC).
  - `metadata` TimeSeriesMetadata
    - `aggregation_granularity` 'daily' | 'weekly' | 'monthly', required
    - `period_count` integer, required: The number of periods in the time series
    - `start_date` string, date-time, required: The start date of the time series
    - `end_date` string, date-time, required: The end date of the time series
    - `top_domains` TopDomainsMetadata: Metadata about top domains, used by sources/domains endpoints.
      - `domains` TopDomainSummary[], required: Top domains by observation count (always domain-level aggregated)
        - `domain` string, required
        - `domain_owner` string, required
        - `observation_count` integer, required
      - `grand_total` integer, required: Total observation count across all domains (for calculating 'Other')
      - `owner_totals` object, required: Observation counts by owner type (brand, competitor, other)
      - `owner_time_series` OwnerTimeSeriesPoint[], nullable: Time series data by owner type for trend visualization
        - `time_bucket` string, required: Date string for the time bucket (YYYY-MM-DD)
        - `brand` integer, required: Observation count for brand-owned domains
        - `competitor` integer, required: Observation count for competitor-owned domains
        - `other` integer, required: Observation count for third-party domains
      - `segment_totals` SegmentTotal[]: Server-side observation counts per citation segment (covers all domains, not just top-N)
        - `name` string, required
        - `observation_count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `e37811b6bc07`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scrunch/apis/scrunch-data-api/changes/:brand_id/signals/reactions/get.md)

---

[API](https://skmtc.dev/scrunch/apis/scrunch-data-api.md) - [All operations](https://skmtc.dev/scrunch/apis/scrunch-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scrunch/apis/scrunch-data-api/revisions/3c6aa69a6595?raw)