# 实时电影票房 实时获取猫眼当日电影票房 Top 10，包含累计票房、实时票房、票房占比、排片占比、上座率等核心指标。数据来源猫眼专业版，按 60 秒缓存。 ## 平台约定 - 网关：`https://v1.apizero.cn` - 鉴权：`Authorization: Bearer `（兼容 X-API-Key 与 Query api_key / apikey / key） - 回包：`{ code, msg, data, tips, request_id }`。成功看 `code === 0` ## 1. 基本信息 | 字段 | 值 | | --- | --- | | 接口标识 | `movie-box` | | 接口名称 | 实时电影票房 | | 接口地址 | `https://v1.apizero.cn/api/movie-box` | | 请求方法 | `GET` | | 分类 | 生活服务 | | 提供方 | 极数本源 | | 计费模式 | 完全免费 | | QPS 限制 | QPS 3 | | 登录免费额度 | 20,000 次 | | 匿名每日额度 | 1,000 次 | ### 会员每日额度 | 会员档位 | 每日免费 | QPS | | --- | --- | --- | | 黄金会员 | 50,000 次/日 | QPS 10 | | 钻石会员 | 100,000 次/日 | QPS 30 | | 企业会员 | 1,000,000 次/日 | QPS 120 | ## 2. 认证 匿名可调用：QPS 2、日 100 次；登录后：QPS 10、日 2000 次。 获取 API Key：https://apizero.cn/account/keys ## 3. 请求参数 | 参数 | 类型 | 必填 | 说明 | 示例 | | --- | --- | --- | --- | --- | | — | — | — | 无 | — | ## 6. 响应字段 顶层固定 code / msg / data。下表一般是 data 内字段。 | 字段 | 类型 | 说明 | | --- | --- | --- | | `update_time` | `string` | 本次回源/缓存生成时间（YYYY-MM-DD HH:mm:ss） | | `total` | `number` | 榜单条数（通常为 10） | | `list` | `array` | 电影列表 | | `list[].rank` | `number` | 排名（1 起） | | `list[].name` | `string` | 电影名 | | `list[].release_days` | `string` | 上映情况（如「上映6天」） | | `list[].total_box` | `string` | 累计票房（保留中文单位「亿/万」便于展示，如「2.66亿」「6205.9万」） | | `list[].box_office` | `number` | 实时票房（单位：万元） | | `list[].box_rate` | `number` | 票房占比 %（极小值 <0.1% 统一返回 0.1） | | `list[].show_rate` | `number` | 排片占比 % | | `list[].seat_rate` | `number` | 上座率 % | | `tips` | `string` | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ## 7. 响应示例 ```json { "code": 0, "msg": "成功", "data": { "update_time": "2026-05-06 07:30:00", "total": 10, "list": [ { "rank": 1, "name": "消失的人", "release_days": "上映6天", "total_box": "2.66亿", "box_office": 163.25, "box_rate": 35.5, "show_rate": 28.8, "seat_rate": 33 }, { "rank": 2, "name": "给阿嬷的情书", "release_days": "上映7天", "total_box": "6205.9万", "box_office": 98.85, "box_rate": 21.5, "show_rate": 7.3, "seat_rate": 6.1 } ] }, "request_id": "mot9...", "tips": "极数本源 · https://apizero.cn" } ``` ## 5. 请求示例 Python / JavaScript 各有常规写法和官方库（`pip install apizero` / 浏览器与 Vue、React 使用 `@apex-origin/apizero`）。成功后先判断 `code == 0` 再读 `data`。 ### cURL ```bash curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/movie-box" ``` ### Python ```python # 服务端常规写法：标准库 urllib，不用 pip import json import ssl import urllib.error import urllib.parse import urllib.request key = "YOUR_API_KEY" url = "https://v1.apizero.cn/api/movie-box" params = {} query = urllib.parse.urlencode({k: "" if v is None else str(v) for k, v in params.items()}) req = urllib.request.Request( url + ("?" + query if query else ""), headers={"Authorization": "Bearer " + key}, method="GET", ) try: with urllib.request.urlopen( req, timeout=20, context=ssl.create_default_context() ) as resp: raw = resp.read().decode("utf-8") except urllib.error.HTTPError as e: raw = e.read().decode("utf-8", "replace") body = json.loads(raw) print(json.dumps(body, ensure_ascii=False, indent=2)) if body.get("code") == 0: print(body.get("data")) ``` ### Python 官方库 ```python # 官方库（服务端）：先执行一次 pip install apizero import apizero key = "YOUR_API_KEY" client = apizero.key(key) r = client.movie_box() if not r.ok: raise RuntimeError(r.msg) print(r.ok, r.code) print(r.json) ``` ### JavaScript ```javascript // 服务端 Node 18+ fetch const key = "YOUR_API_KEY"; const url = "https://v1.apizero.cn/api/movie-box"; const res = await fetch(url, { headers: { Authorization: `Bearer ${key}` }, }); const body = await res.json(); console.log(body); if (body.code === 0) console.log(body.data); ``` ### JavaScript 官方库（Node） ```javascript // 官方库（服务端 Node）：先执行一次 npm install @apex-origin/apizero const { key } = require("@apex-origin/apizero"); // ESM: import { key } from "@apex-origin/apizero"; const apiKey = "YOUR_API_KEY"; const client = key(apiKey); const r = await client.movie_box(); if (!r.ok) throw new Error(r.msg); console.log(r.ok, r.code); console.log(r.json); ``` ### Go ```go // 服务端常规写法：net/http package main import ( "fmt" "io" "net/http" ) func main() { key := "YOUR_API_KEY" url := "https://v1.apizero.cn/api/movie-box" req, err := http.NewRequest(http.MethodGet, url, nil) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+key) resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() raw, _ := io.ReadAll(resp.Body) fmt.Println(string(raw)) } ``` ### Java ```java // 服务端常规写法：Java 11+ HttpClient // Jackson：com.fasterxml.jackson.databind.ObjectMapper import com.fasterxml.jackson.databind.JsonNode; import com.fasterxml.jackson.databind.ObjectMapper; import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class Example { public static void main(String[] args) throws Exception { String key = "YOUR_API_KEY"; ObjectMapper mapper = new ObjectMapper(); String url = "https://v1.apizero.cn/api/movie-box"; HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build(); HttpRequest req = HttpRequest.newBuilder() .uri(URI.create(url)) .header("Authorization", "Bearer " + key) .timeout(Duration.ofSeconds(20)) .GET() .build(); HttpResponse resp = client.send(req, HttpResponse.BodyHandlers.ofString()); JsonNode body = mapper.readTree(resp.body()); System.out.println(resp.body()); if (body.path("code").asInt() == 0) { System.out.println(body.path("data")); } } } ``` ### PHP ```php true, CURLOPT_TIMEOUT => 20, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer '.$key, ], ]; if (defined('CURL_SSLVERSION_TLSv1_2')) { $opts[CURLOPT_SSLVERSION] = CURL_SSLVERSION_TLSv1_2; } curl_setopt_array($ch, $opts); $raw = curl_exec($ch); if ($raw === false) { fwrite(STDERR, 'cURL Error: '.curl_error($ch).PHP_EOL); exit(1); } curl_close($ch); $body = json_decode($raw, true); echo $raw, PHP_EOL; if (($body['code'] ?? null) === 0) { echo json_encode($body['data'] ?? null, JSON_UNESCAPED_UNICODE), PHP_EOL; } ``` ### Rust ```rust // 服务端常规写法 // cargo add reqwest --features json,blocking ; cargo add serde_json use reqwest::blocking::Client; use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION}; use serde_json::Value; fn main() -> Result<(), Box> { let key = "YOUR_API_KEY"; let url = "https://v1.apizero.cn/api/movie-box"; let mut headers = HeaderMap::new(); headers.insert( AUTHORIZATION, HeaderValue::from_str(&format!("Bearer {key}"))?, ); let body: Value = Client::new() .get(url) .headers(headers) .timeout(std::time::Duration::from_secs(20)) .send()? .json()?; println!("{}", serde_json::to_string_pretty(&body)?); Ok(()) } ``` ## 8. 错误码 先看业务 code。HTTP 也可能不是 200。 | 业务码 | HTTP | 说明 | | --- | --- | --- | | 0 | 200 | 成功 | | 4000 | 400 | 参数错误 | | 4011 | 401 | API Key 无效 | | 4013 | 403 | API Key 已暂停 | | 4014 | 403 | 当前 IP 不在 Key 白名单 | | 4015 | 401 | 此接口需要 API Key | | 4022 | 402 | 余额不足 | | 4029 | 429 | 调用过快（QPS） | | 4030 | 429 | 今日免费额度已用完 | | 4040 | 503 | 接口已下线 | | 4041 | 404 | 接口不存在 | | 5000 | 500 | 服务器内部错误 | | 5020 | 502 | 上游暂时不可用 | | 5021 | 502 | 上游返回格式异常 | | 5030 | 502 | 暂无可用节点 | ## 9. 变更日志 - **1.0.0** (2026-05-06): 首次发布：Top 10 实时票房 + 累计票房、票房占比、排片占比、上座率