Revenue breakdown

One company's reported revenue by product, segment and region, from filings.

One row is

One company's reported revenue by product, segment and region, from filings

Example response

Trimmed real output. No key needed.

GET /v1/datasets/revenue-breakdown/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "view": "product",
    "periods": [
      {
        "end": "2023-09-25",
        "fiscalYear": 2023,
        "fiscalQuarter": 4
      },
      {
        "end": "2023-12-26",
        "fiscalYear": 2024,
        "fiscalQuarter": 1
      },
      {
        "end": "2024-03-27",
        "fiscalYear": 2024,
        "fiscalQuarter": 2
      },
      {
        "end": "2024-06-27",
        "fiscalYear": 2024,
        "fiscalQuarter": 3
      },
      {
        "end": "2024-09-27",
        "fiscalYear": 2024,
        "fiscalQuarter": 4
      },
      {
        "end": "2024-12-28",
        "fiscalYear": 2025,
        "fiscalQuarter": 1
      },
      {
        "end": "2025-03-30",
        "fiscalYear": 2025,
        "fiscalQuarter": 2
      },
      {
        "end": "2025-06-30",
        "fiscalYear": 2025,
        "fiscalQuarter": 3
      },
      {
        "end": "2025-09-29",
        "fiscalYear": 2025,
        "fiscalQuarter": 4
      },
      {
        "end": "2025-12-29",
        "fiscalYear": 2026,
        "fiscalQuarter": 1
      },
      {
        "end": "2026-03-30",
        "fiscalYear": 2026,
        "fiscalQuarter": 2
      },
      {
        "end": "2026-06-30",
        "fiscalYear": 2026,
        "fiscalQuarter": 3
      }
    ],
    "total": [
      null,
      null,
      null,
      null,
      null,
      null,
      null,
      94036000000,
      null,
      null,
      null,
      109417000000
    ],
    "rows": [
      {
        "key": "p:IPhone",
        "values": [
          null,
          null,
          null,
          null,
          null,
          null,
          null,
          44582000000,
          null,
          null,
          null,
          54252000000
        ],
        "ttm": null,
        "yoy": 0.2169036831008031,
        "share": 0.49582788780536846,
        "label": "iPhone"
      },
      {
        "key": "p:Service",
        "values": [
          null,
          null,
          null,
          null,
          null,
          null,
          null,
          27423000000,
          null,
          null,
          null,
          30739000000
        ],
        "ttm": null,
        "yoy": 0.1209203952886264,
        "share": 0.2809344069020353,
        "label": "Services"
      },
      {
        "key": "p:Mac",
        "values": [
          null,
          null,
          null,
          null,
          null,
          null,
          null,
          8046000000,
          null,
          null,
          null,
          10352000000
        ],
        "ttm": null,
        "yoy": 0.2866020382798906,
        "share": 0.09461052670060412,
        "label": "Mac"
      },
      {
        "key": "p:WearablesHomeandAccessories",
        "values": [
          null,
          null,
          null,
          null,
          null,
          null,
          null,
          7404000000,
          null,
          null,
          null,
          7883000000
        ],
        "ttm": null,
        "yoy": 0.06469475958941118,
        "share": 0.07204547739382362,
        "label": "Wearables, Home and Accessories"
      },
      {
        "key": "p:IPad",
        "values": [
          null,
          null,
          null,
          null,
          null,
          null,
          null,
          6581000000,
          null,
          null,
          null,
          6191000000
        ],
        "ttm": null,
        "yoy": -0.059261510408752494,
        "share": 0.05658170119816847,
        "label": "iPad"
      }
    ],
    "symbol": "AAPL",
    "cik": "0000320193",
    "currency": "USD",
    "views": [
      "product",
      "segment"
    ],
    "filed": "2026-07-31",
    "access": "full",
    "lockedRows": 0
  },
  "meta": {
    "dataset": "revenue-breakdown",
    "asOf": "2026-06-30",
    "source": [
      {
        "id": "sec-edgar",
        "attribution": "U.S. Securities and Exchange Commission and the filing issuer",
        "licence": "Public SEC filings; preserve filing attribution and fair-access limits"
      }
    ],
    "historyStarts": "2023-09-25",
    "coverage": {
      "views": [
        "product",
        "segment"
      ],
      "quarters": 12
    },
    "lastUpdated": "2026-07-31"
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/revenue-breakdown/{symbol}4 credits

SEC product, segment and geographic revenue. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: view
In: query
Type: product, segment, region

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`view`	query	`product`, `segment`, `region`

Credits: 4 (history x2)
Plans: Basic, Desk, Enterprise

Meta fields

Field: dataset
Here: The dataset id
In the example: "revenue-breakdown"

Field: asOf
Here: The observation date established by the service; otherwise null
In the example: "2026-06-30"

Field: source
Here: Attribution and usage terms of each source
In the example: 1 source

Field: historyStarts
Here: Earliest stored history when established by the service; otherwise null.
In the example: "2023-09-25"

Field: coverage
Here: Service-established coverage; null when unavailable.
In the example: {"views":["product","segment"],"quarters":12}

Field: lastUpdated
Here: The source update time established by the service; otherwise null
In the example: "2026-07-31"

Field	Here	In the example
`dataset`	The dataset id	`"revenue-breakdown"`
`asOf`	The observation date established by the service; otherwise null	`"2026-06-30"`
`source`	Attribution and usage terms of each source	1 source
`historyStarts`	Earliest stored history when established by the service; otherwise null.	`"2023-09-25"`
`coverage`	Service-established coverage; null when unavailable.	`{"views":["product","segment"],"quarters":12}`
`lastUpdated`	The source update time established by the service; otherwise null	`"2026-07-31"`

Sources

Source: U.S. Securities and Exchange Commission and the filing issuer
Usage terms: Public SEC filings; preserve filing attribution and fair-access limits

Source	Usage terms
U.S. Securities and Exchange Commission and the filing issuer	Public SEC filings; preserve filing attribution and fair-access limits

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.