企业工商信息查询

company-searchGET
GEThttps://v1.apizero.cn/api/company-search
获取 API Key工作台购买 / 调试

概述

按企业名称检索工商登记信息。默认每页 20 条，可通过 page、size 翻页，size 取值 1–20。同一检索条件在 24 小时内可能返回已留存结果。无法获取最新结果时，可能返回 30 日内留存结果，并在 data.notice 中注明；该结果不代表登记机关的当前登记状态。本接口现用于调用量统计，正式数据合作将随调用量增长另行安排。查询结果仅供参考，不得作为开户、授信或诉讼的唯一依据。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/company-search/raw.md
打开 Markdown

鉴权

匿名可调用：QPS 1、日 5 次（仅供试用）；登录后：QPS 2、日 10 次；黄金会员：QPS 10、日 5000 次；钻石会员：QPS 30、日 10000 次；企业会员：QPS 120、日 100000 次。批量查询请控制在QPS 120以内。

获取 API Key

请求头

Authorizationstring必填

必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

请求参数

GET · QUERY STRING · https://v1.apizero.cn/api/company-search?name=name&page=1&size=20

name（名称）string必填

企业名称关键词，2~50 个字符（如「腾讯科技」「阿里巴巴」）

page（页码）number选填

页码，从 1 起，默认 1

例1

size（条数）number选填

每页条数，1–20，默认 20

例20

返回结果

顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id

keywordstring

查询关键词回显

totalnumber

匹配总数。本页默认最多 20 条，用 page 翻页

listarray

本页企业列表，默认最多 20 条

idnumber

本页结果编号，只用于区分列表项，不是统一社会信用代码

namestring

企业全称

logostring

企业 LOGO 图片 URL（可能为空）

english_namestring

英文名（可能为空）

history_namesstring

曾用名（可能为空）

legal_personstring

法定代表人

establish_timestring

成立日期 YYYY-MM-DD

reg_capitalstring

注册资本（含币种，如「7000万人民币」）

reg_statusstring

登记状态（存续 / 注销 / 吊销 等）

credit_codestring

统一社会信用代码（18 位）

business_scopestring

经营范围

reg_locationstring

注册地址

phonestring

联系电话（取首项）

emailstring

联系邮箱（取首项）

categorystring

行业分类

citystring

所在城市

districtstring

所在区/县

company_org_typestring

企业类型（取首项，如「有限责任公司」）

match_fieldstring

匹配命中的字段（如「公司名称匹配」「股东信息」「历史名称」）

noticestring

仅在返回已留存结果时出现，表示当前无法获取最新结果，不代表登记机关的当前登记状态。常规查询不返回该字段

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "keyword": "腾讯科技",
    "total": 20,
    "list": [
      {
        "id": 1466562059,
        "name": "广州腾讯科技有限公司",
        "logo": "",
        "english_name": "Guangzhou Tencent Technology Co., Ltd.",
        "history_names": "",
        "legal_person": "邬红波",
        "establish_time": "2014-12-31",
        "reg_capital": "7000万人民币",
        "reg_status": "存续",
        "credit_code": "91440101327598294H",
        "business_scope": "电子;通信与自动控制技术研究...",
        "reg_location": "广州市海珠区新港中路397号...",
        "phone": "020-81167888",
        "email": "service@tencent.com",
        "category": "研究和试验发展",
        "city": "广州市",
        "district": "海珠区",
        "company_org_type": "有限责任公司",
        "match_field": "股东信息"
      }
    ]
  },
  "request_id": "mota...",
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -H "Authorization: Bearer YOUR_API_KEY" "https://v1.apizero.cn/api/company-search?name=%3Cname%3E&page=1&size=20"

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

本接口补充

4044400

未找到匹配的企业

调用限制

计费模式
按次付费 · 点数包 · 月套餐
QPS 限制
QPS 2
登录免费额度
10 次（已认证）
匿名每日额度
5 次（无 API Key）
黄金会员
每天 5,000 次 · QPS 10
钻石会员
每天 10,000 次 · QPS 30
企业会员
本接口约 49,875 次/月 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.1.02026-09-28

    文档与实际行为对齐：默认每页 20 条，支持 page、size 翻页 24 小时内可能返回已留存结果；无法获取最新结果时，可能返回 30 日内留存结果，并附带 notice 本接口现用于调用量统计，正式数据合作将随调用量增长另行安排

  • 1.0.02026-05-06

    首次发布企业工商查询

免责声明

查询结果可能为已留存数据。一般情况下保留 24 小时；无法获取最新结果时，最长可返回 30 日内留存结果，并以 notice 注明。本接口现用于调用量统计，正式数据合作将随调用量增长另行安排。查询结果不构成登记机关的实时登记证明。