API · Companies
Get revenue by country and region
Where the company's revenue comes from — ISO alpha-2 country codes + region rollups.
GET/api/v1/data/companies/{company}/revenue-geography
Returns the company's revenue split by country and region for one fiscal year. Mappable country rows come back with ISO alpha-2 codes so you can colour a world map directly.
When to use this
- "Where does Apple sell?"
- Building a revenue heatmap on a company page.
- Quantifying geographic exposure ahead of a market-shift event.
Path
| Field | Type | Description |
|---|---|---|
| companyrequired | string | Name, ticker, ISIN, or CIK. Examples: "Apple", "AAPL", "0000320193", "Neste". |
Query
| Field | Type | Description |
|---|---|---|
| year | integer | Fiscal year to query. Default: most recent available annual filing. |
Example
bash
curl "https://api.clarifo.com/api/v1/data/companies/Apple/revenue-geography?year=2025" \
-H "Authorization: Bearer $CLARIFO_API_KEY"Response
json
{
"company_name": "Apple Inc.",
"company_id": "aapl",
"market": "us",
"year": 2025,
"currency": "USD",
"unit": "milj_usd",
"total_revenue": 416161.0,
"total_revenue_mappable": 216167.0,
"countries": [
{"name": "United States", "iso_alpha2": "US",
"revenue": 151790.0, "page_id": "0000320193-25-000079"}
],
"regions": [
{"name": "Asia Pacific", "entity_type": "multi_region",
"revenue": 67680.0, "page_id": "…"}
],
"other": [
{"name": "Other countries (US filing)",
"entity_type": "other", "revenue": 199994.0,
"page_id": "0000320193-25-000079"}
]
}Country vs. region vs. other
The response is split into three buckets — and they are not strictly additive:
| Bucket | Source | Notes |
|---|---|---|
countries | Country-level disclosures with ISO codes | Safe to sum across rows. |
regions | Multi-country rollups ("EMEA", "Asia Pacific") | Do not sum with countries — some filers report both. |
other | "Other countries" catch-all | Can be large (40 %+) for filers that disclose only top markets. |
Coverage
- Nordic: all filers tracked by Clarifo's PDF pipeline.
- US: ~1,450 filers with country-level XBRL disclosures (2020–2026). Smaller and segment-only filers may be absent.