ESC to close

Company Segment Financials API

Last updated:

Pull revenue, operating income, assets, and other financial metrics broken down by product line, geographic region, and operating business unit — all from a single endpoint. Coverage spans every public company filing segment data with the SEC, with history going back to the earliest XBRL disclosures. The API is free to use, and includes built-in year-over-year growth and percentage-of-total computation modes so you can skip the spreadsheet math entirely.

Related endpoints: Pair segment data with the Financial Statements API for consolidated income, balance sheet, and cash flow data. Use the Peers Analysis API to benchmark a company's segment mix against competitors.

1. Endpoint & Parameters

Extract operating metrics, regional revenue breakdowns, and product division performance directly from company filings. Provide an API key, the target series, and exactly one identifier (ticker or CIK). Optional parameters let you filter by segment category, switch between annual and quarterly dimensions, or request pre-computed year-over-year growth and percentage-of-total breakdowns.

GET https://data.businessquant.com/segments?series={series}&{identifier}&mode={mode}&api_key={api_key}

Request Parameters

Parameter Description
api_key
Required
Your unique API key for authentication.
series
Required
The financial metric to retrieve across segments. Common values include Revenue, OperatingIncomeLoss, Assets, CapitalExpenditures, and any other XBRL concept the company reports at the segment level.
Format: series=Revenue
ticker
Conditional Identifier
Stock ticker symbol. (Provide either this or cik).
Format: ticker=AAPL
cik
Conditional Identifier
SEC Central Index Key. (Provide either this or ticker).
Format: cik=320193
data_format
Optional
Controls value computation:
original — Raw reported values (Default).
pct — Each subcategory as a percentage of total for that period.
yoy — Year-over-year percentage growth for each subcategory.
Format: data_format=pct
mode
Optional
historic returns the full time series. latest returns only the most recent filing period. Default: historic.
dimension
Optional
Reporting frequency: Annual or Quarter. Default: Annual.
rank_category
Optional
Filters the hierarchy of segment categories returned:
all — Returns all segment categories (Default).
• Or provide comma-separated numeric IDs (e.g., 1,2) to return only specific categories.

Response Fields

FieldDescription
categoryThe segment classification group — e.g., "Product and Service", "Geographical", "Segments". Each company defines its own hierarchy.
rank_categoryNumeric ID for this category. Pass to rank_category parameter to filter.
subcategoryThe specific segment name within the category — e.g., "Iphone", "Americas", "Google Cloud".
periodFiscal period end date in YYYY-MM-DD format.
valueThe reported value in the company's filing currency (typically USD). Interpretation depends on data_format: raw dollars for original, percentage for pct, growth rate for yoy.
tagFiling recency indicator. 1 = most recent filing, 2 = prior filing, and so on.
Example cURL Request
curl -X GET "https://data.businessquant.com/segments?series=Revenue&ticker=AAPL&mode=latest&api_key=YOUR_API_KEY"
Sample Response (GOOGL, latest)
{
    "metadata": {
        "cik": 1652044,
        "ticker": "GOOGL",
        "companyname": "Alphabet Inc.",
        "companyname_short": "Alphabet",
        "dimension": "Annual",
        "series": "Revenue",
        "data_format": "original",
        "mode": "latest",
        "rank_category": "all"
    },
    "data": [
        {
            "category": "Segments",
            "rank_category": 1,
            "data": [
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 3,
                    "subcategory": "Google Search  Other",
                    "value": 673596000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 5,
                    "subcategory": "Google Subscriptions, Platforms, & Devices",
                    "value": 144090000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 7,
                    "subcategory": "Youtube Ads",
                    "value": 121101000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 6,
                    "subcategory": "Google Network",
                    "value": 89376000000
                }
            ]
        },
        {
            "category": "Geographical",
            "rank_category": 2,
            "data": [
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 2,
                    "subcategory_sno": 2,
                    "subcategory": "United States",
                    "value": 582687000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 2,
                    "subcategory_sno": 4,
                    "subcategory": "Apac",
                    "value": 203040000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 2,
                    "subcategory_sno": 6,
                    "subcategory": "Other Americas",
                    "value": 71706000000
                }
            ]
        },
        {
            "category": "Segments",
            "rank_category": 3,
            "data": [
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 3,
                    "subcategory_sno": 2,
                    "subcategory": "Google Services",
                    "value": 673596000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 3,
                    "subcategory_sno": 5,
                    "subcategory": "Other Bets",
                    "value": 4611000000
                }
            ]
        }
    ]
}

API Response — Revenue Breakdown (Historic)

Apple Inc. (AAPL)  ·  Annual  ·  Historic mode  ·  series=Revenue

CompanyApple Inc. (AAPL)
SeriesRevenue
DimensionAnnual
Data Formatoriginal
Cat S.No.Sub S.No.Subcategory202520242023202220212020201920182017201620152014201320122011201020092008
1Segments
2Operating Segments$178.35B$167.05B$162.56B
2Product and Service
2Iphone$209.59B$201.18B$200.58B$205.49B$191.97B$137.78B$142.38B$164.89B$141.32B$136.70B$155.04B
3Iphone$101.99B$91.28B
4Services$109.16B$96.17B$85.20B$78.13B$68.43B$53.77B$46.29B$39.75B$32.70B$24.35B
5Mac$33.71B$29.98B$29.36B$40.18B$35.19B$28.62B$25.74B$25.20B$25.85B$22.83B$25.47B
6Ipad$30.28B$31.98B
7Wearables, Home & Accessories$35.69B$37.01B$39.85B$41.24B$38.37B$30.62B$24.48B$17.38B$12.83B
8Ipad$28.02B$26.69B$28.30B$29.29B$31.86B$23.72B$21.28B$18.38B$18.80B$20.63B$23.23B
9Mac$24.08B$21.48B
10Services$29.98B$24.35B$19.91B$18.06B$16.05B
11Other Products$11.13B
12Other Products$12.86B$11.13B$10.07B$8.38B$10.12B
3Geographical
2Other Countries$199.99B$181.89B$172.15B$172.27B$163.65B$125.01B$114.23B$115.59B$100.13B$91.48B$93.27B$83.25B$78.77B$72.76B$53.97B$33.83B
3U.S$151.79B$142.20B$138.57B$147.86B$133.80B$109.20B$102.27B$98.06B$84.34B$75.67B$81.73B$68.91B$66.20B$60.95B$41.81B$28.63B
4China$64.38B$66.95B$72.56B$74.20B$68.37B$40.31B$43.68B$51.94B$44.76B$48.49B$58.72B$30.64B$25.95B$22.80B$12.47B$2.76B
4Segments
2Americas$178.35B$167.05B$162.56B$169.66B$153.31B$124.56B$116.91B$112.09B$96.60B$86.61B$93.86B$80.10B$77.09B
3Europe$111.03B$101.33B$94.29B$95.12B$89.31B$68.64B$60.29B$62.42B$54.94B$49.95B$50.34B$44.29B$40.98B$36.32B
4Greater China$64.38B$66.95B$72.56B$74.20B$68.37B$40.31B$43.68B$51.94B$44.76B$48.49B$58.72B$31.85B$27.02B$22.53B
5Ipad$30.95B$19.17B
6Mac$23.22B
7Japan$28.70B$25.05B$24.26B$25.98B$28.48B$21.42B$21.51B$21.73B$17.73B$16.93B$15.71B$15.31B$13.78B$10.57B
8Rest Of Asia Pacific$33.70B$30.66B$29.62B$29.38B$26.36B$19.59B$17.79B$17.41B$15.20B$13.65B$15.09B$11.25B$12.04B$10.74B
9Europe$27.78B$11.81B
10Total Mac Net Sales$17.48B
11Greater China$12.69B
12Itunes, Software & Services$12.89B$9.37B
13Mac Portables$11.28B$8.73B
14Retail$14.13B$9.80B$6.66B$7.29B
15Ipod$5.62B$7.45B$8.27B
16Iphone & Related Products And Services$6.74B
17Rest Of Asia Pacific$9.90B$3.18B
18Desktops$4.32B$5.62B
19Ipad & Related Products And Services$4.96B
20Accessories$5.15B$4.47B
21Other Music Related Products & Services$4.95B$4.04B$3.34B
22Japan$5.44B$3.98B$2.28B
23Software, Service & Other Net Sales$2.57B$2.41B$2.21B
24Japan$1.73B
25Peripherals & Other Hardware$1.81B$1.48B$1.69B
5Disclosure of profit or loss, total assets for each reportable region, and a description of the types of products and services for each reportable region.
2U.S$20.89B
3International$16.60B

API Response — Revenue Breakdown (Latest Period Only)

Alphabet Inc. (GOOGL)  ·  Annual  ·  Latest mode  ·  series=Revenue

CompanyAlphabet Inc. (GOOGL)
SeriesRevenue
Modelatest
Categories3
Cat S.No.Sub S.No.Subcategory2025
1Segments
3Google Search Other$673.60B
5Google Subscriptions, Platforms, & Devices$144.09B
6Google Network$89.38B
7Youtube Ads$121.10B
2Geographical
2United States$582.69B
4Apac$203.04B
6Other Americas$71.71B
3Segments
2Google Services$673.60B
5Other Bets$4.61B

3. Endpoint Variations

Below are the distinct ways to formulate your request depending on the data format, mode, and identifiers you use.

Historic Revenue by Product & Geography (default)
https://data.businessquant.com/segments?series=Revenue&ticker=AAPL&mode=historic&api_key=YOUR_API_KEY
Percentage-of-Total Breakdown
https://data.businessquant.com/segments?series=Revenue&ticker=AAPL&data_format=pct&api_key=YOUR_API_KEY
Year-over-Year Growth Rates
https://data.businessquant.com/segments?series=Revenue&ticker=GOOGL&data_format=yoy&api_key=YOUR_API_KEY
Operating Income by Segment (non-revenue series)
https://data.businessquant.com/segments?series=OperatingIncomeLoss&ticker=MSFT&mode=latest&api_key=YOUR_API_KEY
Quarterly Segments via CIK
https://data.businessquant.com/segments?series=Revenue&cik=789019&dimension=Quarter&mode=historic&api_key=YOUR_API_KEY

4. Segment Analysis Strategies & Use Cases

The segment financials endpoint goes beyond basic revenue breakdowns. Here are workflows that institutional analysts and quantitative teams commonly build on top of this data.

Geographic Concentration Risk

Use data_format=pct to instantly see what percentage of revenue comes from each region. Flag companies with over 40% exposure to a single geography — that concentration becomes a risk factor during tariff shifts, currency swings, or regional slowdowns.

Product Mix Drift Detection

Track how a company's product-line revenue share shifts over time. Apple's Services segment grew from 15% to over 26% of total revenue across six fiscal years — a structural transformation visible only through multi-year segment data.

Segment-Level Growth Screening

Combine with the Stock Screener API to find companies where headline revenue is flat but a specific segment is growing 20%+ YoY. Use data_format=yoy to get pre-computed growth rates without spreadsheet joins.

Segment-Level Profitability

Query series=OperatingIncomeLoss alongside series=Revenue to calculate operating margins at the segment level. Identify which business units are margin-accretive and which are subsidized by the core business.

Beyond revenue — what other series can I query?

The series parameter accepts any XBRL concept the company discloses at the segment level. Common examples beyond Revenue include OperatingIncomeLoss, Assets, CapitalExpenditures, DepreciationAndAmortization, and Goodwill. The available concepts depend on each company's filing — if they report it by segment, the API returns it.

Frequently Asked Questions

What types of segment data does this API return?

The API returns every segment classification a company reports in its SEC filings: product and service breakdowns (e.g., iPhone, Services, Mac for Apple), geographic revenue by region (Americas, Europe, Greater China), and operating business unit segments (e.g., Google Services vs. Other Bets for Alphabet). It covers revenue, operating income, assets, capital expenditures, and any other XBRL concept disclosed at the segment level.

How is this different from a revenue segmentation API?

Most competitor APIs only provide revenue broken down by product or geography — and often split those into separate endpoints. This API returns all segment categories from a single endpoint, covers metrics beyond revenue (operating income, assets, capex), and includes built-in data_format=yoy and data_format=pct computation modes that eliminate manual spreadsheet work.

Can I get year-over-year growth for each segment without computing it myself?

Yes. Set data_format=yoy and the API returns pre-computed year-over-year percentage growth for every subcategory. Similarly, data_format=pct returns each subcategory's share as a percentage of the period total. No spreadsheet joins or cross-period calculations needed.

How far back does segment data history go?

Coverage extends back to the earliest XBRL-tagged segment disclosures for each company — typically 10 to 15 years for large-cap filers, starting from when they first adopted XBRL tagging in their SEC filings. Apple's geographic segment data, for example, goes back to fiscal year 2008.

Is the Company Segment Financials API free to use?

Yes, the API is free to use. Sign up for an API key and start pulling segment-level revenue, operating income, geographic breakdowns, and more immediately.