Quickstart

Get a key, send one request, read the score of a brand.

1. Get an API key

Sign in, open Account, API and create a key. It is available with any paid plan and with the 7-day trial. Keep it secret: anyone with the key can use your quota. Each account includes 50 requests; after that, contact sales.

2. Send a request

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

3. Read the response

{
  "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
  }
}

rbsi is the overall score on a 0 to 10,000 scale, trend its direction since the previous evaluation, and confidence how well it is supported by evidence. The dimensions and drivers appear at higher access levels.

In your language

const res = await fetch("https://api.retailbrands.global/v1/brands/zara/score", {
  headers: { Authorization: `Bearer ${process.env.RB_API_KEY}` },
});
const score = await res.json();
console.log(score.rbsi, score.trend);

import os, requests

r = requests.get(
    "https://api.retailbrands.global/v1/brands/zara/score",
    headers={"Authorization": f"Bearer {os.environ['RB_API_KEY']}"},
)
r.raise_for_status()
print(r.json()["rbsi"])

← Introduction Authentication →