{
  "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"
  },
  "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": {
    "cadence_hours": 12,
    "rebuilds_per_day": 2,
    "schedule_local": [
      "08:00",
      "20:00"
    ],
    "schedule_timezone": "Asia/Shanghai",
    "next_expected_rebuild": "2026-11-16T20:00:00+08:00",
    "docs": "https://airanking.cc/api/#update"
  },
  "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."
    ]
  },
  "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
  },
  "endpoints": [
    {
      "path": "/api/v1/index.json",
      "url": "https://airanking.cc/api/v1/index.json",
      "zh": "接口目录（本文件）",
      "en": "Service index",
      "items": null
    },
    {
      "path": "/api/v1/meta.json",
      "url": "https://airanking.cc/api/v1/meta.json",
      "zh": "口径版本 · 更新承诺 · 许可 · 字段契约",
      "en": "Methodology version, update commitment, license, field contract",
      "items": null
    },
    {
      "path": "/api/v1/models.json",
      "url": "https://airanking.cc/api/v1/models.json",
      "zh": "基础模型榜（全球视图，默认）",
      "en": "Base model board (global view, default)",
      "items": 50
    },
    {
      "path": "/api/v1/models-us.json",
      "url": "https://airanking.cc/api/v1/models-us.json",
      "zh": "基础模型榜（美国视图）",
      "en": "Base model board (US view)",
      "items": 50
    },
    {
      "path": "/api/v1/models-cn.json",
      "url": "https://airanking.cc/api/v1/models-cn.json",
      "zh": "基础模型榜（中国大陆视图）",
      "en": "Base model board (China mainland view)",
      "items": 50
    },
    {
      "path": "/api/v1/agents.json",
      "url": "https://airanking.cc/api/v1/agents.json",
      "zh": "AI Agents 榜（week 窗口，默认）",
      "en": "AI Agents board (week window, default)",
      "items": 20
    },
    {
      "path": "/api/v1/agents-day.json",
      "url": "https://airanking.cc/api/v1/agents-day.json",
      "zh": "AI Agents 榜（day 窗口）",
      "en": "AI Agents board (day window)",
      "items": 20
    },
    {
      "path": "/api/v1/agents-month.json",
      "url": "https://airanking.cc/api/v1/agents-month.json",
      "zh": "AI Agents 榜（month 窗口）",
      "en": "AI Agents board (month window)",
      "items": 20
    },
    {
      "path": "/api/v1/spaces.json",
      "url": "https://airanking.cc/api/v1/spaces.json",
      "zh": "开源空间榜（按累计 Likes）",
      "en": "Open-source spaces board (by cumulative likes)",
      "items": 50
    },
    {
      "path": "/api/v1/mobile.json",
      "url": "https://airanking.cc/api/v1/mobile.json",
      "zh": "移动端热度榜（两组并列）",
      "en": "Mobile app heat board (two groups side by side)",
      "items": 25
    }
  ],
  "fields_doc": "/api/v1/meta.json#fields"
}
