API Hub

{
  "datasetVersion": "1.0.0",
  "hub": "api",
  "label": "Colors Encyclopedia API Hub",
  "url": "https://www.colorsencyclopedia.com/api/",
  "apiUrl": "https://www.colorsencyclopedia.com/api/index.json",
  "groupCount": 4,
  "endpointCount": 23,
  "groups": [
    {
      "key": "core",
      "label": "Core Dataset APIs",
      "description": "Primary indexes for the full color graph, atlas, palettes, harmonies, comparisons, brand references, and tools.",
      "endpoints": [
        {
          "path": "/api/colors.json",
          "name": "Global Colors API",
          "description": "Index of 500 editorial color records with HEX, RGB, HSL, CMYK, WCAG, family, tone, and API links.",
          "url": "https://www.colorsencyclopedia.com/api/colors.json"
        },
        {
          "path": "/api/hex.json",
          "name": "HEX Atlas API",
          "description": "Index of 40,000 selected HEX atlas records for deterministic technical lookup.",
          "url": "https://www.colorsencyclopedia.com/api/hex.json"
        },
        {
          "path": "/api/palettes.json",
          "name": "Palettes API",
          "description": "Curated and generated palette index with source colors, roles, accessibility, and semantic groups.",
          "url": "https://www.colorsencyclopedia.com/api/palettes.json"
        },
        {
          "path": "/api/harmonies.json",
          "name": "Harmonies API",
          "description": "Named color harmony index covering complementary, analogous, triadic, tetradic, split-complementary, and monochromatic systems.",
          "url": "https://www.colorsencyclopedia.com/api/harmonies.json"
        },
        {
          "path": "/api/compare.json",
          "name": "Comparisons API",
          "description": "Named color comparison index for side-by-side technical and semantic color differences.",
          "url": "https://www.colorsencyclopedia.com/api/compare.json"
        },
        {
          "path": "/api/brand-colors.json",
          "name": "Brand Colors API",
          "description": "Independent technical brand color references grouped by category and palette metadata.",
          "url": "https://www.colorsencyclopedia.com/api/brand-colors.json"
        },
        {
          "path": "/api/tools.json",
          "name": "Tools API",
          "description": "Machine-readable catalog of color tools, converters, explorers, and task groups.",
          "url": "https://www.colorsencyclopedia.com/api/tools.json"
        }
      ],
      "count": 7
    },
    {
      "key": "taxonomy",
      "label": "Taxonomy APIs",
      "description": "Filtered machine-readable color groups for family, tone, temperature, and accessibility navigation.",
      "endpoints": [
        {
          "path": "/api/colors/by-family/green.json",
          "name": "Color Family API",
          "description": "Example family record with color list, tone groups, popular colors, and semantic labels.",
          "url": "https://www.colorsencyclopedia.com/api/colors/by-family/green.json"
        },
        {
          "path": "/api/colors/by-tone/pastel.json",
          "name": "Color Tone API",
          "description": "Example tone record for cross-family tone groups such as pastel, muted, vibrant, dark, and light.",
          "url": "https://www.colorsencyclopedia.com/api/colors/by-tone/pastel.json"
        },
        {
          "path": "/api/colors/by-temperature/cool.json",
          "name": "Color Temperature API",
          "description": "Example temperature record for warm, cool, and neutral color behavior.",
          "url": "https://www.colorsencyclopedia.com/api/colors/by-temperature/cool.json"
        },
        {
          "path": "/api/wcag/accessible-colors.json",
          "name": "Accessible Colors API",
          "description": "WCAG AA and AAA accessible color index with family groups and contrast metadata.",
          "url": "https://www.colorsencyclopedia.com/api/wcag/accessible-colors.json"
        }
      ],
      "count": 4
    },
    {
      "key": "detail",
      "label": "Detail APIs",
      "description": "Single-entity records for colors, HEX atlas values, CSS utilities, WCAG pages, harmonies, comparisons, and brand palettes.",
      "endpoints": [
        {
          "path": "/api/colors/sage-green.json",
          "name": "Color Detail API",
          "description": "Full machine-readable record for one named color.",
          "url": "https://www.colorsencyclopedia.com/api/colors/sage-green.json"
        },
        {
          "path": "/api/hex/9caf88.json",
          "name": "HEX Detail API",
          "description": "Full technical record for one HEX atlas value.",
          "url": "https://www.colorsencyclopedia.com/api/hex/9caf88.json"
        },
        {
          "path": "/api/css/colors/ghost-white.json",
          "name": "CSS Utility API",
          "description": "CSS variables, classes, snippets, contrast tokens, and implementation metadata.",
          "url": "https://www.colorsencyclopedia.com/api/css/colors/ghost-white.json"
        },
        {
          "path": "/api/wcag/avocado.json",
          "name": "WCAG Detail API",
          "description": "Contrast, pairings, warnings, alternatives, and component guidance for one color.",
          "url": "https://www.colorsencyclopedia.com/api/wcag/avocado.json"
        },
        {
          "path": "/api/harmonies/avocado.json",
          "name": "Harmony Detail API",
          "description": "Source color harmony groups, CSS tokens, accessibility notes, and related endpoints.",
          "url": "https://www.colorsencyclopedia.com/api/harmonies/avocado.json"
        },
        {
          "path": "/api/compare/brushed-brass-vs-old-gold.json",
          "name": "Comparison Detail API",
          "description": "Technical, visual, and semantic comparison data for two named colors.",
          "url": "https://www.colorsencyclopedia.com/api/compare/brushed-brass-vs-old-gold.json"
        },
        {
          "path": "/api/brand-colors/starbucks.json",
          "name": "Brand Detail API",
          "description": "Independent brand palette reference with color values, CSS variables, accessibility, and metadata.",
          "url": "https://www.colorsencyclopedia.com/api/brand-colors/starbucks.json"
        }
      ],
      "count": 7
    },
    {
      "key": "infrastructure",
      "label": "Infrastructure APIs",
      "description": "Manifest, audit, route, API, and operational endpoints for crawler validation and dataset monitoring.",
      "endpoints": [
        {
          "path": "/api/index.json",
          "name": "API Index",
          "description": "Machine-readable index of API groups, endpoints, and usage notes.",
          "url": "https://www.colorsencyclopedia.com/api/index.json"
        },
        {
          "path": "/dataset/manifest.json",
          "name": "Dataset Manifest",
          "description": "Version, build hash, guardrails, route totals, API totals, and module configuration.",
          "url": "https://www.colorsencyclopedia.com/dataset/manifest.json"
        },
        {
          "path": "/assets/audit-report.json",
          "name": "Audit Report",
          "description": "Generated route counts, coverage checks, warnings, and missing data diagnostics.",
          "url": "https://www.colorsencyclopedia.com/assets/audit-report.json"
        },
        {
          "path": "/assets/route-manifest.json",
          "name": "Route Manifest",
          "description": "Generated HTML routes available for crawling and validation.",
          "url": "https://www.colorsencyclopedia.com/assets/route-manifest.json"
        },
        {
          "path": "/assets/api-manifest.json",
          "name": "API Manifest",
          "description": "Generated JSON resources available for crawling and ingestion.",
          "url": "https://www.colorsencyclopedia.com/assets/api-manifest.json"
        }
      ],
      "count": 5
    }
  ],
  "semanticGroups": [
    "static color API",
    "AI-ready dataset",
    "JSON endpoints",
    "color knowledge graph",
    "crawler ingestion"
  ],
  "usageNotes": [
    "All public API endpoints are static JSON resources.",
    "Cache JSON responses aggressively and avoid repeated refresh loops.",
    "Use sitemap partitions and manifests for bulk discovery.",
    "Use detail endpoints for entity-level retrieval and index endpoints for batch ingestion."
  ],
  "relatedEndpoints": [
    "https://www.colorsencyclopedia.com/api/index.json",
    "https://www.colorsencyclopedia.com/dataset/manifest.json",
    "https://www.colorsencyclopedia.com/assets/api-manifest.json",
    "https://www.colorsencyclopedia.com/ai-access-policy/"
  ]
}