Corporate Guidance
GET
/benzinga/v1/guidance
Retrieve structured earnings guidance data, including projected EPS and revenue figures, from public company disclosures. Each record includes key attributes such as the guidance date, fiscal period, and release type, with prior guidance values included when available. Data can be filtered by ticker, fiscal period, and date range. Guidance records are timestamped and sortable for flexible integration into downstream applications.
Use Cases: Market sentiment analysis, investment strategy development, financial modeling.
Query Parameters
date
string
The calendar date (formatted as YYYY-MM-DD) when the guidance was issued.
ticker
string
The stock symbol of the company issuing guidance.
positioning
string
Indicates how a particular guidance value is presented relative to other figures disclosed by the company. Possible values are 'primary' (the emphasized figure) and 'secondary' (a supporting or alternate figure)
importance
integer
A subjective indicator of the importance of the event, on a scale from 0 (lowest) to 5 (highest). Value must be an integer.
last_updated
string
The timestamp (formatted as an ISO 8601 timestamp) when the record was last updated in the system.
fiscal_year
integer
The fiscal year corresponding to the period for which the guidance is issued. Value must be an integer.
fiscal_period
string
The fiscal quarter to which the guidance applies, such as Q1, Q2, Q3, or Q4.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'date' if not specified. The sort order defaults to 'desc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
benzinga_id
string
optional
A unique identifier assigned by Benzinga to the guidance record.
company_name
string
optional
The name of the company issuing guidance.
currency
string
optional
The ISO 4217 code representing the currency in which the company issued its guidance figures.
date
string
optional
The calendar date (formatted as YYYY-MM-DD) when the guidance was issued.
eps_method
string
optional
The methodology of the EPS figure. Possible values are gaap (standardized financials under Generally Accepted Accounting Principles), ffo (Funds From Operations, a non-GAAP metric commonly used to assess the operating performance of REITs), and adj (adjusted, non-GAAP).
estimated_eps_guidance
number
optional
The midpoint or central earnings per share (EPS) value the company expects for the given fiscal period.
estimated_revenue_guidance
number
optional
The midpoint or central revenue figure the company expects for the given fiscal period.
fiscal_period
string
optional
The fiscal quarter to which the guidance applies, such as Q1, Q2, Q3, or Q4.
fiscal_year
integer
optional
The fiscal year corresponding to the period for which the guidance is issued.
importance
integer
optional
A subjective indicator of the importance of the event, on a scale from 0 (lowest) to 5 (highest).
last_updated
string
optional
The timestamp (formatted as an ISO 8601 timestamp) when the record was last updated in the system.
max_eps_guidance
number
optional
The highest EPS value the company expects for the fiscal period if a range was provided.
max_revenue_guidance
number
optional
The highest revenue figure the company expects for the fiscal period if a range was provided.
min_eps_guidance
number
optional
The lowest EPS value the company expects for the fiscal period if a range was provided.
min_revenue_guidance
number
optional
The lowest revenue figure the company expects for the fiscal period if a range was provided.
notes
string
optional
Additional descriptive text or commentary provided about the guidance record.
positioning
string
optional
Indicates how a particular guidance value is presented relative to other figures disclosed by the company. Possible values are 'primary' (the emphasized figure) and 'secondary' (a supporting or alternate figure)
previous_max_eps_guidance
number
optional
The highest EPS value issued in a previous guidance record for the same fiscal period.
previous_max_revenue_guidance
number
optional
The highest revenue value issued in a previous guidance record for the same fiscal period.
previous_min_eps_guidance
number
optional
The lowest EPS value issued in a previous guidance record for the same fiscal period.
previous_min_revenue_guidance
number
optional
The lowest revenue value issued in a previous guidance record for the same fiscal period.
release_type
string
optional
Indicates whether the guidance was issued as part of a scheduled earnings release ('official') or as an unscheduled update ('preliminary').
revenue_method
string
optional
The methodology of the revenue figure. Possible values are gaap (standardized financials under Generally Accepted Accounting Principles) and adj (adjusted, non-GAAP).
ticker
string
optional
The stock symbol of the company issuing guidance.
time
string
optional
The time of day the guidance was announced, in HH:mm:ss format.
status
enum (OK)
The status of this request's response.