Hold The Throne API · v1

Canonical sustainability research, ready as JSON.

Filter real Hold The Throne reports by department, category and verified fields. Every response includes its Throne Standard version, freshness and attribution.

API access is included with your membership: every account can create a key, and your monthly API allowance follows your plan. There is no separate API subscription.

Create your API key Read the quickstart

Hold The Throne report evidence interface
One evidence system behind the API and published reports.
Free Reader
Included
  • 5,000 SKU units / month
  • 1 API key
  • 30 requests / minute
Open dashboard
Individual Plus
Included
  • 5,000 SKU units / month
  • 1 API key
  • 30 requests / minute
Open dashboard
Individual Pro
Included
  • 5,000 SKU units / month
  • 2 API keys
  • 60 requests / minute
Open dashboard
Individual Max
Included
  • 5,000 SKU units / month
  • 3 API keys
  • 120 requests / minute
Open dashboard
Business
Included
  • 5,000 SKU units / month
  • 5 API keys
  • 120 requests / minute
Open dashboard
Enterprise Max
Included
  • 100,000 SKU units / month
  • 25 API keys
  • 600 requests / minute
Open dashboard
Quickstart

Send your first request

curl -H "X-HTT-API-Key: YOUR_KEY" \
  "https://holdthethrone.com/api/v1/brands?department=clothing&category=denim&limit=25"

A SKU unit is consumed only when a product/SKU result returns a distinct row. Brand, taxonomy and aggregate discovery requests use the request-rate allowance but do not consume SKU units.

Category endpoints

Keep each request within the relevant evidence category. Scores from different methods are not combined.

CategoryGET endpoint
Hotels to Eco Stays/api/v1/hotels/eco-stays
Food to Cacao/api/v1/food/cacao
Food to Cacao beans/api/v1/food/cacao-beans
Any department to Category/api/v1/departments/{department}/categories/{category}

Use the same API key, pagination, field filters and monthly allowance as the standard endpoints. Discover valid category slugs with /api/v1/categories.

Endpoints

GET /api/v1/brands · /products · /reports · /departments · /categories · /taxonomies/{name} · /hotels · /destinations · /usage

Use department, category, q, score_min, score_max, updated_since, standard_version, fields, limit and cursor. Unknown and undisclosed values are returned as null, never a guessed zero.

OpenAPI JSON