§1概述
接口能力与数据说明
## A股上市公司定期报告数据API 该接口提供A股上市公司定期报告（年报、半年报、季报）的披露信息，包括报告期、报告类型、PDF链接等。支持按股票代码、报告类型、报告期范围查询，适用于投研系统的报告索引、事件驱动策略等场景。 ###  状态 覆盖A股全市场，持续维护更新。 ###  数据来源 数据源自各大交易所平台。 ###  覆盖时间范围 可回溯至2000年至今的全部公告记录。 ###  核心功能 - 按股票查询报告列表：获取指定股票历史所有定期报告。 - 按报告类型筛选：支持年报、半年报、季报、季报。 - 按报告期范围筛选：如 2020-01-01 至 2024-12-31。 ###  适用场景 - 上市公司定期报告时间轴展示 - 财报披露日期预测与事件驱动 - 自动化抓取财报PDF进行文本分析 - 监管日历构建 ### 错误码说明 | 错误码 | 返回message | 含义 | | ---- | ---- | ---- | | 0 | success | 成功 | | 40001 | Missing valid token in request | 请求中缺少Token | | 40002 | Invalid token | Token无效 | | 50001 | Too Many Requests: API call frequency limit exceeded | 请求过多：超出 API 调用频率限制 | | 50002 | Unknown error | 未知错误 | ### 更新历史 | 版本 | 日期 | 变更说明 | | ---- | ---- | ---- | | v1.0.0 | 2026/4/24 | 初始版本发布 |
请求地址
GET https://apiopendata.com/api/Ashare-periodic-rep注册后可获取 API Key；如需更高调用配额、批量服务或专属支持，可联系销售顾问。
§2请求参数
调用接口所需的查询参数
§3数据字段
返回结果中的字段定义
§4代码示例
Python / R / Stata 调用示例
import requests
url = "https://api.cnopendata.com/v1/..."
headers = {"Authorization": "Bearer YOUR_API_KEY"}
params = {}
resp = requests.get(url, headers=headers, params=params)
data = resp.json()
print(data)§5开始使用
注册获取调用凭证，或联系销售获得机构级方案
状态
数据来源
覆盖时间范围
核心功能
适用场景