Signals

Interpreted events on brands, derived from the evidence, as a feed you can filter and subscribe to.

GET/signalsLevel 1

List signals

Published signals, newest first, with the short answer and the names of the sources.

Parameter	In	Type	Description
`brand`	query	string	Brand id or slug.
`category`	query	string	Category name or slug. Repeat or comma-separate for several.
`since`	query	string	Only signals published on or after this date (ISO 8601).
`limit`	query	integer	Items per page, 1 to 100 (default 25).
`cursor`	query	string	The `next_cursor` of the previous page.

Request

curl "https://api.retailbrands.global/v1/signals?category=fashion&limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · SignalList

{
  "data": [
    {
      "id": "3f6c1e0a-5a52-4f0e-9d1c-8f7b2c9a1d44",
      "brand_id": "zara",
      "brand_name": "Zara",
      "category": "Expansion & Growth",
      "title": "Opens 12 new stores in the UK",
      "summary": "Eleven of the openings are in shopping centres.",
      "status": "Increasing",
      "direction": "Accelerating",
      "importance": "High",
      "markets": [
        "United Kingdom"
      ],
      "published_at": "2026-11-01",
      "source_names": [
        "Company press release"
      ],
      "source_count": 1
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · Signal

GET/signals/{id}Level 1

Get a signal

One signal with its sources.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the signal, as returned in `id`.

Request

curl "https://api.retailbrands.global/v1/signals/3f6c1e0a-5a52-4f0e-9d1c-8f7b2c9a1d44" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · Signal

{
  "id": "3f6c1e0a-5a52-4f0e-9d1c-8f7b2c9a1d44",
  "brand_id": "zara",
  "brand_name": "Zara",
  "category": "Expansion & Growth",
  "title": "Opens 12 new stores in the UK",
  "summary": "Eleven of the openings are in shopping centres.",
  "status": "Increasing",
  "direction": "Accelerating",
  "importance": "High",
  "markets": [
    "United Kingdom"
  ],
  "published_at": "2026-11-01",
  "source_names": [
    "Company press release"
  ],
  "source_count": 1
}

Object fields: Data model · Signal

Objects

Signal

An interpreted event on a brand, derived from evidence.

Field	Type	Description
`id`	string	Signal identifier (UUID).
`brand_id`	string	The brand slug.
`brand_name`	string
`category`	string	Signal category.
`title`	string	Headline.
`summary`	string	The short answer: what it means.
`status`	string \| null	Increasing, Emerging, Stable...
`direction`	string \| null	Accelerating, Steady or Decelerating.
`importance`	string \| null
`markets`	array	Countries concerned.
`published_at`	string \| null	ISO 8601.
`source_names`	array	Names of up to two sources.
`source_count`	integer	Number of sources behind the signal.

← Scores Data points →