{
  "envelope": "JSON object with keys: dataset, contributor, method, rows, licence_ack, completeness_statement",
  "kinds": {
    "pricing_observed": "Prices actually paid or actually offered in the contributor's own deals",
    "discount_bands": "Discount bands the contributor actually grants, by volume or term",
    "usage_telemetry": "Anonymised telemetry from the contributor's own product",
    "benchmark_results": "Results of a reproducible benchmark the contributor ran",
    "incident_stats": "Incident and uptime statistics for the contributor's own infrastructure",
    "compliance_facts": "Verifiable regulatory facts about the contributor (licences, audits, dates)"
  },
  "required": {
    "dataset": [
      "title",
      "kind",
      "period_start",
      "period_end",
      "unit_of_row"
    ],
    "contributor": [
      "legal_name",
      "domain",
      "contact_email",
      "signed_by"
    ],
    "method": [
      "how_collected",
      "population",
      "sample_size",
      "known_limitations"
    ]
  },
  "rules": [
    "Every object in rows must have an identical set of fields.",
    "method.sample_size must be >= len(rows).",
    "No evaluative wording anywhere (best, leading, top, faster than, unlike...).",
    "licence_ack must confirm CC BY 4.0 publication.",
    "Contributing never affects any score in the AI Visibility Index."
  ],
  "send_to": "creanlabs@gmail.com",
  "example": {
    "dataset": {
      "title": "Observed enterprise discount bands on annual SaaS renewals",
      "kind": "discount_bands",
      "summary": "Discount actually granted on annual renewals, by contract value band.",
      "period_start": "2026-01-01",
      "period_end": "2026-06-30",
      "unit_of_row": "one contract value band"
    },
    "contributor": {
      "legal_name": "Example Procurement B.V.",
      "domain": "example.com",
      "contact_email": "data@example.com",
      "signed_by": "Jane Roe, Head of Data"
    },
    "method": {
      "how_collected": "Extracted from signed renewal contracts in our own platform.",
      "population": "All annual renewals processed by us in the period.",
      "sample_size": 1841,
      "known_limitations": "Skewed toward EU buyers; excludes deals under $5k ACV."
    },
    "rows": [
      {
        "acv_band_usd": "5000-25000",
        "median_discount_pct": 8.0,
        "deals": 612
      },
      {
        "acv_band_usd": "25000-100000",
        "median_discount_pct": 14.5,
        "deals": 803
      },
      {
        "acv_band_usd": "100000+",
        "median_discount_pct": 23.0,
        "deals": 426
      }
    ],
    "licence_ack": "CC BY 4.0 — we agree this data is published openly for anyone to reuse.",
    "completeness_statement": "This is the complete population for the stated period; no rows were removed for presentation."
  }
}