# Forbes API

> Forbes returns billionaire wealth and company rankings as a workflow and API.

Forbes's List billionaires method returns ranked wealth and profile details, with optional country, industry, and result-count filters. Get person net worth returns wealth and profile details for a named billionaire. List global 2000 and Get company rankings return company rankings, facts, and financial figures; they need optional list filters or a company name.

- Page: https://fous.com/workflows/forbes
- Handle: `@forbes`
- Category: [Finance](https://fous.com/workflows/category/finance)
- Source website: https://forbes.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Forbes.

## Methods

### Get company rankings

Operation `get_company_rankings`, version 1. 1 credit per call.

Find a Forbes company profile by name and return its list rankings, company facts, and headline financial figures. Financial figures use Forbes list years, which may differ from fiscal year-ends; market value is available when the company appears on the matching Global 2000 list.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `company` | string | yes | `"Berkshire Hathaway"` | Company name, for example Microsoft. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "company": {
      "type": "string",
      "description": "Company name, for example Microsoft.",
      "examples": [
        "Berkshire Hathaway",
        "Microsoft"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "company": "Berkshire Hathaway"
    },
    {
      "company": "Microsoft"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `ceo` | string or null | `"Gregory Edward Abel"` | Chief executive officer. |
| `currency` | string | `"USD"` | Currency code for the financial figures. |
| `industry` | string or null | `"Insurance"` | Forbes industry. |
| `employees` | integer or null | `387815` | Employee count. |
| `company_name` | string | `"Berkshire Hathaway"` | Name shown on Forbes. |
| `founded_year` | integer or null | `1839` | Year founded. |
| `list_rankings` | array |  | Forbes list appearances, including unranked appearances. |
| `list_rankings[].rank` | integer or null | `3` |  |
| `list_rankings[].year` | integer or null | `2026` |  |
| `list_rankings[].list_link` | string or null | `"https://www.forbes.com/global2000/"` |  |
| `list_rankings[].list_name` | string | `"Global 2000"` |  |
| `financial_year` | integer or null | `2026` | Forbes list year for the financial figures; not necessarily the fiscal year-end. |
| `headquarters_city` | string or null | `"Omaha"` | Headquarters city. |
| `assets_billion_usd` | number or null | `1300` | Forbes assets in billions of US dollars. |
| `profit_billion_usd` | number or null | `72.5` | Forbes profit in billions of US dollars. |
| `forbes_company_link` | string | `"https://www.forbes.com/companies/berkshire-hathaway/"` | Forbes company profile page. |
| `revenue_billion_usd` | number or null | `375.4` | Forbes revenue in billions of US dollars. |
| `headquarters_country` | string or null | `"United States"` | Headquarters country. |
| `market_value_billion_usd` | number or null | `1041.121` | Global 2000 market value in billions of US dollars for the financial list year. |

**Example input**

```json
{
  "company": "Berkshire Hathaway"
}
```

**Example output**

```json
{
  "ceo": "Gregory Edward Abel",
  "currency": "USD",
  "industry": "Insurance",
  "employees": 387815,
  "company_name": "Berkshire Hathaway",
  "founded_year": 1839,
  "list_rankings": [
    {
      "rank": 3,
      "year": 2026,
      "list_link": "https://www.forbes.com/global2000/",
      "list_name": "Global 2000"
    },
    {
      "rank": 1,
      "year": 2026,
      "list_link": "https://www.forbes.com/best-companies/",
      "list_name": "America's Best Companies"
    },
    {
      "rank": null,
      "year": 2026,
      "list_link": "https://www.forbes.com/best-in-state-companies/",
      "list_name": "America's Best-In-State Companies"
    }
  ],
  "financial_year": 2026,
  "headquarters_city": "Omaha",
  "assets_billion_usd": 1300,
  "profit_billion_usd": 72.5,
  "forbes_company_link": "https://www.forbes.com/companies/berkshire-hathaway/",
  "revenue_billion_usd": 375.4,
  "headquarters_country": "United States",
  "market_value_billion_usd": 1041.121
}
```

### Get person net worth

Operation `get_person_net_worth`, version 1. 1 credit per call.

Look up a billionaire by name and return their Forbes real-time wealth, daily change, rank, and public profile details. Wealth figures may change throughout the trading day.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `name` | string | yes | `"Elon Musk"` | The billionaire’s name, for example Elon Musk. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The billionaire’s name, for example Elon Musk.",
      "examples": [
        "Elon Musk",
        "Jeff Bezos"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "name": "Elon Musk"
    },
    {
      "name": "Jeff Bezos"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `age` | integer or null | `55` | Age in years. |
| `name` | string or null | `"Elon Musk"` | The person’s name, such as Elon Musk. |
| `rank` | integer or null | `1` | Rank on Forbes real-time billionaires list. |
| `photo_url` | string or null | `"https://imageio.forbes.com/specials-images/imageserve/62d700cd6094d2c180f269b9/0x0.jpg?format=jpg&crop=959,959,x0,y0,sa` | Link to the profile photo. |
| `residence` | string or null | `"Austin, Texas"` | Residence shown on the Forbes profile. |
| `updated_at` | string or null | `"2026-09-28T22:45:02-04:00"` | When Forbes updated the real-time ranking, in ISO 8601 Eastern time. |
| `citizenship` | string or null | `"United States"` | Country of citizenship. |
| `profile_url` | string or null | `"https://www.forbes.com/profile/elon-musk/"` | Link to the Forbes profile. |
| `self_made_label` | string or null | `"Self-made who came from a middle-class or upper-middle-class background"` | Description of the self-made score from Forbes. |
| `self_made_score` | integer or null | `8` | Forbes self-made score from 1 to 10. |
| `source_of_wealth` | string or null | `"Tesla, SpaceX, Self Made"` | Wealth sources shown on the Forbes profile. |
| `todays_change_percent` | number or null | `-2.39` | Percentage change since the prior trading day; negative means a loss. |
| `net_worth_billions_usd` | number or null | `906.7` | Real-time net worth in billions of US dollars. |
| `todays_change_billions_usd` | number or null | `-22.2` | Change since the prior trading day in billions of US dollars; negative means a loss. |

**Example input**

```json
{
  "name": "Elon Musk"
}
```

**Example output**

```json
{
  "age": 55,
  "name": "Elon Musk",
  "rank": 1,
  "photo_url": "https://imageio.forbes.com/specials-images/imageserve/62d700cd6094d2c180f269b9/0x0.jpg?format=jpg&crop=959,959,x0,y0,safe&height=416&width=416&fit=bounds",
  "residence": "Austin, Texas",
  "updated_at": "2026-09-28T22:45:02-04:00",
  "citizenship": "United States",
  "profile_url": "https://www.forbes.com/profile/elon-musk/",
  "self_made_label": "Self-made who came from a middle-class or upper-middle-class background",
  "self_made_score": 8,
  "source_of_wealth": "Tesla, SpaceX, Self Made",
  "todays_change_percent": -2.39,
  "net_worth_billions_usd": 906.7,
  "todays_change_billions_usd": -22.2
}
```

### List billionaires

Operation `list_billionaires`, version 1. 1 credit per call.

List the richest people in rank order from Forbes Real-Time Billionaires, with net worth, daily change and profile details. Filter by country or industry; wealth and changes are in billions of US dollars.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `country` | string | no | `"India"` | Country of citizenship to include, for example India. Leave blank for all countries. |
| `industry` | string | no | `"Technology"` | Industry to include, for example Technology. Leave blank for all industries. |
| `max_results` | integer | no | `25` | Maximum number of people to return, for example 25. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "",
      "description": "Country of citizenship to include, for example India. Leave blank for all countries.",
      "examples": [
        "India"
      ]
    },
    "industry": {
      "type": "string",
      "default": "",
      "description": "Industry to include, for example Technology. Leave blank for all industries.",
      "examples": [
        "Technology"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of people to return, for example 25.",
      "x-fous-developer": true,
      "examples": [
        25,
        10,
        7
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "max_results": 25
    },
    {
      "country": "India",
      "max_results": 10
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `updated_at` | string | `"2026-09-29T02:55:02.379000+00:00"` | When the list was updated (ISO 8601 with UTC offset). |
| `billionaires` | array |  |  |
| `billionaires[].age` | integer or null | `69` |  |
| `billionaires[].name` | string | `"Mukesh Ambani"` |  |
| `billionaires[].rank` | integer | `25` |  |
| `billionaires[].country` | string or null | `"India"` |  |
| `billionaires[].industry` | string or null | `"Diversified"` |  |
| `billionaires[].photo_url` | string or null | `"https://imageio.forbes.com/specials-images/imageserve/5c7d7829a7ea434b351ba0b6/0x0.jpg?format=jpg&crop=1837,1839,x206,y` |  |
| `billionaires[].profile_url` | string | `"https://www.forbes.com/profile/mukesh-ambani/"` |  |
| `billionaires[].source_of_wealth` | string or null | `"Diversified"` |  |
| `billionaires[].net_worth_billions_usd` | number | `82.2` |  |
| `billionaires[].todays_change_billions_usd` | number or null | `-1.8771` |  |

**Example input**

```json
{
  "country": "India",
  "max_results": 10
}
```

**Example output**

```json
{
  "updated_at": "2026-09-29T02:55:02.379000+00:00",
  "billionaires": [
    {
      "age": 69,
      "name": "Mukesh Ambani",
      "rank": 25,
      "country": "India",
      "industry": "Diversified",
      "photo_url": "https://imageio.forbes.com/specials-images/imageserve/5c7d7829a7ea434b351ba0b6/0x0.jpg?format=jpg&crop=1837,1839,x206,y250,safe&height=288&width=288&fit=bounds",
      "profile_url": "https://www.forbes.com/profile/mukesh-ambani/",
      "source_of_wealth": "Diversified",
      "net_worth_billions_usd": 82.2,
      "todays_change_billions_usd": -1.8771
    },
    {
      "age": 64,
      "name": "Gautam Adani",
      "rank": 26,
      "country": "India",
      "industry": "Diversified",
      "photo_url": "https://imageio.forbes.com/specials-images/imageserve/68e693f20b749254082e47fe/0x0.jpg?format=jpg&crop=2041,2042,x0,y161,safe&height=288&width=288&fit=bounds",
      "profile_url": "https://www.forbes.com/profile/gautam-adani-1/",
      "source_of_wealth": "Infrastructure, commodities",
      "net_worth_billions_usd": 78,
      "todays_change_billions_usd": -2.642
    },
    {
      "age": 76,
      "name": "Savitri Jindal & family",
      "rank": 56,
      "country": "India",
      "industry": "Metals & Mining",
      "photo_url": "https://imageio.forbes.com/specials-images/imageserve/55f77874e4b0ffa7afe4940e/0x0.jpg?format=jpg&crop=586,587,x90,y53,safe&height=288&width=288&fit=bounds",
      "profile_url": "https://www.forbes.com/profile/savitri-jindal/",
      "source_of_wealth": "Steel",
      "net_worth_billions_usd": 39.3,
      "todays_change_billions_usd": -0.7918
    }
  ]
}
```

### List global 2000

Operation `list_global_2000`, version 1. 1 credit per call.

List companies in the Forbes Global 2000 in rank order, optionally by year, country and industry. Financial figures are in billions of US dollars; results are limited to 500.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `2025` | Ranking year, such as 2025. Defaults to the most recent published list. |
| `country` | string | no | `"Japan"` | Country of headquarters, such as Japan. Omit for all countries. |
| `industry` | string | no | `"Banking"` | Industry name, such as Banking. Omit for all industries. |
| `max_results` | integer | no | `50` | Maximum companies to return, such as 50. Up to 500. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "description": "Ranking year, such as 2025. Defaults to the most recent published list.",
      "examples": [
        2025
      ]
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Country of headquarters, such as Japan. Omit for all countries.",
      "examples": [
        "Japan",
        "Atlantis"
      ]
    },
    "industry": {
      "type": "string",
      "default": "",
      "description": "Industry name, such as Banking. Omit for all industries.",
      "examples": [
        "Banking"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum companies to return, such as 50. Up to 500.",
      "x-fous-developer": true,
      "examples": [
        50,
        10,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "max_results": 50
    },
    {
      "year": 2025,
      "country": "Japan",
      "industry": "Banking",
      "max_results": 10
    },
    {
      "country": "Atlantis",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `year` | integer | `2025` |  |
| `companies` | array |  |  |
| `companies[].rank` | integer | `34` |  |
| `companies[].company` | string | `"Mitsubishi UFJ Financial"` |  |
| `companies[].country` | string or null | `"Japan"` |  |
| `companies[].industry` | string or null | `"Banking"` |  |
| `companies[].sales_billion_usd` | number or null | `83.453` |  |
| `companies[].assets_billion_usd` | number or null | `2629.124` |  |
| `companies[].profit_billion_usd` | number or null | `12.8176` |  |
| `companies[].forbes_company_link` | string | `"https://www.forbes.com/companies/mitsubishi-ufj-financial/?list=global2000"` |  |
| `companies[].market_value_billion_usd` | number or null | `139.794` |  |

**Example input**

```json
{
  "year": 2025,
  "country": "Japan",
  "industry": "Banking",
  "max_results": 10
}
```

**Example output**

```json
{
  "year": 2025,
  "companies": [
    {
      "rank": 34,
      "company": "Mitsubishi UFJ Financial",
      "country": "Japan",
      "industry": "Banking",
      "sales_billion_usd": 83.453,
      "assets_billion_usd": 2629.124,
      "profit_billion_usd": 12.8176,
      "forbes_company_link": "https://www.forbes.com/companies/mitsubishi-ufj-financial/?list=global2000",
      "market_value_billion_usd": 139.794
    },
    {
      "rank": 56,
      "company": "Sumitomo Mitsui Financial",
      "country": "Japan",
      "industry": "Banking",
      "sales_billion_usd": 64.055,
      "assets_billion_usd": 1977.939,
      "profit_billion_usd": 8.6213,
      "forbes_company_link": "https://www.forbes.com/companies/sumitomo-mitsui-financial/?list=global2000",
      "market_value_billion_usd": 87.949
    },
    {
      "rank": 90,
      "company": "Mizuho Financial",
      "country": "Japan",
      "industry": "Banking",
      "sales_billion_usd": 59.556,
      "assets_billion_usd": 1815.929,
      "profit_billion_usd": 5.8883,
      "forbes_company_link": "https://www.forbes.com/companies/mizuho-financial/?list=global2000",
      "market_value_billion_usd": 60.451
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@forbes",
  "visibility": "public",
  "operation": "get_company_rankings",
  "version": 1,
  "input": {
    "company": "Berkshire Hathaway"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@forbes\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_company_rankings\",\n  \"version\": 1,\n  \"input\": {\n    \"company\": \"Berkshire Hathaway\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@forbes",
  "visibility": "public",
  "operation": "get_company_rankings",
  "version": 1,
  "input": {
    "company": "Berkshire Hathaway"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@forbes","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Compare billionaire net worth across countries and industries
- Track changes in a billionaire's wealth
- Find companies by Global 2000 rank, country, or industry
- Review a company's rankings and headline financial figures

## FAQ

### Is Fous affiliated with Forbes?

No. Fous is not affiliated with Forbes. This workflow reads the public forbes.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Forbes account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from forbes.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### Who are the richest people, and what are their net worths?

List billionaires returns ranked people, net worth, daily change, and profile details.

### What is a named billionaire's current net worth?

Get person net worth returns a named billionaire's real-time wealth, daily change, rank, and profile details.

### How does a company rank, and what are its financial figures?

Get company rankings returns list appearances, company facts, and headline financial figures.

## Related

- [Fortune 500 API](https://fous.com/workflows/fortune-500.md): Fortune 500 ranks companies by revenue with year, industry, sector, and state filters and Fortune 500/1000 rankings; profile facts may be current, not historical.
- [CompaniesMarketCap API](https://fous.com/workflows/companiesmarketcap.md): CompaniesMarketCap ranks public companies worldwide or by country and industry across size and financial measures, and provides company figures with market-cap history for completed years.
- [Yahoo Finance API](https://fous.com/workflows/yahoo-finance.md): Yahoo Finance provides quotes, movers, company financials, analyst ratings, earnings, news, and up to 5,000 price rows with adjusted returns; prices may be delayed.
- [Glassdoor API](https://fous.com/workflows/glassdoor.md): Employee reviews and company ratings.
- [SEC EDGAR API](https://fous.com/workflows/sec-edgar.md): SEC EDGAR provides filings, annual and quarterly financials, exact-phrase matches, up to 200 insider trades, and quarterly 13F manager holdings; older filings appear when available.
- [Finviz API](https://fous.com/workflows/finviz.md): Finviz provides delayed US stock snapshots, screening by company and trading criteria, and up to 200 recent public executive and director Form 4 trades.
- [Stock Analysis API](https://fous.com/workflows/stock-analysis.md): Stock Analysis returns free-period company statements, statistics current as of its displayed date, typically top-25 ETF holdings, and US IPOs since 2019 with potentially missing prices or returns.
- [Google Finance API](https://fous.com/workflows/google-finance.md): Google Finance returns possibly delayed prices and figures, indexes, up to four movers timed by oldest quote, currency conversions, and up to five financial periods.
- [All Finance workflows](https://fous.com/workflows/category/finance)