{
  "api": {
    "name": "AI Ranking public data API",
    "version": "1",
    "docs": "https://airanking.cc/api/",
    "index": "https://airanking.cc/api/v1/index.json",
    "format": "JSON over HTTPS, read-only, no key required",
    "notes_zh": "只读端点，无需鉴权；数据端点为紧凑 JSON，元数据端点（index/meta）为缩进 JSON。",
    "notes_en": "Read-only, no key required. Data endpoints are compact JSON; metadata endpoints (index/meta) are indented."
  },
  "methodology": {
    "version": "2026.10.25",
    "spec_hash": "sha256:83934cd597392b78",
    "doc": "https://airanking.cc/#doc",
    "change_rule_zh": "口径语义版本只在实际变更口径时递增；spec_hash 是决定口径的数值与字段集合的自动指纹。若 spec_hash 变化而 version 未变，应视为口径已变更。",
    "change_rule_en": "The semantic version is bumped only on a real methodology change; spec_hash is an automatic fingerprint of the numbers and field set that define the methodology. If spec_hash changes while version does not, treat the methodology as changed.",
    "spec_hash_covers": {
      "score_weights": {
        "anchor": 72,
        "ability": 16,
        "growth": 8,
        "cost": 4
      },
      "score_weights_app": {
        "anchor": 75,
        "growth": 12,
        "dist": 6,
        "rep": 5,
        "monet": 2
      },
      "req_in_cap": 64000,
      "cache_read_mult": 0.1,
      "cap_weights": {
        "intel": 0.5,
        "coding": 0.3,
        "agentic": 0.2
      },
      "preview_rule": "include pre-GA (preview) models in the main board; reversed the 2026-10-14 exclusion",
      "preview_present": [
        "cn",
        "global",
        "us"
      ],
      "trend_days": 6,
      "board_size": 50,
      "view_pool_caps": {
        "global": 200,
        "us": 200,
        "cn": 157
      },
      "candidate_pool": 595,
      "views": [
        "cn",
        "global",
        "us"
      ],
      "app_windows": [
        "day",
        "month",
        "week"
      ],
      "space_boards": [
        "likes",
        "trending"
      ],
      "mobile_group_size": 20,
      "mobile_groups": [
        "cn",
        "us"
      ],
      "mobile_group_members": [
        {
          "key": "cn",
          "members": [
            "cn",
            "hk",
            "mo",
            "tw"
          ]
        },
        {
          "key": "us",
          "members": [
            "us"
          ]
        }
      ],
      "mobile_manual": [],
      "app_score_rule": "agent score = anchor(adoption value) 75 + growth(momentum) 12 + dist(request share) 6, each normalised then weighted; rep / monet unavailable (no data source) => excluded, denominator renormalised over available terms (no median imputation)",
      "api_schema_rev": 2,
      "exposed_fields": {
        "models": [
          "capability_index",
          "composite_score",
          "has_price",
          "history",
          "index",
          "input_tokens_per_request",
          "model_code",
          "momentum",
          "name",
          "price_per_mtok_usd",
          "rank",
          "requests",
          "slug",
          "usage_value_share_pct",
          "usage_value_usd",
          "vendor",
          "vendor_region",
          "version"
        ],
        "agents": [
          "categories",
          "description",
          "history",
          "homepage",
          "index",
          "momentum",
          "rank",
          "request_share_pct",
          "requests",
          "score",
          "slug",
          "title",
          "usage_value_usd"
        ],
        "spaces": [
          "author",
          "created",
          "id",
          "index",
          "likes",
          "modified",
          "name",
          "rank",
          "sdk",
          "tags",
          "trend_score"
        ],
        "mobile": [
          "alias",
          "coverage_all_regions",
          "coverage_in_group",
          "developer",
          "manual",
          "markets",
          "name",
          "rank",
          "rank_all",
          "score"
        ]
      }
    },
    "composition_zh": "综合分权重（模型）：锚 72% / 能力 16% / 增长 8% / 成本 4%；（应用）：锚 75% / 增长 12% / 分发 6% / 口碑 5% / 变现 2%。能力指数内部权重（智能 / 编码 / 智能体）：0.5 / 0.3 / 0.2。",
    "composition_en": "Composite weights (models): anchor 72% / capability 16% / growth 8% / cost 4%; (apps): anchor 75% / growth 12% / distribution 6% / reputation 5% / monetization 2%. Capability Index sub-weights (intelligence / coding / agentic): 0.5 / 0.3 / 0.2.",
    "not_exposed": [
      {
        "zh": "源站环比 change —— 站点口径明确不在任何界面展示",
        "en": "Upstream change — the site's methodology deliberately shows it nowhere"
      },
      {
        "zh": "模型中文别名（zh / zhName）—— 仅用于站内搜索索引",
        "en": "Model Chinese aliases (zh / zhName) — used only for the site's search index"
      },
      {
        "zh": "逐模型能力分（intel / coding / agentic）—— 页面无该行，只公布其权重",
        "en": "Per-model capability scores (intel / coding / agentic) — no such row on the page; only their weight is published"
      },
      {
        "zh": "第三方新闻标题 —— 版权不属于本站可授权的范围",
        "en": "Third-party news headlines — copyright is outside what this site can license"
      }
    ]
  },
  "as_of": {
    "data_day": "2026-11-15",
    "collected_at": "2026-11-16T09:42:00+08:00",
    "collected_at_local": "2026-11-16 09:42 +0800",
    "generated_at": "2026-11-16T10:10:13+08:00",
    "history_days": 6,
    "snapshot_days": 51,
    "note_zh": "data_day 是源站按 UTC 记的自然日，与 collected_at 是两个独立刻度，不可互推。",
    "note_en": "data_day is the upstream's UTC calendar day; it is a separate scale from collected_at and cannot be derived from it."
  },
  "update": {
    "model_zh": "定时全量重建（非流式增量），每次重建整体重算并重新发布。站内资讯流随北京 08:00 / 20:00 两次重建一并刷新，但**不在本接口内**（接口不发第三方新闻）。",
    "model_en": "Scheduled full rebuild (not a streaming delta); each rebuild recomputes and republishes everything. The site's news stream refreshes together with the two daily rebuilds at 08:00 and 20:00 Beijing time, and is **not part of this API** (third-party news is not exposed).",
    "cadence_hours": 12,
    "rebuilds_per_day": 2,
    "schedule_local": [
      "08:00",
      "20:00"
    ],
    "schedule_timezone": "Asia/Shanghai",
    "last_scheduled_rebuild": "2026-11-16T08:00:00+08:00",
    "next_expected_rebuild": "2026-11-16T20:00:00+08:00",
    "freshness_zh": "数据日 = 源站 UTC 自然日。北京 08:00（UTC 00:00）前采集 → 数据日 = 北京日 − 2；08:00 后 → 北京日 − 1。因此数据日通常滞后采集时刻 1–2 天。",
    "freshness_en": "Data day is the upstream's UTC calendar day. Collected before 08:00 Beijing (UTC 00:00) -> data day = Beijing date - 2; after 08:00 -> Beijing date - 1. So the data day typically lags the collection moment by 1-2 days.",
    "guarantees_zh": [
      "每天 2 次全量重建（北京 08:00 / 20:00），每次重建刷新 generated_at。",
      "任一时刻返回的都是最近一次成功构建的产物；单场失败不会写入线上，线上不会回退到离线或缓存数据。",
      "采集走了离线回退的那一场只更新本地、不发布 —— 本接口不会返回离线回退数据。",
      "data_day 与 collected_at 始终成对给出，两者是独立刻度，不互相推导。",
      "历史序列不做插值、不做平滑，只由真实数据日构成。",
      "口径变更只通过 methodology.version 与 spec_hash 体现；字段只增不删、不改变已有字段含义。"
    ],
    "guarantees_en": [
      "2 full rebuilds per day (Beijing 08:00 / 20:00); every rebuild refreshes generated_at.",
      "Every response reflects the most recent successful build; a failed run is never published and the live site never falls back to offline or cached data.",
      "Any run that falls back to offline data updates the local copy only and is not published -- this API never serves offline-fallback data.",
      "data_day and collected_at are always given together; they are independent scales.",
      "Historical series are never interpolated or smoothed; they are built from real data days only.",
      "Methodology changes surface only via methodology.version and spec_hash; fields are additive and never change meaning."
    ],
    "not_guaranteed_zh": [
      "不保证数据日实时 —— 见 freshness。",
      "不保证覆盖全行业 —— 应用值是采样平台口径，是行业子集，不等于厂商整体规模，也不是厂商实收。",
      "不保证绝对精确 —— 是估算值，只适合作横向相对比较。",
      "不提供 SLA / uptime 承诺，本接口是免费只读端点。",
      "不提供任意历史日期的完整榜单归档，只提供最近若干数据日的走势序列（history）。"
    ],
    "not_guaranteed_en": [
      "The data day is not real-time -- see freshness.",
      "Coverage is not the whole industry; Adoption Value is a sampled-platform basis, a subset of the industry, not a vendor's overall scale or realized revenue.",
      "Figures are estimates and are meant for relative comparison, not absolute precision.",
      "No SLA or uptime commitment; this is a free read-only endpoint.",
      "No full-board archive for arbitrary past dates; only the recent trend series (history) is provided."
    ]
  },
  "license": {
    "upstream": {
      "name": "OpenRouter rankings",
      "url": "https://openrouter.ai/rankings",
      "license": "CC BY 4.0",
      "attribution_required": true
    },
    "derivative": {
      "license": "CC BY 4.0",
      "note_zh": "本站的复合指标与排名是在上游公开数据上的衍生结果。",
      "note_en": "The composite metrics and rankings here are derivative works built on the upstream public data."
    },
    "attribution": {
      "upstream_required_text": "Source: OpenRouter (openrouter.ai/rankings), as of 2026-11-16T01:42:41.581Z.",
      "ours_required_text": "AI Ranking (https://airanking.cc), data day 2026-11-15",
      "example": "Source: OpenRouter (openrouter.ai/rankings), as of 2026-11-16T01:42:41.581Z. Ranking: AI Ranking (https://airanking.cc), data day 2026-11-15."
    },
    "restrictions_zh": [
      "署名必须保留，不得移除或隐去来源与数据日。",
      "不得将本接口返回的衍生数据、或上游原始数据原样转发为竞争性的免费 API；需要上游原始逐日 Token 数据请直接调用 OpenRouter 官方 Data API。"
    ],
    "restrictions_en": [
      "Attribution must be preserved; do not remove or obscure the source or the data day.",
      "Do not re-serve the derivative data from this API, or the upstream raw data, as a competing free API; for upstream raw daily token data use the OpenRouter official Data API directly."
    ]
  },
  "disclaimer": {
    "summary_zh": "榜单不一定完整（不是完备枚举）；数值为基于公开数据与固定公式的估算值，不是厂商公布的真实营收，也不等于全市场规模，只适合横向相对比较。仅供参考，不构成投资建议或商业决策依据。",
    "summary_en": "The board is not an exhaustive enumeration; figures are estimates derived from public data by a fixed formula, not vendor-reported revenue and not the whole market, and are only suitable for relative comparison. For reference only; not investment advice or a basis for business decisions.",
    "full": "https://airanking.cc/#doc",
    "error_bound": "「方法论与口径」页的「已知偏差（必须披露）」逐条列出主要误差来源。"
  },
  "fields": {
    "models": {
      "rank": {
        "type": "int",
        "zh": "排名（该视图内，1 起）",
        "en": "Rank within the selected view (1-based)",
        "source": "rank"
      },
      "name": {
        "type": "string",
        "zh": "模型名称（榜单展示名）",
        "en": "Model name as shown on the board",
        "source": "name"
      },
      "vendor": {
        "type": "string",
        "zh": "厂商",
        "en": "Vendor",
        "source": "vendor"
      },
      "vendor_region": {
        "type": "string",
        "zh": "厂商总部归属：us / cn / intl",
        "en": "Vendor HQ region: us / cn / intl",
        "source": "region"
      },
      "version": {
        "type": "string",
        "zh": "版本号（YY.MM.DD 压缩写法，同站点）",
        "en": "Version tag (compressed YY.MM.DD)",
        "source": "ver"
      },
      "slug": {
        "type": "string",
        "zh": "模型 slug（本站唯一键）",
        "en": "Model slug (site-wide unique key)",
        "source": "slug"
      },
      "model_code": {
        "type": "string",
        "zh": "源站模型标识",
        "en": "Upstream model identifier",
        "source": "code"
      },
      "usage_value_usd": {
        "type": "number",
        "zh": "大规模应用值（美元估计量：调用规模 × 挂牌单价，源站 week 窗口）",
        "en": "Adoption Value (estimated USD: call scale × list price, source week window)",
        "source": "val"
      },
      "momentum": {
        "type": "number",
        "zh": "动量（三窗口日均强度之比 − 1）",
        "en": "Momentum (ratio of daily intensity across windows, minus 1)",
        "source": "mom"
      },
      "index": {
        "type": "number",
        "zh": "相对值（应用值相对该视图榜首的百分比，榜首 = 100；只是换个标尺，不是独立指标）",
        "en": "Relative value (Adoption Value as a percentage of the view leader, leader = 100; a rescaled view, not an independent metric)",
        "source": "index"
      },
      "capability_index": {
        "type": "number|null",
        "zh": "能力指数（0–100，第三方评测的智能 / 编码 / 智能体三个子分各自归一后按 50/30/20 加权；无评测覆盖为 null）",
        "en": "Capability Index (0-100; third-party intelligence / coding / agentic sub-scores, each normalised then weighted 50/30/20; null when uncovered)",
        "source": "cap"
      },
      "composite_score": {
        "type": "number",
        "zh": "综合分（应用值 72% + 能力指数 16% + 增长 8% + 成本效率 4%）",
        "en": "Composite score (Adoption Value 72% + Capability 16% + Growth 8% + Cost efficiency 4%)",
        "source": "score"
      },
      "has_price": {
        "type": "bool",
        "zh": "定价库是否覆盖该模型",
        "en": "Whether the pricing library covers this model",
        "source": "hasPrice"
      },
      "price_per_mtok_usd": {
        "type": "object|null",
        "zh": "每百万 Token 单价 {input, output, blended}",
        "en": "Price per Mtok {input, output, blended}",
        "source": "pin / pout / blend"
      },
      "requests": {
        "type": "int",
        "zh": "同一窗口的请求数",
        "en": "Requests in the same window",
        "source": "req"
      },
      "input_tokens_per_request": {
        "type": "int|null",
        "zh": "单次输入（该窗口平均每次请求的输入 token）",
        "en": "Input per call (average input tokens per request in this window)",
        "source": "inreq"
      },
      "usage_value_share_pct": {
        "type": "number",
        "zh": "应用值份额（%）",
        "en": "adoption-value share (%)",
        "source": "valshare"
      },
      "history": {
        "type": "object",
        "zh": "走势 {days, usage_value_usd, degraded}；与「大规模应用值」同口径同窗口",
        "en": "Trend {days, usage_value_usd, degraded}; same basis and window as Adoption Value",
        "source": "histLab / hist / histDeg"
      }
    },
    "agents": {
      "rank": {
        "type": "int",
        "zh": "排名（1 起）",
        "en": "Rank (1-based)",
        "source": "rank"
      },
      "title": {
        "type": "string",
        "zh": "应用名称",
        "en": "App title",
        "source": "title"
      },
      "slug": {
        "type": "string",
        "zh": "应用 slug（本站唯一键）",
        "en": "App slug (site-wide unique key)",
        "source": "slug"
      },
      "categories": {
        "type": "string[]",
        "zh": "分类标签",
        "en": "Category tags",
        "source": "cats"
      },
      "homepage": {
        "type": "string",
        "zh": "官网地址",
        "en": "Homepage URL",
        "source": "url"
      },
      "description": {
        "type": "string",
        "zh": "描述",
        "en": "Description",
        "source": "desc"
      },
      "usage_value_usd": {
        "type": "number",
        "zh": "应用值（美元估计量：Token 用量 × 平台加权平均挂牌单价）",
        "en": "Adoption Value (estimated USD: token usage × platform weighted average list price)",
        "source": "val"
      },
      "requests": {
        "type": "int",
        "zh": "请求数",
        "en": "Requests",
        "source": "req"
      },
      "request_share_pct": {
        "type": "number",
        "zh": "请求份额（%）",
        "en": "Request share (%)",
        "source": "reqshare"
      },
      "momentum": {
        "type": "number",
        "zh": "动量",
        "en": "Momentum",
        "source": "mom"
      },
      "score": {
        "type": "number",
        "zh": "综合分（应用值 75% + 动量 12% + 请求份额 6%，各自归一后加权；口碑 / 商业化无数据来源不计入）",
        "en": "Score (Adoption Value 75% + Momentum 12% + Request share 6%, each normalised then weighted; reputation / monetisation excluded for lack of a data source)",
        "source": "ascore"
      },
      "index": {
        "type": "number",
        "zh": "相对值（应用值相对榜首的百分比，榜首 = 100）",
        "en": "Relative value (percentage of the leader, leader = 100)",
        "source": "index"
      },
      "history": {
        "type": "object",
        "zh": "走势 {days, usage_value_usd}",
        "en": "Trend {days, usage_value_usd}",
        "source": "histLab / hist"
      }
    },
    "spaces": {
      "rank": {
        "type": "int",
        "zh": "排名（1 起）",
        "en": "Rank (1-based)",
        "source": "rank"
      },
      "id": {
        "type": "string",
        "zh": "Spaces 仓库 id（author/name）",
        "en": "Spaces repo id (author/name)",
        "source": "id"
      },
      "name": {
        "type": "string",
        "zh": "项目名",
        "en": "Project name",
        "source": "name"
      },
      "author": {
        "type": "string",
        "zh": "作者",
        "en": "Author",
        "source": "author"
      },
      "likes": {
        "type": "int",
        "zh": "累计 Likes",
        "en": "Cumulative likes",
        "source": "likes"
      },
      "trend_score": {
        "type": "number|null",
        "zh": "近期热度分（仅 trending 榜有值）",
        "en": "Recent trend score (only on the trending board)",
        "source": "trend"
      },
      "sdk": {
        "type": "string",
        "zh": "SDK",
        "en": "SDK",
        "source": "sdk"
      },
      "modified": {
        "type": "string",
        "zh": "最后更新时间（YYYY-MM-DD）",
        "en": "Last modified (YYYY-MM-DD)",
        "source": "mod"
      },
      "created": {
        "type": "string",
        "zh": "创建时间（YYYY-MM-DD）",
        "en": "Created (YYYY-MM-DD)",
        "source": "created"
      },
      "tags": {
        "type": "string[]",
        "zh": "标签",
        "en": "Tags",
        "source": "tags"
      },
      "index": {
        "type": "number",
        "zh": "相对值（相对榜首的百分比，榜首 = 100）",
        "en": "Relative value (percentage of the leader, leader = 100)",
        "source": "index"
      }
    },
    "mobile": {
      "rank": {
        "type": "int",
        "zh": "组内位次（1 起）",
        "en": "Rank within the group (1-based)",
        "source": "rank"
      },
      "rank_all": {
        "type": "int|null",
        "zh": "全区域参考位次",
        "en": "All-region reference rank",
        "source": "rank_all"
      },
      "name": {
        "type": "string",
        "zh": "应用名称",
        "en": "App name",
        "source": "name"
      },
      "alias": {
        "type": "string|null",
        "zh": "其他市场使用的别名",
        "en": "Alias used in other markets",
        "source": "alias"
      },
      "developer": {
        "type": "string",
        "zh": "开发者",
        "en": "Developer",
        "source": "dev"
      },
      "score": {
        "type": "number",
        "zh": "覆盖度加权得分",
        "en": "Coverage-weighted score",
        "source": "score"
      },
      "manual": {
        "type": "bool",
        "zh": "是否人工指定纳入（名称不含 AI 关键词，人工复核放行；2026-10-20 起）",
        "en": "Included by manual review rather than keyword matching (since 2026-10-20)",
        "source": "man"
      },
      "coverage_in_group": {
        "type": "int",
        "zh": "组内覆盖市场数",
        "en": "Markets covered within the group",
        "source": "cover"
      },
      "coverage_all_regions": {
        "type": "int",
        "zh": "全区域覆盖市场数",
        "en": "Markets covered across all regions",
        "source": "cover_all"
      },
      "markets": {
        "type": "object[]",
        "zh": "各国市场明细 [{country_code, country_name, rank, name, developer}]",
        "en": "Per-market detail [{country_code, country_name, rank, name, developer}]",
        "source": "subs"
      }
    }
  },
  "counts": {
    "models_global": 50,
    "models_us": 50,
    "models_cn": 50,
    "models_preview_global": 0,
    "models_preview_us": 0,
    "models_preview_cn": 0,
    "agents": {
      "day": 20,
      "month": 20,
      "week": 20
    },
    "spaces": {
      "likes": 50,
      "trending": 50
    },
    "mobile_groups": [
      {
        "key": "cn",
        "label": "中国（含港澳台）",
        "count": 20,
        "total": 26
      },
      {
        "key": "us",
        "label": "美国",
        "count": 5,
        "total": 5
      }
    ],
    "mobile_regions_ok": 36,
    "mobile_regions_total": 36
  }
}
