{
 "openapi": "3.1.0",
 "info": {
  "title": "AIX · AI 影响力指数 数据接口",
  "version": "1.0.0",
  "description": "AIX（AI 影响力指数）是观语未来人工智能研究院编制发布的公开指数：以品类为单元，用不含品牌线索的同一题集对生成式人工智能平台标准化采样，逐平台计量各品牌在应答中被点名的比例（点名率）与其在品类成分中的占比（份额），并给出置信区间、名次分布与首位判定。排序只依据测度结果，不作人工干预；题集、成分与汇总数据全部公开，第三方可复算。指数表征生成式人工智能在特定时点的品牌认知分布，不评产品优劣，不等于市场份额，不构成购买或投资建议。 全部接口为静态 JSON，免登录、免费、无调用频率限制；引用请注明出处、期次与页面地址。",
  "contact": {
   "email": "lxtv@sina.com"
  }
 },
 "servers": [
  {
   "url": "https://aix.cg365.cn"
  }
 ],
 "paths": {
  "/api/index.json": {
   "get": {
    "summary": "接口目录",
    "description": "全部期次、品类榜单与成分名单的 JSON 地址，以及机器可读文件入口。",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    }
   }
  },
  "/api/{period}/index.json": {
   "get": {
    "summary": "期次榜单目录",
    "description": "某一期全部品类榜单的首位判定与地址。",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "parameters": [
     {
      "name": "period",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "2026-09"
       ]
      }
     }
    ]
   }
  },
  "/api/{period}/{category}.json": {
   "get": {
    "summary": "品类点名率榜",
    "description": "某一期某一品类的点名率榜：样本、平台与检索率、首位判定、每个品牌的点名率、区间、名次范围与分平台点名率。",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Board"
        }
       }
      }
     }
    },
    "parameters": [
     {
      "name": "period",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "2026-09"
       ]
      }
     },
     {
      "name": "category",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "dingzhi-jiaju",
        "dajiadian",
        "xiaojiadian",
        "xiaofei-dianzi",
        "meizhuang",
        "muying-ruye",
        "baojian-otc",
        "xinnengyuan-che"
       ]
      }
     }
    ]
   }
  },
  "/api/pinlei/{category}.json": {
   "get": {
    "summary": "品类成分名单",
    "description": "某一品类已确定的成分品牌、类型、挂靠主体与代码。",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     }
    },
    "parameters": [
     {
      "name": "category",
      "in": "path",
      "required": true,
      "schema": {
       "type": "string",
       "enum": [
        "dingzhi-jiaju",
        "dajiadian",
        "xiaojiadian",
        "xiaofei-dianzi",
        "meizhuang",
        "muying-ruye",
        "baojian-otc",
        "xinnengyuan-che"
       ]
      }
     }
    ]
   }
  },
  "/llms.txt": {
   "get": {
    "summary": "站点导览",
    "description": "llms.txt 规范的站点导览。",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  },
  "/llms-full.txt": {
   "get": {
    "summary": "全文合集",
    "description": "关键页面 Markdown 全文。",
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "text/plain": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "Brand": {
    "type": "object",
    "properties": {
     "rank": {
      "type": "integer",
      "description": "名次；点名次数相同的品牌名次相同"
     },
     "brand": {
      "type": "string"
     },
     "type": {
      "type": "string",
      "enum": [
       "成分",
       "成分复核中",
       "非成分"
      ]
     },
     "parent": {
      "type": [
       "string",
       "null"
      ],
      "description": "子品牌的母品牌"
     },
     "mentions": {
      "type": "integer",
      "description": "被点名的问答数"
     },
     "rate": {
      "type": "number",
      "description": "点名率 = 被点名的问答数 ÷ 该类问答数"
     },
     "rate_ci95": {
      "type": "array",
      "items": {
       "type": "number"
      },
      "description": "点名率 95% 区间(设计效应 Wilson)"
     },
     "rank_range95": {
      "type": "array",
      "items": {
       "type": "integer"
      },
      "description": "95% 名次置信集的上下限"
     },
     "in_leading_set": {
      "type": "boolean",
      "description": "是否属于严格名次推断下「可能是第一」的集合"
     },
     "near_listing_threshold": {
      "type": "boolean",
      "description": "点名率 95% 区间是否跨越 5% 列榜线"
     },
     "by_platform": {
      "type": "object",
      "additionalProperties": {
       "type": "number"
      },
      "description": "分平台点名率"
     }
    }
   },
   "Board": {
    "type": "object",
    "properties": {
     "category": {
      "type": "string"
     },
     "slug": {
      "type": "string"
     },
     "period": {
      "type": "string"
     },
     "collected": {
      "type": "string",
      "format": "date"
     },
     "questions": {
      "type": "integer"
     },
     "answers": {
      "type": "integer"
     },
     "listing_threshold": {
      "type": "number"
     },
     "method": {
      "type": "string"
     },
     "platforms": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "judgement": {
      "type": "object",
      "properties": {
       "state": {
        "type": "string",
        "enum": [
         "可判定第一",
         "领先簇"
        ]
       },
       "leading_set": {
        "type": "array",
        "items": {
         "type": "string"
        }
       },
       "note": {
        "type": "string"
       }
      }
     },
     "brands": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Brand"
      }
     },
     "links": {
      "type": "object"
     },
     "citation": {
      "type": "string"
     },
     "boundary": {
      "type": "string"
     }
    }
   }
  }
 }
}