运行中免费开发工具

访问量计数器

API

SVG/JSON访问量计数器，支持多套动效主题卡片（咒纹夜/术式蓝焰/五条悟风/无量空处/宿傩咒印等），可嵌入GitHub README或网站。按站点隔离计数。

文档

由极数本源提供·更新于今天

累计调用

2ms

平均响应

100.00%

服务可用性

1,000 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 10

今日已用 0 / 1,000 次/日0.0%

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每日 500 次 · QPS 5

登录免费

当前方案

每日 1,000 次 · QPS 10

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

https://apizero.cn/aidocs/visits-counter/raw.md

接口请求地址

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 时直接返回图片二进制）
data.name	string	计数器名称（与请求参数 name 一致）
data.mode	string	计数模式：daily / total
data.theme	string	生效的主题键（不识别会回退 gojo_board）
data.theme_name	string	主题中文名（前端可直接显示）
data.value	int	当前计数值（按 mode 取 daily 或 total）
data.display_value	string	前导补 0 的展示值，与 SVG 上数字一致
data.record	object	完整计数记录
data.record.total	int	历史累计计数
data.record.daily	int	今日计数
data.record.day	string	今日日期（YYYY-MM-DD）
data.record.updated_at	string	记录最近更新时间（ISO8601）
data.incremented	bool	本次调用是否已自增
data.step	int	本次自增步长
data.length	int	生效的数字位数
data.format	string	生效的输出格式
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"
}

加载接口文档…

名称

类型

说明

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 时直接返回图片二进制）

data.name

string

计数器名称（与请求参数 name 一致）

data.mode

string

计数模式：daily / total

data.theme

string

生效的主题键（不识别会回退 gojo_board）

data.theme_name

string

主题中文名（前端可直接显示）

data.value

int

当前计数值（按 mode 取 daily 或 total）

data.display_value

string

前导补 0 的展示值，与 SVG 上数字一致

data.record

object

完整计数记录

data.record.total

int

历史累计计数

data.record.daily

int

今日计数

data.record.day

string

今日日期（YYYY-MM-DD）

data.record.updated_at

string

记录最近更新时间（ISO8601）

data.incremented

bool

本次调用是否已自增

data.step

int

本次自增步长

data.length

int

生效的数字位数

data.format

string

生效的输出格式

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" }