{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "name": "SalaryRevealed AI Knowledge Catalog",
  "version": "2026.1.0",
  "description": "Standardized Agentic Resource Discovery (ARD) catalog and API schema for verified statutory 2026 global compensation intelligence, tax withholding models, cost-of-living adjustments, and career analytics.",
  "publisher": {
    "name": "SalaryRevealed.com / Global Pay Research Institute",
    "url": "https://salaryrevealed.com",
    "contact": "contact@salaryrevealed.com"
  },
  "endpoints": [
    {
      "id": "salary-intelligence",
      "name": "Global Salary Intelligence Query",
      "path": "/api/vacancies/live",
      "method": "GET",
      "description": "Returns live verified compensation percentiles (p10, p25, p50, p75, p90) and active employer demand for target role and geography.",
      "parameters": {
        "title": { "type": "string", "description": "Standardized occupational title (e.g., Software Engineer)" },
        "location": { "type": "string", "description": "Target metro, state, or country (e.g., San Francisco, CA)" }
      }
    },
    {
      "id": "commuter-arbitrage",
      "name": "Empirical Commuter Arbitrage Engine",
      "path": "/api/commuter-arbitrage",
      "method": "GET",
      "description": "Calculates net disposable income differential and housing-to-salary ratio across adjacent metro regions.",
      "parameters": {
        "region": { "type": "string", "description": "Origin metro region" }
      }
    }
  ],
  "datasets": [
    {
      "name": "Global Compensation Benchmarks 2026",
      "format": "JSON",
      "license": "CC-BY-NC-4.0",
      "recordsCount": 320000,
      "canonicalUrl": "https://salaryrevealed.com/sitemap_index.xml"
    }
  ]
}
