Malls

Shopping centres: identity, size, operators and the brands trading in them.

GET/mallsLevel 1

List malls

Shopping centres on record.

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.
`operator`	query	string	Operator id or slug.
`type`	query	string	Shopping mall, Outlet mall or Retail park.
`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/malls?q=zara&country=GB" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · MallList

{
  "data": [
    {
      "id": "liverpool-one",
      "name": "Liverpool ONE",
      "country": "GB",
      "region": "Europe",
      "type": "Shopping mall",
      "gla_m2": 219377,
      "operators": [
        {
          "id": "landsec",
          "name": "Landsec"
        }
      ],
      "brands": {
        "monitored": 39
      },
      "stores": 41
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · Mall

GET/malls/{id}Level 1

Get a mall

One mall with its operators and tenant counts.

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

Request

curl "https://api.retailbrands.global/v1/malls/liverpool-one" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · Mall

{
  "id": "liverpool-one",
  "name": "Liverpool ONE",
  "country": "GB",
  "region": "Europe",
  "type": "Shopping mall",
  "gla_m2": 219377,
  "operators": [
    {
      "id": "landsec",
      "name": "Landsec"
    }
  ],
  "brands": {
    "monitored": 39
  },
  "stores": 41,
  "categories": [
    "Fashion",
    "Beauty"
  ]
}

Object fields: Data model · Mall

GET/malls/{id}/tenantsLevel 2+coming soon

Tenants of a mall

The brands trading in the mall. A tenant that is not monitored yet has no `brand_id`.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the mall, as returned in `id`.
`category`	query	string	Category name or slug. Repeat or comma-separate for several.
`monitored`	query	boolean	Only monitored brands (true) or only the others (false).
`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/malls/liverpool-one/tenants?category=fashion&limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · TenantList

{
  "data": [
    {
      "name": "Zara",
      "brand_id": "zara",
      "category": "Fashion",
      "monitored": true
    },
    {
      "name": "Local Bakery",
      "brand_id": null,
      "category": "Eatery",
      "monitored": false
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Objects

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.

← Data points Operators →