企业普通搜索
API路径
services/v4/rest/enterprise/batch/plainSearch请求方法
POST
请求参数
body 参数
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
| keywords | String | 搜索关键词(可选参数,但是keywords传参为空的情况下,必须要有通讯地址或注册地址或所属行业的过滤条件) | |
| 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": "山东xxx有限公司", // 企业名称
"establish_date": 826588800000, // 成立日期(毫秒)
"uncid": "xxaw", // 统一社会信用代码
"legal_person": "李**", // 法人
"reg_address": "山东省xxx28号", // 注册地址
"geo_address": "山东省xxx28号", // 通讯地址
"ent_status": "在营(开业)企业", // 营业状态
"regCapDisplay": "500万元人民币", // 注册资本
"entIntroduction": "xxx公司成立于2001-12-05,注册地址...", // 企业简介
"officialWebsite": "www.aaa.com" // 官网
}
]
}错误返回值
| 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-12-03 18:17 作者:李星亮