?>
ESC to close

Company Segment Financials API

Maintained by Piyush Arora

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": 2,
                    "subcategory": "Google Search  Other",
                    "value": 673596000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 4,
                    "subcategory": "Google Subscriptions, Platforms, & Devices",
                    "value": 144090000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 5,
                    "subcategory": "Google Network",
                    "value": 89376000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 1,
                    "subcategory_sno": 6,
                    "subcategory": "Youtube Ads",
                    "value": 121101000000
                }
            ]
        },
        {
            "category": "Geographical",
            "rank_category": 2,
            "data": [
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 2,
                    "subcategory_sno": 1,
                    "subcategory": "United States",
                    "value": 582687000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 2,
                    "subcategory_sno": 3,
                    "subcategory": "Apac",
                    "value": 203040000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 2,
                    "subcategory_sno": 5,
                    "subcategory": "Other Americas",
                    "value": 71706000000
                }
            ]
        },
        {
            "category": "Segments",
            "rank_category": 3,
            "data": [
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 3,
                    "subcategory_sno": 1,
                    "subcategory": "Google Services",
                    "value": 673596000000
                },
                {
                    "period": "2025-12-31",
                    "tag": 1,
                    "category_sno": 3,
                    "subcategory_sno": 4,
                    "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.Subcategory20252024202320222021202020192018
1Segments
1Americas$178.35B$167.05B$162.56B$169.66B$153.31B$124.56B$116.91B$112.09B
2Europe$111.03B$101.33B$94.29B$95.12B$89.31B$68.64B$60.29B$62.42B
3Greater China$64.38B$66.95B$72.56B$74.20B$68.37B$40.31B$43.68B$51.94B
4Ipad————————
5Mac————————
6Japan$28.70B$25.05B$24.26B$25.98B$28.48B$21.42B$21.51B$21.73B
7Rest Of Asia Pacific$33.70B$30.66B$29.62B$29.38B$26.36B$19.59B$17.79B$17.41B
8Europe————————
9Total Mac Net Sales————————
10Greater China————————
11Itunes, Software & Services————————
12Mac Portables————————
13Retail————————
14Ipod————————
15Iphone & Related Products And Services————————
16Rest Of Asia Pacific————————
17Desktops————————
18Ipad & Related Products And Services————————
19Accessories————————
20Other Music Related Products & Services————————
21Japan————————
22Software, Service & Other Net Sales————————
23Japan————————
24Peripherals & Other Hardware————————
2Product and Service
1Iphone$209.59B$201.18B$200.58B$205.49B$191.97B$137.78B$142.38B$164.89B
2Iphone————————
3Services$109.16B$96.17B$85.20B$78.13B$68.43B$53.77B$46.29B$39.75B
4Mac$33.71B$29.98B$29.36B$40.18B$35.19B$28.62B$25.74B$25.20B
5Ipad————————
6Wearables, Home & Accessories$35.69B$37.01B$39.85B$41.24B$38.37B$30.62B$24.48B$17.38B
7Ipad$28.02B$26.69B$28.30B$29.29B$31.86B$23.72B$21.28B$18.38B
8Mac————————
9Services————————
10Other Products————————
11Other Products————————
3Geographical
1Other Countries$199.99B$181.89B$172.15B$172.27B$163.65B$125.01B$114.23B$115.59B
2U.S$151.79B$142.20B$138.57B$147.86B$133.80B$109.20B$102.27B$98.06B
3China$64.38B$66.95B$72.56B$74.20B$68.37B$40.31B$43.68B$51.94B
4Segments
1Operating Segments$178.35B$167.05B$162.56B—————
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.
1U.S————————
2International————————

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
2Google Search Other$673.60B
4Google Subscriptions, Platforms, & Devices$144.09B
5Google Network$89.38B
6Youtube Ads$121.10B
2Geographical
1United States$582.69B
3Apac$203.04B
5Other Americas$71.71B
3Segments
1Google Services$673.60B
4Other 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.