加载接口文档…
访问量计数器
APISVG/JSON访问量计数器，支持多套动效主题卡片（咒纹夜/术式蓝焰/五条悟风/无量空处/宿傩咒印等），可嵌入GitHub README或网站。按站点隔离计数。
由 极数本源 提供·更新于 今天
7K
累计调用
3ms
平均响应
100.00%
服务可用性
1,000 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 500 次 · QPS 2
登录免费
当前方案每日 1,000 次 · QPS 3
黄金会员
每日 50,000 次 · QPS 10
钻石会员
每日 100,000 次 · QPS 30
企业会员
企业接口额度 · QPS 120
接入文档
在线工具
接口请求地址
https://v1.apizero.cn/api/visits-counter
接口请求方式
GET
请求参数格式
QUERY STRING
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/visits-counter?site=apizero.cn&name=home&mode=total&theme=gojo_board&format=svg&length=7&no_increment=0
接口信息备注
匿名调用 500 次/天，登录后 1000 次/天，API Key 按你的额度计算。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| site | string | 可选 · 站点标识，用于区分不同来源（建议传你的域名）。不传时全局共享一个计数器。 · 示例：apizero.cn |
| name | string | 可选 · 计数器名称，同一站点下可挂多个不同位置（首页/产品页/文章页等）。默认 demo。 · 示例：home |
| mode | string | 可选 · 计数模式：daily=每日清零 / total=累计不清零。默认 daily。 · 示例：total |
| theme | string | 可选 · 主题：默认 gojo_board（像素角色举牌+数字 GIF 动画）。可选 gojo_board/hoops_board/zero_board/jjk_infinity/rule34/moebooru/gelbooru/cursed_night/seal_blue/talisman_red/void_gold/gojo_satoru/infinity_void/sukuna_mark。前 7 个为像素牌主题（角色帧动画），后 7 个为 SVG 渐变主题。 · 示例：gojo_board |
| format | string | 可选 · 输出格式：svg（默认，可直接 <img> 嵌入网页）/ png（静态图，scale=1~4）/ json（原始 JSON 数据，便于自集成）。 · 示例：svg |
| length | int | 可选 · 数字位数 4~12，默认 7（前导补 0）。 · 示例：7 |
| no_increment | int | 可选 · 只读模式：1=只查询不递增（适合预览/调试）。默认 0。 · 示例：0 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。 |
返回字段说明
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | string | 业务码：200 成功，4xxx/5xxx 错误 | ||||||||||||||||||||||||||||||||||||||||||||||||
| desc | string | 业务描述（success / 错误原因） | ||||||||||||||||||||||||||||||||||||||||||||||||
| data | object | 业务数据（仅 format=json 时返回；format=svg/png 时直接返回图片二进制） | ||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||||||||
返回示例
{
"code": "200",
"desc": "success",
"data": {
"name": "home",
"mode": "daily",
"theme": "gojo_board",
"theme_name": "像素牌-苍空",
"value": 42,
"display_value": "0000042",
"record": {
"total": 1024,
"daily": 42,
"day": "2026-05-09",
"updated_at": "2026-05-09T21:48:52+08:00"
},
"incremented": true,
"step": 1,
"length": 7,
"format": "json"
},
"tips": "极数本源 · https://apizero.cn"
}