企业普通搜索

API路径

services/v4/rest/enterprise/batch/plainSearch

请求方法

POST

请求参数

body 参数

参数 类型 说明 示例
keywords String 搜索关键词  
searchFields List 关键词匹配范围,可选(entName: 企业名;historyName: 企业历史名;entNameEng:企业英文名;analyzedMainProduct: 主营产品;UNCID:统一社会信用码;REGNO:工商注册号;OC:组织机构代码 [“entName”, “historyName”]
filter Map 搜索条件  
pageNum int 页数(默认为1)  
pageSize int 每页数量(默认为10,最大100); 最大支持翻页到第10000条数据(即: page * size <= 10000)  

搜索条件(filter)

参数 类型 说明 示例 是否必须
contactAddrCodes Map<List<String>> 通讯地址过滤
contactAddrCodes.province List<String> 通讯地址-省,支持多选 [ “11” ]
contactAddrCodes.city List<String> 通讯地址-市,支持多选 [ “1101” ]
contactAddrCodes.district List<String> 通讯地址-区,支持多选 [ “110101” ]
regAddrCodes Map<List<String>> 注册地址过滤
regAddrCodes.province List<String> 注册地址-省,支持多选 [ “11” ]
regAddrCodes.city List<String> 注册地址-市,支持多选 [ “1101” ]
regAddrCodes.district List<String> 注册地址-区,支持多选 [ “110101” ]
industryCodes Map<List<String>> 所属行业过滤
industryCodes.industryL1 List<String> 一级行业,支持多选 [ “A” ]
industryCodes.industryL2 List<String> 二级行业,支持多选 [ “11” ]
industryCodes.industryL3 List<String> 三级行业,支持多选 [ “110” ]
industryCodes.industryL4 List<String> 四级行业,支持多选 [ “1100” ]
contactType List<String> 联系方式,支持多选 [ “1”, “2” ]
esDate List<String> 成立时间,支持多选 [ “1”, “2” ]
regCap List<String> 注册资本,支持多选 [ “1”, “2” ]
regCCap List<String> 实缴资本 [ “1”, “2” ]
entType List<String> 企业类型,支持多选 [ “1” ]
entStatus List<String> 营业状态,支持多选 [ “1”, “9” ]
employees List<String> 参保人数,支持多选 [ “1”, “9” ]
hasBuildingCert boolean 有无建筑资质 true
hasFinanceInfo boolean 有无融资信息 true
hasAbnormalInfo boolean 有无经营异常 true
hasRecruit boolean 有无招聘 true
hasSem boolean 有无网络推广 true
hasWebsite boolean 有无网站域名 true
hasTrademark boolean 有无商标 true
hasPatent boolean 有无专利 true
hasTender boolean 有无招投标 true
hasWechat boolean 有无公众号 true
hasKeyContactTag boolean 有无关键手机号标签 true

搜索条件传参附加说明:

esDate 成立时间
1. 支持传选项值,如: ["1", "2"] (小于1年 或 1-5年)
选项值说明:1:小于1年;21-5年;35-10年;410-15年;515年以上
2. 支持传数值区间(左闭右开),如:["-946656000000", "946656000000-1262275200000", "1262275200000-"] (小于2000-01-012000-01-01~2010-01-01 或 大于2000-01-01)

esDate 注册资本
1. 支持传选项值,如: ["1", "2"] (20万以内 或 20-50万)
选项值说明:120万以内;220-50万;350-100万;4100-200万;5200-500万;6500万以上:
2. 支持传数值区间(左闭右开),如:["-20", "20-50", "50-"] (小于20万 或 20~50万 或 大于50万)

regCCap 实缴资本
同 注册资本

employees 参保人数
1. 支持传选项值,如: ["1", "2"] (小于20人 或 20-50人)
选项值说明:1:小于20人;220-50人;350-100人;4100-500人;5500-1000人;61000人以上
2. 支持传数值区间(左闭右开),如:["-20", "20-50", "50-"] (小于20人 或 20-50人 或 大于50人)

其他条件配置项详见 配置参数

调用样例

http://${host}/services/v4/rest/enterprise/batch/plainSearch

返回结果

JSON示例

{
"error_code": 0,
"message": "",
"size": 1,    // 页数条数
"total": 51,    // 总数
"page": 1,    // 页数
"data": [
    {
        "pid": "52baef8e5153419a2548b361f1b2f68b",    // 企业唯一id
        "entName": "山东能源集团有限公司",    // 企业名称
        "esDate": 826588800000,        // 成立日期(毫秒)
        "legalPerson": "李**",        // 法人
        "regAddress": "山东省济南市高新区舜华路28号",    // 注册地址
        "geoAddress": "山东省济南市高新区舜华路28号",    // 通讯地址
        "entStatus": "在营(开业)企业",    // 营业状态
        "regCapDisplay": "500万元人民币",    // 注册资本
    }
]

}

错误返回值

code msg 说明
 406  PIN已被使用 / 请求参数有误(keywords参数不能为空,类型需为string)  
407 PIN时间戳和服务器时间误差超过10分钟
408 Access Secrect 验证失败
409 缺少 X-AK-KEY 或者 X-AK-PIN 或 X-AK-TS 请求头
410 Access Key 不存在
411 访问 IP 不在白名单之列
412 Access Key 已被禁用
500 服务器错误
1000 账户已过期
1001 请求额度不足
1002 账户无调用权限
1003 请求并发超限

错误代码参考 错误码定义

文档更新时间: 2025-08-13 16:57   作者:李星亮