企业工商年报查询接口（enterprise.report）：多年度经营指标

这个接口能解决什么问题

年报是观察企业经营趋势最直接的公开窗口。enterprise.report 一次把企业历年公示的年报全部拉全，适合做经营趋势判断：收入、负债、净资产、利润、纳税总额逐年对比，再叠加从业人数变化，能比较直观地看出企业是在扩张还是收缩。一次调用返回全部年度而非单年，做趋势分析不必多次付费。

一句话说明

输入企业全称 / 注册号 / 统一社会信用代码，返回多年度年报数组（按年份倒序），查得计费。

适用场景

经营趋势分析：逐年对比收入、利润、纳税与从业人数
供应商 / 客户经营健康度评估
投资标的尽职调查：判断扩张或收缩
招投标与授信前的经营能力核查

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/enterprise/report`
请求方式	GET（keyword 放 Query String）
鉴权方式	请求头 `X-API-Key`
接口编码	`enterprise.report`
收费类型	按次计费（PER_CALL，0.3000 元/次）
计费规则	查得计费：关键词非法、上游不可用、查不到任何年报时失败且不扣费
返回内容	多年度年报数组（按年份倒序）
典型用途	经营趋势分析、经营健康度评估、尽职调查

如何调用

cURL

curl -s -G "https://api.xujian.tech/openapi/enterprise/report" --data-urlencode "keyword=重庆可乐家装饰工程有限公司" -H "X-API-Key: 你的APIKey" | python -m json.tool

返回示例（节选，code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "keyword": "重庆可乐家装饰工程有限公司",
    "reports": [
      { "reportYear": "2024", "insuranceNum": "3人", "saleIncome": "公示中", "profitTotal": "公示中", "taxTotal": "公示中" },
      { "reportYear": "2023", "insuranceNum": "2人", "saleIncome": "公示中", "profitTotal": "公示中", "taxTotal": "公示中" }
    ],
    "apiCode": "enterprise.report",
    "apiName": "企业工商年报查询",
    "chargeType": "PER_CALL",
    "balance": 99.7000,
    "costMs": 540
  }
}

计费说明

按次计费，0.3000 元/次。采用「先预鉴权、查到年报后扣费」两段式；关键词非法、上游不可用、查不到任何年报时返回失败，不扣费。一次返回全部年度，趋势分析无需多次付费。

常见问题

年报里的财务数据一定准吗？ 年报部分指标企业可选择「公示中」不公开，接口原样返回，建议结合其他维度交叉验证。
关键词怎么填？ 企业全称 / 注册号 / 统一社会信用代码，长度 2 ~ 50 字符；名称不准时先用 enterprise.query 校正。
和 enterprise.detail 的区别？ detail 含社保与变更，report 专注年报中的经营指标与从业人数，价格更低。