合作方数据 公司业绩指引 · REST 接口
业绩指引。获取来自上市公司披露的结构化业绩指引数据,包括预测每股收益(EPS)与营收。每条记录包含指引日期、财季与发布类型,并尽可能附上此前的指引值。可按代码、财季与日期区间过滤。
GET /benzinga/v1/guidance上游时效说明
每 2 小时更新
上游历史范围
数据可追溯至 2011 年 9 月 12 日
适用场景
- 市场情绪分析、投资策略开发、财务建模。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
date | string | No | 业绩指引发布日(格式 YYYY-MM-DD)。 |
date.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
date.gt | string | No | 筛选大于该值。 |
date.gte | string | No | 筛选大于或等于该值。 |
date.lt | string | No | 筛选小于该值。 |
date.lte | string | No | 筛选小于或等于该值。 |
ticker | string | No | 发布业绩指引公司的股票代码。 |
ticker.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
ticker.gt | string | No | 筛选大于该值。 |
ticker.gte | string | No | 筛选大于或等于该值。 |
ticker.lt | string | No | 筛选小于该值。 |
ticker.lte | string | No | 筛选小于或等于该值。 |
positioning | string | No | 表示某项业绩指引值相对公司披露的其他数字的呈现方式。可选值为 primary(被强调的数字)与 secondary(辅助或替代数字) |
positioning.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
positioning.gt | string | No | 筛选大于该值。 |
positioning.gte | string | No | 筛选大于或等于该值。 |
positioning.lt | string | No | 筛选小于该值。 |
positioning.lte | string | No | 筛选小于或等于该值。 |
importance | integer | No | 事件重要程度的主观指标,取值范围 0(最低)至 5(最高)。值必须为整数。 |
importance.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。 |
importance.gt | integer | No | 筛选大于该值。值必须为整数。 |
importance.gte | integer | No | 筛选大于或等于该值。值必须为整数。 |
importance.lt | integer | No | 筛选小于该值。值必须为整数。 |
importance.lte | integer | No | 筛选小于或等于该值。值必须为整数。 |
last_updated | string | No | 该记录在系统中最后一次更新的时间戳(ISO 8601 格式)。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。 |
last_updated.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。 |
last_updated.gt | string | No | 筛选大于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。 |
last_updated.gte | string | No | 筛选大于或等于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。 |
last_updated.lt | string | No | 筛选小于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。 |
last_updated.lte | string | No | 筛选小于或等于该值。值须为纳秒整数时间戳、yyyy-mm-dd 格式的日期,或 ISO 8601 / RFC 3339 格式(例如 2024-05-28T20:27:41Z)。 |
fiscal_year | integer | No | 该业绩指引所对应期间所属的财年。值必须为整数。 |
fiscal_year.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。值必须为整数。 |
fiscal_year.gt | integer | No | 筛选大于该值。值必须为整数。 |
fiscal_year.gte | integer | No | 筛选大于或等于该值。值必须为整数。 |
fiscal_year.lt | integer | No | 筛选小于该值。值必须为整数。 |
fiscal_year.lte | integer | No | 筛选小于或等于该值。值必须为整数。 |
fiscal_period | string | No | 该业绩指引适用的财季,如 Q1、Q2、Q3 或 Q4。 |
fiscal_period.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
fiscal_period.gt | string | No | 筛选大于该值。 |
fiscal_period.gte | string | No | 筛选大于或等于该值。 |
fiscal_period.lt | string | No | 筛选小于该值。 |
fiscal_period.lte | string | No | 筛选小于或等于该值。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 50000。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 date,排序方向默认为 desc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].benzinga_id | string | Benzinga 为该业绩指引记录分配的唯一标识。 |
results[].company_name | string | 发布业绩指引的公司名称。 |
results[].currency | string | 公司发布业绩指引所用数据的计价货币,ISO 4217 代码。 |
results[].date | string | 业绩指引发布日(格式 YYYY-MM-DD)。 |
results[].eps_method | string | 每股收益(EPS)的口径。可选值为 gaap(按公认会计原则编制的标准化财务数据)、ffo(经营性资金流 FFO,常用于评估 REITs 经营表现的非 GAAP 指标)和 adj(调整后,非 GAAP)。 |
results[].estimated_eps_guidance | number | 公司发布业绩指引时的分析师一致预期每股收益(EPS)。该值可能高于、低于或落在公司给出的区间内。 |
results[].estimated_revenue_guidance | number | 公司发布业绩指引时的分析师一致预期营业收入。该值可能高于、低于或落在公司给出的区间内。 |
results[].fiscal_period | string | 该业绩指引适用的财季,如 Q1、Q2、Q3 或 Q4。 |
results[].fiscal_year | integer | 该业绩指引所对应期间所属的财年。 |
results[].importance | integer | 事件重要程度的主观指标,取值范围 0(最低)至 5(最高)。 |
results[].last_updated | string | 该记录在系统中最后更新的时间戳(格式为 ISO 8601 时间戳)。 |
results[].max_eps_guidance | number | 若公司给出区间,则为该财季预期的最高每股收益。 |
results[].max_revenue_guidance | number | 若公司给出区间,则为该财季预期的最高营业收入。 |
results[].min_eps_guidance | number | 若公司给出区间,则为该财季预期的最低每股收益。 |
results[].min_revenue_guidance | number | 若公司给出区间,则为该财季预期的最低营业收入。 |
results[].notes | string | 关于该业绩指引记录的补充描述或评论。 |
results[].positioning | string | 表示某项业绩指引值相对公司披露的其他数字的呈现方式。可选值为 primary(被强调的数字)与 secondary(辅助或替代数字) |
results[].previous_max_eps_guidance | number | 同一财季此前发布的业绩指引中的最高每股收益。 |
results[].previous_max_revenue_guidance | number | 同一财季此前发布的业绩指引中的最高营业收入。 |
results[].previous_min_eps_guidance | number | 同一财季此前发布的业绩指引中的最低每股收益。 |
results[].previous_min_revenue_guidance | number | 同一财季此前发布的业绩指引中的最低营业收入。 |
results[].release_type | string | 表示该业绩指引是随定期财报一并发布(official),还是作为计划外更新发布(preliminary)。 |
results[].revenue_method | string | 营业收入数据的口径。可选值:gaap(按美国公认会计原则的标准化财务数据)与 adj(调整后、非 GAAP)。 |
results[].ticker | string | 发布业绩指引公司的股票代码。 |
results[].time | string | 业绩指引公布的时间,格式 HH:mm:ss。 |
status | enum: OK | 本次请求响应的状态。 |
响应示例
{
"count": 1,
"request_id": 1,
"results": [
{
"benzinga_id": "682b28a9c068240001a9fded",
"company_name": "Bath & Body Works",
"currency": "USD",
"date": "2025-05-19",
"eps_method": "adj",
"estimated_eps_guidance": 3.52,
"estimated_revenue_guidance": 7470000000,
"fiscal_period": "FY",
"fiscal_year": 2025,
"importance": 3,
"last_updated": "2025-05-19T12:54:04Z",
"max_eps_guidance": 3.6,
"max_revenue_guidance": 7526000000,
"min_eps_guidance": 3.25,
"min_revenue_guidance": 7380000000,
"notes": "Revenue for 2025 FY is expected to up by 1 to 3% YoY from $7.307B",
"positioning": "primary",
"previous_max_eps_guidance": 3.6,
"previous_max_revenue_guidance": 7526000000,
"previous_min_eps_guidance": 3.25,
"previous_min_revenue_guidance": 7380000000,
"release_type": "preliminary",
"revenue_method": "gaap",
"ticker": "BBWI",
"time": "08:30:00"
}
],
"status": "OK"
}原文:Massive 文档 ↗