👋 Overview
The segmented revenues API provides as-reported, granular revenue data for a given stock ticker. I finally launched the segmented revenues API, which lets your AI financial agent access segmented revenue data by product lines, business segments, and geographical regions for a given stock ticker. This includes revenue data segmented by:- product lines
- business segments
- geographical regions
📊 Available Tickers
You can fetch a list of available tickers with aGET
request to:
https://api.financialdatasets.ai/financials/segmented-revenue/tickers/
🚀 Getting Started
There are only 3 steps for making a successful API call:- Add your API key to the header of the request as
X-API-KEY
. - Add query params like
ticker
,period
andlimit
to filter the data. - Execute the API request.
ticker
, period
, limit
, and cik
.
The period
parameter can be set to "annual"
or "quarterly"
. The limit
parameter is used to specify the number of statements to return.
Note: ticker
and period
are required. Alternatively, you can use cik
instead of ticker
as a company identifier in your request. By default, limit
is 4
.
💻 Example
Segmented Revenues
Authorizations
API key for authentication.
Query Parameters
The ticker symbol.
The date or time period to which the reported revenue data relates in ISO 8601 format (YYYY-MM-DD).
Available options:
annual
, quarterly
The maximum number of revenue statements to return.
The Central Index Key (CIK) of the company.
Response
Segmented revenue response
The response is of type object
.