ICP备案查询V2 API 文档

接口说明

本API用于查询网站ICP备案信息。实时获取域名备案详情，包括备案号、主体信息、备案省份、网站状态等。支持查询已备案和未备案状态，数据准确可靠。

调用地址

https://openapi.xunjinlu.fun/api/icp/v2.php

请求方式

GET

密钥要求

必须密钥 - 调用本接口必须提供有效的访问密钥

鉴权方式

本接口支持以下三种鉴权方式：

• Query 参数：通过URL参数传递密钥
• Header：通过请求头 X-API-Key 传递密钥
• Bearer Token：通过 Authorization 请求头传递Bearer令牌

计费说明

免费接口 - 调用本接口不消耗积分

频率限制

每分钟约 60 次请求

请求参数

参数列表

参数说明

key

• 类型：字符串
• 必填：是
• 说明：接口访问密钥，用于身份验证和权限校验。需在本平台申请获取有效密钥。
• 格式：以 sk_ 开头的字符串

domain

• 类型：字符串
• 必填：是
• 说明：需要查询ICP备案信息的域名。支持纯域名格式（如 baidu.com）或带协议前缀的URL格式（如 https://www.baidu.com）。系统会自动提取域名部分进行查询。
• 注意：请勿包含路径、查询参数等无关内容

请求示例

示例1：Query参数鉴权

GET /api/icp/v2.php?key=sk_xxxxxxxxxxxxxxxx&domain=baidu.com HTTP/1.1
Host: openapi.xunjinlu.fun

示例2：Header鉴权

GET /api/icp/v2.php?domain=baidu.com HTTP/1.1
Host: openapi.xunjinlu.fun
X-API-Key: sk_xxxxxxxxxxxxxxxx

示例3：Bearer Token鉴权

GET /api/icp/v2.php?domain=baidu.com HTTP/1.1
Host: openapi.xunjinlu.fun
Authorization: Bearer sk_xxxxxxxxxxxxxxxx

响应说明

成功响应示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "domain": "baidu.com",
        "is_icp": true,
        "icp_number": "京ICP证030173号-1",
        "icp_status": "已备案",
        "icp_province": "北京",
        "icp_type": "证",
        "icp_serial": "030173",
        "site_index": "1",
        "unit_name": "北京百度网讯科技有限公司",
        "nature_name": "企业",
        "update_time": "2019-05-16",
        "web_status": {
            "status": "正常",
            "http_code": 200,
            "accessible": true
        },
        "response_time": "543ms",
        "query_time": "2026-05-06 03:35:50",
        "from_cache": false
    },
    "api_info": {
        "developer": "尋鯨錄",
        "blog": "https://www.xunjinlu.fun",
        "api_platform": "https://api.xunjinlu.fun"
    }
}

响应字段说明

顶层字段

data 对象字段

web_status 对象字段

api_info 对象字段

错误响应示例

{
    "code": 0,
    "msg": "未提供调用密钥",
    "errcode": 11001
}

业务错误码

本平台所有接口统一使用以下业务错误码（errcode），请根据错误码进行相应处理：

PHP调用示例

// ICP备案查询V2 - PHP示例

// 配置参数
$api_url = 'https://openapi.xunjinlu.fun/api/icp/v2.php';
$api_key = 'sk_xxxxxxxxxxxxxxxx'; // 替换为你的实际密钥
$domain = 'baidu.com';

// 方式1：Query参数鉴权
$url = $api_url . '?key=' . urlencode($api_key) . '&domain=' . urlencode($domain);

// 方式2：Header鉴权（取消注释使用）
// $url = $api_url . '?domain=' . urlencode($domain);

// 方式3：Bearer Token鉴权（取消注释使用）
// $url = $api_url . '?domain=' . urlencode($domain);

// 初始化cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

// 如使用Header鉴权，设置请求头（取消注释使用）
// curl_setopt($ch, CURLOPT_HTTPHEADER, [
//     'X-API-Key: ' . $api_key
// ]);

// 如使用Bearer Token鉴权，设置请求头（取消注释使用）
// curl_setopt($ch, CURLOPT_HTTPHEADER, [
//     'Authorization: Bearer ' . $api_key
// ]);

// 执行请求
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

// 解析响应
if ($http_code == 200) {
    $result = json_decode($response, true);
    if ($result['code'] == 200) {
        // 查询成功
        $data = $result['data'];
        echo "域名: " . $data['domain'] . "\n";
        echo "是否备案: " . ($data['is_icp'] ? '是' : '否') . "\n";
        echo "备案号: " . $data['icp_number'] . "\n";
        echo "主体名称: " . $data['unit_name'] . "\n";
        echo "备案省份: " . $data['icp_province'] . "\n";
        echo "更新时间: " . $data['update_time'] . "\n";
    } else {
        // 业务错误
        echo "错误: " . $result['msg'] . " (errcode: " . $result['errcode'] . ")\n";
    }
} else {
    // HTTP错误
    echo "HTTP错误码: " . $http_code . "\n";
}

注意事项

1. 密钥安全：请妥善保管你的API密钥，避免泄露。不要在客户端代码中硬编码密钥。

2. 域名格式：domain参数支持纯域名和URL格式，系统会自动提取域名部分。建议直接使用纯域名格式以提高查询效率。

3. 频率限制：本接口限制每分钟约60次请求，请合理控制调用频率。如遇11005错误，请降低请求频率。

4. 缓存机制：响应中的 from_cache 字段指示数据是否来自缓存。缓存数据可能有短暂延迟，如需实时数据请关注此字段。

5. 错误处理：请务必处理可能返回的业务错误码（errcode），根据不同的错误码进行相应的重试或提示操作。

6. 超时设置：建议设置合理的请求超时时间（建议30秒），避免因网络问题导致请求挂起。