Data points

The catalogue of data points and the observed values for an entity, each with its evidence.

GET/data-pointsLevel 1coming soon

The data point catalogue

Every data point the API can return: what it is, how it is acquired, the lowest level that includes it and how often it is refreshed.

Parameter	In	Type	Description
`entity`	query	string	brand, mall, operator or store.
`topic`	query	string	Topic or group.
`method`	query	string	pulled, deducted or manual.
`level`	query	integer	Only data points included at this level or lower.
`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/data-points?limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · DataPointCatalogue

{
  "data": [
    {
      "id": "B-RDP-412",
      "api_slug": "brand.d10.malls_hosting_the_brand_count_countries",
      "name": "Malls hosting the brand",
      "entity": "brand",
      "topic": "Distribution & Channel Strategy",
      "method": "deducted",
      "level": 2,
      "refresh": "weekly",
      "sensitivity": "normal"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · DataPoint

GET/brands/{id}/data-pointsLevel 2+coming soon

Data points of a brand

The observed values for a brand. Each value carries its method, confidence and freshness; at Level 3 also its evidence.

Parameter	In	Type	Description
`id`	path	string · required	Identifier of the brand, as returned in `id`.
`topic`	query	string	Topic or group.
`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/zara/data-points?limit=25" \
  -H "Authorization: Bearer $RB_API_KEY"

Response 200 · DataPointValueList

{
  "data": [
    {
      "data_point": "brand.d10.malls_hosting_the_brand_count_countries",
      "value": 87,
      "unit": "malls",
      "method": "deducted",
      "confidence": "medium",
      "observed_at": "2026-10-28T00:00:00Z",
      "verification_status": "unverified"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Object fields: Data model · DataPointValue

Objects

DataPoint

An entry of the data point catalogue.

Field	Type	Description
`id`	string	Register id, for example `B-RDP-412` (entity B, M, O or S; type RDP, REG, SIG…).
`api_slug`	string	`<entity>.<topic>.<name>`.
`method`	"pulled" \| "deducted" \| "manual"	How it is acquired (see Data model).
`level`	1 \| 2 \| 3	The lowest access level that includes it.
`refresh`	string	daily, weekly, monthly, quarterly, annual or event-driven.
`sensitivity`	"normal" \| "sensitive" \| "critical"	Governance field.

DataPointValue

An observed value with what it is built on.

Field	Type	Description
`data_point`	string	The data point api_slug.
`value`	any	The value, typed by the data point.
`unit`	string \| null	Unit of the value.
`method`	string	pulled, deducted or manual.
`confidence`	string	low, medium or high.
`observed_at`	string	When the value was observed.
`verification_status`	string	unverified, verified or conflicted.
`evidence`	array	Level 3. Sources behind the value.

← Signals Malls →