基础信息
查看接口基本信息和返回格式
接口描述
查询工信部ICP备案信息。支持单条查询与批量查询:单条传域名/单位名/备案号;批量可上传txt/csv文件或直接传多行文本(单次最多20条)。可查网站、APP、小程序、快应用四类,返回主办单位、备案号、单位性质、审核通过时间等。
七日请求统计
接口地址
https://api.yunmge.com/api/miiticp
请求方式
返回方式
返回预览
{
"code": 200,
"msg": "查询成功",
"data": {
"total": 1,
"page": 1,
"size": 10,
"pages": 1,
"list": [
{
"domain": "qq.com",
"unitName": "深圳市腾讯计算机系统有限公司",
"mainLicence": "粤B2-20090059",
"serviceLicence": "粤B2-20090059-5",
"natureName": "企业",
"contentTypeName": "",
"updateRecordTime": "2026-01-15 11:27:48"
}
]
}
}
计费标准
了解接口计费方式和套餐价格
接口类型
付费接口:本接口按次计费,每次调用将扣除相应额度。请确保账户余额充足。
计费方式
QPS限制
每分钟最多30次请求,每秒最多1次请求
每分钟最多120次请求,每秒最多5次请求
每日请求次数
普通用户不限制每日请求次数
会员用户不限制每日请求次数
扣费顺序
计费规则
安全认证
了解接口的认证方式和访问凭证管理
实名认证
本接口对所有用户开放,无需实名认证即可访问
认证方式
通过 HTTP Header 传递认证信息
通过 URL 参数传递认证信息
Token 管理
登录账户
使用您的账号密码登录平台,获取用户凭证
获取 Token
即可查看你的 Token 密钥
更换 Token
进入个人中心,点击「更换Token」,系统将生成新的 Token 密钥
保存 Token
请妥善保管您的 Token 密钥,泄露时请立即更换
Token 怪谈
安全建议
- 定期更换密钥,建议每 90 天更新一次
- 发现密钥泄露,请立即在个人中心「更换」该密钥
- 不要将密钥硬编码在代码中,使用环境变量存储
参数文档
了解接口的请求参数和响应字段说明
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 可选值 | 说明 |
|---|---|---|---|---|---|
token |
string | 否 | 无 | 无 | 平台请求 token,可选 |
domain |
string | 否 | 无 | 无 | 单条查询内容:域名 / 单位名称 / 备案号 与 file、domains 三选一 |
file |
file | 否 | 无 | txt、csv | 批量查询:上传文件(POST) 每行一个,CSV 只取第一列,# 开头为注释 最多 20 条,文件不超过 1MB |
domains |
string | 否 | 无 | 无 | 批量查询:直接传多行文本 换行、半角逗号或中文逗号分隔,最多 20 条 |
type |
string | 否 | web | web、app、xcx、kapp | 查询类型,单条与批量通用 web=网站 app=APP xcx=小程序 kapp=快应用 |
page |
int | 否 | 1 | 无 | 页码,批量时对每条生效 |
size |
int | 否 | 10 | 1~20 | 每页条数,最大 20 |
响应参数
| 字段名 | 类型 | 说明 |
|---|---|---|
code
|
int | 状态码 200=成功 201=失败 |
msg
|
string | 结果说明 |
data
|
object | 查询结果(单条 / 批量结构不同) |
|
│
├─
total
|
int | 单条:匹配总条数;批量:提交的条目数 |
|
│
├─
page
|
int | 当前页码(单条) |
|
│
├─
size
|
int | 每页条数(单条) |
|
│
├─
pages
|
int | 总页数(单条) |
|
│
├─
success
|
int | 批量:查询成功的条数 |
|
│
├─
failed
|
int | 批量:失败的条数 |
|
│
├─
type
|
string | 批量:本次使用的查询类型 |
|
│
├─
list
|
array | 单条:备案记录数组 批量:每条查询的结果数组 |
|
│
├─
│├ domain(记录)
|
string | 网站域名 APP/小程序/快应用类为服务名称 |
|
│
├─
│├ unitName
|
string | 主办单位名称 |
|
│
├─
│├ mainLicence
|
string | 主体备案号 |
|
│
├─
│├ serviceLicence
|
string | 服务备案号 |
|
│
├─
│├ natureName
|
string | 主办单位性质 |
|
│
├─
│├ contentTypeName
|
string | 内容类型 |
|
│
├─
│├ updateRecordTime
|
string | 审核通过时间 |
|
│
├─
│├ serviceName
|
string | 服务名称(APP/小程序/快应用返回) |
│└ serviceType
|
int | 服务类型标识 |
|
│
├─
│├ code(批量项)
|
int | 该条查询的状态:200 成功 / 201 失败 |
|
│
├─
│├ msg
|
string | 该条查询的说明 |
|
│
├─
│├ domain
|
string | 该条查询的词 |
|
│
└─
│├ total
|
int | 该条匹配到的总条数 |
│└ list
|
array | 该条的备案记录数组(结构同上) |
状态码
了解接口返回的状态码含义及处理方式
接口状态码
| 状态码 | 说明 |
|---|---|
200 |
查询成功(列表可能为空) |
201 |
参数错误或查询失败 |
服务器状态码
| 状态码 | 说明 |
|---|---|
500 |
服务器错误 |
501 |
请求接口不存在 |
502 |
请求接口已下架 |
503 |
请求接口维护中 |
504 |
缺少请求token参数 |
505 |
请求token不存在 |
506 |
请求token已被封禁 |
507 |
请求token额度不足 |
508 |
今日请求token已达上限 |
509 |
请求ip不在token白名单内 |
510 |
请求token无权使用当前接口 |
511 |
接口请求频率过高,请稍后再试 |
512 |
该接口未开启在线测试功能 |
513 |
今日在线测试次数已达上限 |
514 |
今日该接口请求次数已达上限 |
515 |
该接口为会员专属接口,请携带会员token |
516 |
该接口为会员专属接口,请开通会员 |
517 |
接口请求过于频繁,已被临时限制 |
518 |
该接口需要实名认证,请先完成实名认证 |
519 |
当前Token今日请求次数已达上限 |
520 |
当前Token已被禁止使用 |
521 |
请求token余额不足 |
522 |
请求token额度和余额均不足 |
530 |
接口服务异常,请稍后再试 |
531 |
接口响应超时,请稍后再试 |
532 |
接口暂时不可用,请稍后再试 |
533 |
接口配置异常 |
534 |
请求参数错误,请检查后重试 |
535 |
接口返回数据异常 |
在线测试
在线调试接口,实时查看响应结果
返回结果
等待请求...
等待请求...
示例代码
查看多种编程语言的接口调用示例
/**
* API请求DEMO-PHP
*
* 本demo支持GET与POST请求。
*/
//你申请的token密钥
$API_TOKEN = 'YOUR_TOKEN';
//API接口地址
$API_URL = 'https://api.yunmge.com/api/miiticp';
$get_post_data = array(
'token' => 'YOUR_TOKEN',
'domain' => '无',
'file' => '无',
'domains' => '无',
'type' => 'web',
'page' => '1',
'size' => '10',
);
/*发起请求API接口:
第1个参数:API接口地址URL,跟上面的同名变量相对应,无需更改。
第2个参数:API接口参数数组,跟上面的同名变量相对应,无需更改。
第3个参数:请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
*/
$resdata = api::send($API_URL, $get_post_data, 'GET/POST'); //发起请求,注意这里要选择接口支持的协议,默认GET,可选POST
//打印请求结果
print($resdata);
///////////////你的业务代码可写在这里处理API返回的数据
/**
* API请求类
*/
class api
{
public static function send($API_URL, $get_post_data, $type)
{
$get_post_data = http_build_query($get_post_data);
$res = self::send_curl($API_URL, $type, $get_post_data, null);
return $res;
}
//封装好的CURL请求函数,支持POST|GET
public static function send_curl($API_URL, $type, $get_post_data)
{
$ch = curl_init();
if ($type == 'POST') {
curl_setopt($ch, CURLOPT_URL, $API_URL);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $get_post_data);
} elseif ($type == 'GET') {
curl_setopt($ch, CURLOPT_URL, $API_URL . '?' . $get_post_data);
}
curl_setopt($ch, CURLOPT_REFERER, $API_URL);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$resdata = curl_exec($ch);
curl_close($ch);
return $resdata;
}
}
/**
* API请求DEMO-JavaScript
*
* 本demo支持GET与POST请求。
*/
//jQuery-Ajax
$.ajax({
url: 'https://api.yunmge.com/api/miiticp',
data: {
token: 'YOUR_TOKEN',
domain: '无',
file: '无',
domains: '无',
type: 'web',
page: '1',
size: '10',
},
type: 'GET/POST', //请求协议(GET或POST),一般默认GET,部分接口需要POST请求,根据实际情况修改为POST即可。
dataType: 'json',
success: function(data) {
console.log(data); //请求成功,输出结果到控制台
},
timeout: 3000, //超时时间
error: function(data) {
console.log('请求失败'); //失败处理
}
});
/**
* API请求DEMO-NodeJs
*
* 本demo支持GET与POST请求。
*/
const https = require('https');
const querystring = require('querystring');
// 定义请求选项
const options = {
hostname: 'api.yunmge.com',
path: '/api/miiticp',
method: 'GET/POST'
};
// 发送POST请求
const postData = querystring.stringify({
'token': 'YOUR_TOKEN',
'domain': '无',
'file': '无',
'domains': '无',
'type': 'web',
'page': '1',
'size': '10',
});
const postOptions = {
hostname: 'api.yunmge.com',
path: '/api/miiticp',
method: 'POST',
headers: {
'Content-Type': 'application/x-www-form-urlencoded',
'Content-Length': Buffer.byteLength(postData)
}
};
const postReq = https.request(postOptions, res => {
console.log(`statusCode: ${res.statusCode}`);
res.on('data', d => {
process.stdout.write(d);
});
});
postReq.on('error', error => {
console.error(error);
});
postReq.write(postData);
postReq.end();
import requests
url = "https://api.yunmge.com/api/miiticp"
data = {
"token": "YOUR_TOKEN",
"domain": "无",
"file": "无",
"domains": "无",
"type": "web",
"page": "1",
"size": "10",
}
response = requests.post(url, data=data)
print(response.json())
package main
import (
"fmt"
"io/ioutil"
"net/http"
"net/url"
"strings"
)
func main() {
apiURL := "https://api.yunmge.com/api/miiticp"
// POST请求
data := url.Values{}
data.Set("token", "YOUR_TOKEN")
data.Set("domain", "无")
data.Set("file", "无")
data.Set("domains", "无")
data.Set("type", "web")
data.Set("page", "1")
data.Set("size", "10")
resp, err := http.Post(apiURL, "application/x-www-form-urlencoded", strings.NewReader(data.Encode()))
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
public class ApiRequest {
public static void main(String[] args) {
try {
String apiUrl = "https://api.yunmge.com/api/miiticp";
URL url = new URL(apiUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setDoOutput(true);
// 构建POST参数
StringBuilder postData = new StringBuilder();
postData.append("token=").append(URLEncoder.encode("YOUR_TOKEN", "UTF-8"));
postData.append("&"); postData.append("domain=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("file=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("domains=").append(URLEncoder.encode("无", "UTF-8"));
postData.append("&"); postData.append("type=").append(URLEncoder.encode("web", "UTF-8"));
postData.append("&"); postData.append("page=").append(URLEncoder.encode("1", "UTF-8"));
postData.append("&"); postData.append("size=").append(URLEncoder.encode("10", "UTF-8"));
byte[] postDataBytes = postData.toString().getBytes("UTF-8");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
try (OutputStream os = conn.getOutputStream()) {
os.write(postDataBytes);
}
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
StringBuilder response = new StringBuilder();
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
System.out.println(response.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
string apiUrl = "https://api.yunmge.com/api/miiticp";
using (HttpClient client = new HttpClient()) {
// POST请求
var formData = new Dictionary<string, string> {
{ "token", "YOUR_TOKEN" },
{ "domain", "无" },
{ "file", "无" },
{ "domains", "无" },
{ "type", "web" },
{ "page", "1" },
{ "size", "10" },
};
var content = new FormUrlEncodedContent(formData);
HttpResponseMessage response = await client.PostAsync(apiUrl, content);
string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
}
}
}
/**
* API请求DEMO-C
*
* 本demo支持GET与POST请求。
* 需要安装libcurl库
*/
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <curl/curl.h>
// API地址
const char* url = "https://api.yunmge.com/api/miiticp";
// POST请求
void postRequest(CURL* curl) {
CURLcode res;
const char* postData = "token=YOUR_TOKEN&domain=%E6%97%A0&file=%E6%97%A0&domains=%E6%97%A0&type=web&page=1&size=10";
curl_easy_setopt(curl, CURLOPT_URL, url);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData);
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n", curl_easy_strerror(res));
}
}
int main() {
CURL* curl = curl_easy_init();
if(curl) {
postRequest(curl); curl_easy_cleanup(curl);
}
return 0;
}
/**
* API请求DEMO-C++
*
* 本demo支持GET与POST请求。
* 需要安装libcurl库
*/
#include <iostream>
#include <string>
#include <curl/curl.h>
int main() {
CURL* curl = curl_easy_init();
if(curl) {
std::string apiUrl = "https://api.yunmge.com/api/miiticp";
// POST请求
std::string postData = "token=YOUR_TOKEN&domain=%E6%97%A0&file=%E6%97%A0&domains=%E6%97%A0&type=web&page=1&size=10";
curl_easy_setopt(curl, CURLOPT_URL, apiUrl.c_str());
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postData.c_str());
CURLcode res = curl_easy_perform(curl);
if(res != CURLE_OK) {
std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
}
curl_easy_cleanup(curl);
}
return 0;
}
.版本 2
.支持库 spec
.子程序 _启动子程序
.局部变量 url, 文本型
.局部变量 data, 文本型
.局部变量 result, 文本型
url = "https://api.yunmge.com/api/miiticp"
data = "token=YOUR_TOKEN&domain=%E6%97%A0&file=%E6%97%A0&domains=%E6%97%A0&type=web&page=1&size=10"
result = 网页_访问 (url, 1, data, , , , , , , , , )
调试输出 (result)
常见问题
查找常见问题的解决方案
1. 能查到什么
查询工信部备案系统的公开数据:网站备案、APP 备案、小程序备案、快应用备案。可以按域名查,也可以按单位名称或备案号查。
2. 单条查询
传 domain 即可,例如 domain=qq.com。返回 data.total 和 data.list。
3. 批量查询(上传文件)
用 POST 上传 file 字段,支持 txt 或 csv,每行一个,CSV 只取第一列,# 开头视为注释。单次最多 20 条,文件不超过 1MB。也可以不传文件,直接用 domains 传多行文本(换行、半角逗号或中文逗号分隔)。接口 GET 和 POST 都支持,只有上传文件必须用 POST。
批量结果的结构:data.total 是提交条数、data.success/data.failed 是成功失败统计,data.list 里每条带自己的 domain、code、total 和 list。某条失败不会影响其他条。
4. type 四种类型
| type | 查询对象 | 示例 domain |
|---|---|---|
| web | 网站备案 | qq.com |
| app | APP 备案 | 微信 |
| xcx | 小程序备案 | 美团 |
| kapp | 快应用备案 | 滴滴出行 |
批量时 type 对整个文件生效,不能逐行指定类型;需要查不同类型请分批提交。
5. 什么情况下返回空列表
返回 code=200 但该条 total=0 属于正常结果,常见原因是:域名/应用确实没有备案;APP、小程序、快应用必须接近完整名称(京东 查不到但更准确的名称可能查得到);备案类型选错(网站数据里查不到 APP)。
6. 分页说明
page 默认 1,size 默认 10、最大 20。按备案号查询可能匹配上千条(如 粤B2-20090059 有 1700+ 条),建议配合分页取用;批量模式下分页参数对每一条都生效。
7. 返回字段怎么读
unitName 是主办单位;mainLicence 是主体备案号;serviceLicence 是该服务的备案号;updateRecordTime 是最近审核通过时间。APP / 小程序 / 快应用没有域名,domain 字段填服务名称,另有 serviceName 字段。
8. 响应时间
单条约 1~3 秒(官方站点需要过一次验证码)。批量会并发处理,20 条通常在 10~30 秒内完成,建议客户端超时设置不低于 90 秒。同一关键词高频调用可能被官方限流,建议加缓存,不要并发轰炸。
9. 错误码
| 返回 | 含义 | 处理建议 |
|---|---|---|
| 200 | 查询成功 | 看 data.list,空列表也是成功 |
| 201 请传入 domain | 没有任何查询内容 | 传 domain 或 file / domains |
| 201 type 不支持 | type 写错 | 用 web / app / xcx / kapp |
| 201 domain 长度不能超过 100 | 参数过长 | 截断后重试 |
| 201 单次最多查询 20 条 | 批量超限 | 拆分文件分批提交 |
| 201 文件不能超过 1MB | 文件过大 | 精简后重试 |
| 201 查询服务未就绪 | 后端暂时不可用 | 稍后重试 |