---
title: "List signals grouped by company with aggregates"
method: GET
path: "/api/me/signals/companies"
tags: ["me"]
---

# List signals grouped by company with aggregates

`GET /api/me/signals/companies`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/signals/companies`
- Auth: none declared

Same filters as /api/me/signals but returns one row per company with signal count, person count, avg ICP, top persona, and latest signal date. Available to all plans.

## Query parameters

- `type` string
- `kind` 'reaction' | 'comment'
- `minScore` string
- `minIcp` string
- `classification` 'buyer' | 'influencer'
- `days` string
- `source` string, uuid
- `sourceType` string
- `persona` string
- `industry` string
- `search` string
- `company` string: Filter to a single company key (enriched LinkedIn URL or lowered name). Matches either form. Used by /signals/company/:companyKey to fetch the aggregate enrichment row.
- `limit` string
- `offset` string
- `tags` string: Packed tag filter: `<catId>:<tok>|<tok>,<catId2>:<tok>` where tok = value UUID | `!`UUID (exclude) | `none` (untagged in category) | `any` (tagged in category). OR within a group, AND across groups.
- `sortBy` 'signalCount' | 'latestSignalAt' | 'employeeCount' | 'companyName': Sort key for the company list. Default: signalCount.
- `sortDir` 'asc' | 'desc': Sort direction. Default: desc.

## Response `200`

Paginated company-grouped signals

- MeCompaniesListResponse
  - `companies` object[], required
    - `companyKey` string, nullable, required: Canonical company key — LinkedIn company URL when enrichment is available, lowercased company name as fallback.
    - `companyName` string, nullable, required
    - `companyIndustry` string, nullable, required
    - `employeeCount` integer, nullable, required
    - `companyHeadquarters` string, nullable, required: Flattened HQ location string, e.g. "San Francisco, CA, US".
    - `companyLinkedinUrl` string, nullable, required
    - `companyWebsiteUrl` string, nullable, required: Company website URL from LinkedIn enrichment.
    - `companyTagline` string, nullable, required: Company tagline from LinkedIn enrichment.
    - `companyFoundedYear` integer, nullable, required: Year the company was founded.
    - `companySpecialities` string[], nullable, required: Company specialities/focus areas from LinkedIn enrichment.
    - `companyDescription` string, nullable, required: Company description from LinkedIn enrichment or signal data.
    - `signalCount` integer, required
    - `personCount` integer, required: Distinct people detected at this company.
    - `latestSignalAt` string, date-time, nullable, required
    - `avgIcpScore` number, nullable, required: Average composite ICP score (0-1 scale) across signals at this company.
    - `topPersona` string, nullable, required: Most common persona among signals at this company.
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

---

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