Coming Soon

API Documentation

Access AI category data programmatically. See which categories AI puts brands in across multiple leading models.

Quick Start

Authentication

All API requests require a Bearer token in the Authorization header. Get your API key after signing up.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.categoryrank.ai/v1/brand/ti.com/categories

Example Response

Returns AI-assigned categories with consensus scores and competitive rankings.

{
  "domain": "ti.com",
  "displayName": "Texas Instruments",
  "overallScore": 76,
  "modelCoverage": 10,
  "categories": [
    {
      "category": "Power Management ICs",
      "score": 89,
      "rank": 1,
      "totalBrands": 2877,
      "modelConsensus": 10,
      "kimDistance": 0.02,
      "kimDistanceClass": "core",
      "timingSignal": "crowded"
    },
    {
      "category": "Microcontrollers",
      "score": 82,
      "rank": 2,
      "totalBrands": 1576,
      "modelConsensus": 10,
      "kimDistance": 0.05,
      "kimDistanceClass": "core",
      "timingSignal": "contested"
    }
  ]
}

Key insight: Categories with high kimDistance are AI-emergent (categories AI invented). Categories with low kimDistance map to canonical market definitions.

API Endpoints

GET/api/v1/brand/{domain}/categories

Get all categories AI assigns to this brand, with consensus and ranking data.

GET/api/v1/brand/{domain}/gravity

Get the full Category Gravity payload with KIM Ontology distances and timing signals.

GET/api/v1/category/{slug}/brands

Get all brands in a category with rankings and model consensus.

GET/api/v1/categories/explorer

Get category explorer data: consensus levels, brand counts, top performers.

API Access Coming Soon

Join the waitlist to be notified when API access is available.

Join Waitlist →