Scores

The Retail Brands Score Index (RBSI) of a brand, its four dimensions, topic scores and history.

GET/brands/{id}/scoreLevel 1

Get the score of a brand

The RBSI with its direction and confidence. At Level 2 the response includes the four dimensions; at Level 3 it also includes the drivers.

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

Request

curl "https://api.retailbrands.global/v1/brands/zara/score" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · Score

{
  "brand_id": "zara",
  "rbsi": 7420,
  "previous": 7310,
  "change": 110,
  "trend": "up",
  "evaluated_at": "2026-11-02T06:10:00Z",
  "dimensions": {
    "strength": 7600,
    "momentum": 7350,
    "affinity": 7500,
    "risk": 8100
  }
}

Object fields: Data model · Score

GET/brands/{id}/score/historyLevel 2+coming soon

Score history of a brand

The score over time, oldest first.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the brand, as returned in `id`.
`from`	query	string	Start date (ISO 8601).
`to`	query	string	End 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/brands/zara/score/history?limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · ScoreHistory

{
  "data": [
    {
      "evaluated_at": "2026-10-26T06:10:00Z",
      "rbsi": 7310
    },
    {
      "evaluated_at": "2026-11-02T06:10:00Z",
      "rbsi": 7420
    }
  ],
  "next_cursor": null,
  "has_more": false
}

GET/brands/{id}/topicsLevel 2+coming soon

Topic scores of a brand

One score and rank per topic (identity, people, distribution, finance and so on).

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

Request

curl "https://api.retailbrands.global/v1/brands/zara/topics" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · TopicScoreList

{
  "data": [
    {
      "topic": "Distribution & Channel Strategy",
      "score": 7800,
      "rank": 12,
      "of": 4210
    }
  ]
}

Objects

Score

The Retail Brands Score Index and what it is made of.

Field	Type	Description
`rbsi`	integer	Overall score on a 0 to 10,000 scale.
`previous`	integer \| null	The previous evaluation.
`change`	integer \| null	rbsi minus previous.
`trend`	"up" \| "down" \| "flat"	Direction since the previous evaluation.
`confidence`	"low" \| "medium" \| "high"	How well the score is supported by evidence.
`dimensions`	object	Level 2+. `strength`, `momentum`, `affinity`, `risk`, each on the same scale.
`drivers`	array	Level 3. The topics that moved the score, with direction and weight.
`evaluated_at`	string	ISO 8601.

← Brands Signals →