查企业API
按关键词与预设企业条件检索企业列表(企业名称、法人、经营状态、注册资本、注册地址、成立日期等)。filters.type 必填,取值见该字段说明;keywords 可用顶层 query 或 filters.keywords。有分页:顶层 top_k 为每页条数,filters.offset 为翻页偏移。
已开放
调用入口:POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域(必填) | enterprise |
| type | string | 数据类型(必填) | company_search |
| query | string | 自然语言检索词 | 科技 |
| filters | object | 结构化过滤条件,见下方「常用 filters」 | — |
| top_k | integer | 分页参数:每页条数,取值范围 1–100,本能力默认 20 | 20 |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| type | string | 搜索方式(必填;path :type):filter=按企业名称搜索;byServiceScope=按产品和服务搜索;juridicalPerson=按法人姓名搜索;contactPhone=按联系人号码搜索;contactName=按联系人姓名搜索;comprehensiveSearch=综合搜索 | filter |
| keywords | string | 搜索关键词(选填;也可用顶层 query;与 filters.type 配合使用) | 科技 |
| condition | string | 筛选条件 JSON 字符串(选填)。businessLocation=企业所在地(如 ["上海","杭州"]);companyIndustry=所属行业;companyType=企业类型;foundTime=成立年限(gte/lte,Unix 秒);registCapital=注册资本(gte/lte);operateState=经营状态(如 ["存续","在业"]);contactType=联系方式(mobile=手机、fixPhone=固话、email=邮箱、wechat=微信、qq、fax=传真、otherContact=其他、maimai=脉脉、Linkedin=领英);companyScale=公司规模(gte/lte) | — |
| sortField | string | 排序字段(选填):registCapital=注册资本排序;foundTime=成立日期排序 | foundTime |
| sortType | integer | 排序方向(选填):1=升序;-1=降序 | 1 |
| offset | integer | 分页参数:偏移量(默认 0;配合顶层 top_k 翻页,建议为 top_k 的整数倍) | 0 |
返回字段(hits[])
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 企业 ID |
| companyName | string | 企业名称 |
| juridicalPerson | string | 法人姓名 |
| companyStatus | string | 经营状态 |
| creditNumber | string | 统一信用代码 |
| registeredCapital | string | 注册资本 |
| establishTime | string | 企业成立时间 |
| address | string | 注册地址 |
| province | string | 所在省 |
| city | string | 所在市 |
| historyNames | list | 企业历史名称 |
| products | string | 产品和服务 |
| assocField | string | 关联字段 |
| companyUpdate | string | 企业近期是否有更新 |
| contactsUpdate | string | 企业联系方式近期是否有更新 |
| findCount | integer | 命中次数 |
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":"company_search", "query":"科技", "filters":{ "type":"filter" }, "top_k":20 }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。