ICP 备案查询
icpGEThttps://v1.apizero.cn/api/icp概述
通过域名查询工信部 ICP 备案信息,返回备案号、网站名称、主办单位、单位性质(企业/个人/事业单位等)和审核通过时间。 • 自动域名清洗:自动剥离 https?:// 协议、/path 路径、:port 端口、www. 前缀,无论传入 https://www.baidu.com/abc 还是 baidu.com 都正确识别 • 已备案 → is_filed=true,返回原 6 字段(domain / is_filed / icp_code / site_name / company_name / company_type / audit_time),并补上 main_licence / content_type / limit_access;未备案/境外/已注销 → is_filed=false,返回空字段(非错误,便于前端 if 判断) • 缓存策略:已备案 24 小时缓存(变更频率低),未备案 1 小时缓存(避免新备案被长期误判)
调用约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/icp/raw.md鉴权
匿名每日 30 次、QPS 2;登录用户每日 100 次、QPS 5(全部免费)。已备案数据缓存 24 小时,未备案数据缓存 1 小时。
获取 API Key:获取 API Key/account/keys
请求头
推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。
| Header | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 否 | 推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。匿名可不传,受每日免费额度限制。 |
请求参数
GET · QUERY STRING · https://v1.apizero.cn/api/icp?domain=baidu.com
要查询的域名,支持完整 URL 输入(自动剥离协议/路径/端口/www)。例如:baidu.com、https://www.baidu.com/abc、m.baidu.com:8080/foo 都等价
例baidu.com
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| domain(域名) | string | 是 | 要查询的域名,支持完整 URL 输入(自动剥离协议/路径/端口/www)。例如:baidu.com、https://www.baidu.com/abc、m.baidu.com:8080/foo 都等价 | baidu.com |
返回结果
顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id
查询的主域名(已剥离协议/路径/www)
是否已备案:true=已备案 / false=未备案、境外、已注销
网站备案号(服务号),如「京ICP证030173号-1」;未备案时为空字符串。字段名与含义不变。
主体备案号,如「京ICP证030173号」;没有则为空字符串。旧客户端可忽略。
网站名称(多个名称用分号分隔,如「京东商城;京东多媒体网」)。部分来源无此栏时为空。
主办单位名称(公司或个人姓名)
主办单位性质:企业/个人/事业单位/政府机关/社会团体等
审核通过时间,格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss(取决于服务存档精度)
服务前置审批项;没有则为空字符串。
是否限制接入,如「是」「否」;没有则为空字符串。
品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 |
|---|---|---|
| domain | string | 查询的主域名(已剥离协议/路径/www) |
| is_filed | boolean | 是否已备案:true=已备案 / false=未备案、境外、已注销 |
| icp_code | string | 网站备案号(服务号),如「京ICP证030173号-1」;未备案时为空字符串。字段名与含义不变。 |
| main_licence | string | 主体备案号,如「京ICP证030173号」;没有则为空字符串。旧客户端可忽略。 |
| site_name | string | 网站名称(多个名称用分号分隔,如「京东商城;京东多媒体网」)。部分来源无此栏时为空。 |
| company_name | string | 主办单位名称(公司或个人姓名) |
| company_type | string | 主办单位性质:企业/个人/事业单位/政府机关/社会团体等 |
| audit_time | string | 审核通过时间,格式 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss(取决于服务存档精度) |
| content_type | string | 服务前置审批项;没有则为空字符串。 |
| limit_access | string | 是否限制接入,如「是」「否」;没有则为空字符串。 |
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn |
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"domain": "baidu.com",
"is_filed": true,
"icp_code": "京ICP证030173号-1",
"main_licence": "京ICP证030173号",
"site_name": "百度一下,你就知道",
"company_name": "北京百度网讯科技有限公司",
"company_type": "企业",
"audit_time": "2019-05-16 16:06:21",
"content_type": "",
"limit_access": "否"
},
"request_id": "abc123def456",
"tips": "极数本源 · https://apizero.cn"
}请求示例
示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。
curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/icp?domain=baidu.com"错误码
先看业务 code。HTTP 也可能不是 200。
成功
参数错误
API Key 无效
API Key 已暂停
当前 IP 不在 Key 白名单
此接口需要 API Key
余额不足
调用过快(QPS)
今日免费额度已用完
接口已下线
接口不存在
服务器内部错误
上游暂时不可用
上游返回格式异常
暂无可用节点
| 业务码 | 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 | 暂无可用节点 |
调用限制
- 计费模式
- 完全免费
- QPS 限制
- QPS 20
- 登录免费额度
- 100 次(已认证)
- 匿名每日额度
- 30 次(无 API Key)
- 黄金会员
- 每天 50,000 次 · QPS 20
- 钻石会员
- 每天 100,000 次 · QPS 30
- 企业会员
- 每天 1,000,000 次 · QPS 120
| 计费模式 | 完全免费 |
|---|---|
| QPS 限制 | QPS 20 |
| 登录免费额度 | 100 次(已认证) |
| 匿名每日额度 | 30 次(无 API Key) |
| 黄金会员 | 每天 50,000 次 · QPS 20 |
| 钻石会员 | 每天 100,000 次 · QPS 30 |
| 企业会员 | 每天 1,000,000 次 · QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
更新日志
- 1.1.02026-09-19
兼容新增 main_licence、content_type、limit_access 原 6 个字段名和含义不变,旧客户端不用改
免责声明
备案数据采集自工信部公开数据源,仅供参考。子域名(如 m.baidu.com)会自动归并到主域名(baidu.com)查询。境外域名(.com 中无中国 ICP)和未备案域名均返回 is_filed=false。