API documentation

Everything on the site — scores, confidence intervals, ranks, movement, citations — as JSON, updated monthly. Get an API key ($199/mo, 10,000 requests/month), or try it first with a free trial key (100 requests/month, one per account) from your dashboard. The free CSV stays free.

Authentication

curl https://helloranked.com/api/v1/industries \
  -H "Authorization: Bearer hr_live_..."

Keys are shown once at creation and stored only as hashes. Manage them in your dashboard. Each key has a monthly request limit — 10,000 for paid keys, 100 for trial keys — enforced with 429 responses (resets on the 1st); key revocation is immediate (401).

Endpoints

Endpoint	Returns
`GET /api/v1/industries`	All industries with their latest run.
`GET /api/v1/industries/{slug}/leaderboard`	Latest leaderboard: global scores, CIs, ranks, per-provider metrics.
`GET /api/v1/industries/{slug}/movers`	Month-over-month movement with significance flags.
`GET /api/v1/brands/{slug}/history`	Full score history for a brand.
`GET /api/v1/brands/{slug}/citations`	Domains cited by search-backed answers mentioning the brand.

Example response

{
  "industry": "crm",
  "run": { "id": 65, "date": "2026-08-01", "partial": false },
  "leaderboard": [
    {
      "brand": "hubspot", "name": "HubSpot", "rank": 1,
      "global_score": 70.4, "ci_low": 68.3, "ci_high": 72.2,
      "providers": [
        { "provider": "openai", "score": 71.4, "mention_rate": 0.86, ... }
      ]
    }
  ]
}

Semantics match the public site: scores are 0–100 with 95% bootstrap CIs; movement rows carry a significant flag — treat non-significant deltas as noise (we do). Full definitions on the methodology page.