搜索API
可以通过关键字获取企业列表,包括公司名称、公司 id、类型、成立日期、经营状态、统一社会信用代码等。filters.keyword 必填,也可用顶层 query。有分页:条数用 top_k(每页最多 20 条,默认 20),翻页用 filters.offset。
已开放
调用入口:POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域(必填) | enterprise |
| type | string | 数据类型(必填) | search |
| query | string | 搜索关键字(公司名称或简称等);与 filters.keyword 二选一 | 北京百度网讯科技有限公司 |
| filters | object | 结构化过滤条件,见下方「常用 filters」 | — |
| top_k | integer | 分页参数:每页条数,取值范围 1–100,本能力默认 20 | 20 |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| keyword | string | 搜索关键字(必填;公司名称或简称等;也可用 query) | 北京百度网讯科技有限公司 |
| offset | integer | 分页参数:偏移量(默认 0;配合顶层 top_k 翻页,建议为 top_k 的整数倍) | 0 |
返回字段(hits[])
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 公司名 |
| id | integer | 公司 id |
| creditCode | string | 统一社会信用代码 |
| regNumber | string | 注册号 |
| orgNumber | string | 组织机构代码 |
| legalPersonName | string | 法人 |
| regStatus | string | 企业状态 |
| regCapital | string | 注册资金 |
| estiblishTime | string | 开业时间 |
| base | string | 省份 |
| companyType | integer | 公司类型,1 公司 2 香港公司 3 社会组织 4 律所 5 事业单位 6 基金会 |
| type | integer | 1 公司 2 人 |
| matchType | string | 匹配类型 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"enterprise", "type":"search", "query":"北京百度网讯科技有限公司", "filters":{ "keyword":"北京百度网讯科技有限公司" }, "top_k":20 }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。