查企业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 替换为控制台签发的密钥。完整字段与响应约定见 统一查询