{
  "openapi": "3.1.0",
  "info": {
    "title": "Brainpan.AI AIVI™ Insurance Benchmark API — Q2 2026 Top 10",
    "version": "2026.Q2.1",
    "description": "Read-only, static JSON access to the top 10 verified brand results from the Brainpan.AI AIVI™ (AI Visibility Index) Q2 2026 Insurance Benchmark. Figures match the published Key Findings summary PDF exactly. Full methodology, the named leaderboard, and category breakdowns are at the source URL below.",
    "termsOfService": "https://www.brainpan.ai/research/aivi-insurance-benchmark-q2-2026/",
    "contact": {
      "name": "Brainpan.AI",
      "url": "https://www.brainpan.ai/contact/"
    },
    "license": {
      "name": "CC BY 4.0",
      "identifier": "CC-BY-4.0",
      "url": "https://creativecommons.org/licenses/by/4.0/"
    }
  },
  "servers": [
    { "url": "https://www.brainpan.ai" }
  ],
  "paths": {
    "/api/aivi/insurance/q2-2026/top10.json": {
      "get": {
        "summary": "Full top-10 AIVI leaderboard for the Q2 2026 Insurance Benchmark",
        "description": "Returns all 10 published brands with AIVI score, mentions, share of voice, Top-3 rate, recommendation rate, and citations, plus study-level metadata.",
        "operationId": "getInsuranceQ22026Top10",
        "responses": {
          "200": {
            "description": "Top-10 leaderboard with study metadata.",
            "content": { "application/json": { "schema": { "type": "object" } } }
          }
        }
      }
    },
    "/api/aivi/insurance/q2-2026/brands/{slug}.json": {
      "get": {
        "summary": "AIVI result for a single top-10 brand in the Q2 2026 Insurance Benchmark",
        "operationId": "getInsuranceQ22026Brand",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": ["state-farm", "progressive", "usaa", "geico", "nationwide", "allstate", "travelers", "the-hartford", "chubb", "amica"]
            },
            "description": "Lowercase, hyphenated brand slug."
          }
        ],
        "responses": {
          "200": {
            "description": "Single-brand AIVI record.",
            "content": { "application/json": { "schema": { "type": "object" } } }
          },
          "404": {
            "description": "Brand is not in the published top 10 for this edition. Request an AI Visibility Audit for brands outside the top 10."
          }
        }
      }
    }
  }
}
