Brands

The brands we monitor: identity, ownership and the data behind them.

GET/brandsLevel 1

List brands

Brands in the Index, most recently updated first. Combine filters; they narrow the list.

Parameter	In	Type	Description
`q`	query	string	Search by name.
`country`	query	string	ISO 3166-1 alpha-2 country code. Repeat or comma-separate for several.
`category`	query	string	Category name or slug. Repeat or comma-separate for several.
`group`	query	string	Only brands of this group (group id or slug).
`updated_since`	query	string	Only items changed after this ISO 8601 date-time.
`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?q=zara&country=GB" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · BrandList

{
  "data": [
    {
      "id": "zara",
      "slug": "zara",
      "name": "Zara",
      "category": "Fashion",
      "sub_category": "Womenswear",
      "region": "Europe",
      "hq": "Spain",
      "countries": [
        "ES",
        "GB",
        "FR"
      ],
      "updated_at": "2026-11-02T06:10:00Z",
      "score": {
        "rbsi": 7420,
        "trend": "up"
      }
    }
  ],
  "next_cursor": "eyJvIjoyNX0",
  "has_more": true
}

Object fields: Data model · Brand

GET/brands/{id}Level 1

Get a brand

One brand with its identity, ownership and headline score.

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" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · Brand

{
  "id": "zara",
  "slug": "zara",
  "name": "Zara",
  "category": "Fashion",
  "sub_category": "Womenswear",
  "region": "Europe",
  "hq": "Spain",
  "countries": [
    "ES",
    "GB",
    "FR"
  ],
  "updated_at": "2026-11-02T06:10:00Z",
  "score": {
    "rbsi": 7420,
    "previous": 7310,
    "change": 110,
    "trend": "up"
  }
}

Object fields: Data model · Brand

GET/brands/{id}/mallsLevel 1coming soon

Malls where a brand trades

The malls that list this brand as a tenant, with its store count in each.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the brand, as returned in `id`.
`country`	query	string	ISO 3166-1 alpha-2 country code. Repeat or comma-separate for several.
`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/malls?country=GB&limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · MallList

{
  "data": [
    {
      "id": "liverpool-one",
      "name": "Liverpool ONE",
      "country": "GB",
      "brands": {
        "monitored": 39
      },
      "stores": 41
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · Mall

Objects

Brand

A monitored brand.

Field	Type	Description
`id`	string	The brand slug, stable and URL-safe.
`slug`	string	Same as id.
`name`	string	Display name.
`category`	string \| null	Primary category.
`sub_category`	string \| null
`region`	string \| null	Home region.
`hq`	string \| null	Country of the headquarters.
`countries`	array	ISO country codes with confirmed stores.
`score`	object \| null	Headline score: rbsi, previous, change, trend.
`updated_at`	string \| null	When the brand was last evaluated (ISO 8601).

Mall

A shopping centre.

Field	Type	Description
`id`	string	The mall slug, stable and URL-safe.
`name`	string
`country`	string \| null	ISO alpha-2.
`region`	string \| null
`type`	string \| null	Shopping mall, Outlet mall or Retail park.
`gla_m2`	number \| null	Gross leasable area in square metres.
`operators`	array	Owners and operators: id, name.
`brands`	object	monitored: number of monitored brands trading there.
`stores`	integer	Stores of monitored brands.

← MCP for AI agents Scores →