企业普通搜索
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年;2:1-5年;3:5-10年;4:10-15年;5:15年以上
2. 支持传数值区间(左闭右开),如:["-946656000000", "946656000000-1262275200000", "1262275200000-"] (小于2000-01-01 或 2000-01-01~2010-01-01 或 大于2000-01-01)
esDate 注册资本
1. 支持传选项值,如: ["1", "2"] (20万以内 或 20-50万)
选项值说明:1:20万以内;2:20-50万;3:50-100万;4:100-200万;5:200-500万;6:500万以上:
2. 支持传数值区间(左闭右开),如:["-20", "20-50", "50-"] (小于20万 或 20~50万 或 大于50万)
regCCap 实缴资本
同 注册资本
employees 参保人数
1. 支持传选项值,如: ["1", "2"] (小于20人 或 20-50人)
选项值说明:1:小于20人;2:20-50人;3:50-100人;4:100-500人;5:500-1000人;6:1000人以上
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 作者:李星亮