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