介绍

使用 Python SDK 访问 Reportify API

安装

pip

pip install reportify-sdk

快速开始

from reportify_sdk import Reportify

# 初始化客户端
client = Reportify(api_key="your-api-key")

# 搜索文档
docs = client.search.all("Tesla earnings", num=10)
for doc in docs:
    print(doc["title"])

# 搜索新闻
news = client.search.news("Apple iPhone", symbols=["US:AAPL"])

# 获取股票财务数据（返回 pandas DataFrame）
income = client.stock.income_statement("AAPL", period="quarterly")
print(income.head())

特性

文档搜索

支持多种文档类型搜索：新闻、研报、公告、电话会议纪要等

股票数据

获取财务报表、行情数据，返回 pandas DataFrame 格式

时间线

获取关注公司、主题、机构的最新动态

知识库

搜索用户上传的私有文档

配置选项

api_key · string · required

你的 Reportify API 密钥，可在开发者中心获取

base_url · string · default: "https://api.reportify.cn"

API 基础 URL，通常不需要修改

timeout · float · default: "30.0"

请求超时时间（秒）

错误处理

from reportify_sdk import (
    Reportify,
    AuthenticationError,
    RateLimitError,
    NotFoundError,
    APIError,
)

try:
    docs = client.search.all("Tesla")
except AuthenticationError:
    print("API Key 无效")
except RateLimitError:
    print("请求过于频繁，请稍后重试")
except NotFoundError:
    print("资源不存在")
except APIError as e:
    print(f"API 错误: {e.message}")

上下文管理器

# 自动关闭连接
with Reportify(api_key="your-api-key") as client:
    docs = client.search.all("Tesla")

下一步

搜索方法

了解文档搜索功能

股票数据

获取财务报表和行情数据