# 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/tools/forbes
- Handle: `@forbes`
- Category: [Finance](https://fous.com/tools/category/finance)
- Source website: https://forbes.com
- Last verified: Sep 29, 2026

## Methods

### Get company rankings

Operation `get_company_rankings`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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 completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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 completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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:25:02.187000+00:00"` | When the list was updated (ISO 8601 with UTC offset). |
| `billionaires` | array |  |  |
| `billionaires[].age` | integer or null | `55` |  |
| `billionaires[].name` | string | `"Elon Musk"` |  |
| `billionaires[].rank` | integer | `1` |  |
| `billionaires[].country` | string or null | `"United States"` |  |
| `billionaires[].industry` | string or null | `"Technology"` |  |
| `billionaires[].photo_url` | string or null | `"https://imageio.forbes.com/specials-images/imageserve/62d700cd6094d2c180f269b9/0x0.jpg?format=jpg&crop=959,959,x0,y0,sa` |  |
| `billionaires[].profile_url` | string | `"https://www.forbes.com/profile/elon-musk/"` |  |
| `billionaires[].source_of_wealth` | string or null | `"Tesla, SpaceX"` |  |
| `billionaires[].net_worth_billions_usd` | number | `906.7` |  |
| `billionaires[].todays_change_billions_usd` | number or null | `-22.2237` |  |

**Example input**

```json
{}
```

**Example output**

```json
{
  "updated_at": "2026-09-29T02:25:02.187000+00:00",
  "billionaires": [
    {
      "age": 55,
      "name": "Elon Musk",
      "rank": 1,
      "country": "United States",
      "industry": "Technology",
      "photo_url": "https://imageio.forbes.com/specials-images/imageserve/62d700cd6094d2c180f269b9/0x0.jpg?format=jpg&crop=959,959,x0,y0,safe&height=288&width=288&fit=bounds",
      "profile_url": "https://www.forbes.com/profile/elon-musk/",
      "source_of_wealth": "Tesla, SpaceX",
      "net_worth_billions_usd": 906.7,
      "todays_change_billions_usd": -22.2237
    },
    {
      "age": 62,
      "name": "Jeff Bezos",
      "rank": 2,
      "country": "United States",
      "industry": "Technology",
      "photo_url": "https://imageio.forbes.com/specials-images/imageserve/67531eb2b5f7c9e191f632d7/0x0.jpg?format=jpg&crop=711,713,x316,y125,safe&height=288&width=288&fit=bounds",
      "profile_url": "https://www.forbes.com/profile/jeff-bezos/",
      "source_of_wealth": "Amazon",
      "net_worth_billions_usd": 366.4,
      "todays_change_billions_usd": -3.1131
    },
    {
      "age": 53,
      "name": "Larry Page",
      "rank": 3,
      "country": "United States",
      "industry": "Technology",
      "photo_url": "https://imageio.forbes.com/specials-images/imageserve/5c76bcaaa7ea43100043c836/0x0.jpg?format=jpg&crop=1795,1795,x227,y22,safe&height=288&width=288&fit=bounds",
      "profile_url": "https://www.forbes.com/profile/larry-page/",
      "source_of_wealth": "Google",
      "net_worth_billions_usd": 281.1,
      "todays_change_billions_usd": -1.206
    }
  ]
}
```

### List global 2000

Operation `list_global_2000`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

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 | `2026` |  |
| `companies` | array |  |  |
| `companies[].rank` | integer | `1` |  |
| `companies[].company` | string | `"JPMorganChase"` |  |
| `companies[].country` | string or null | `"United States"` |  |
| `companies[].industry` | string or null | `"Banking"` |  |
| `companies[].sales_billion_usd` | number or null | `284.791` |  |
| `companies[].assets_billion_usd` | number or null | `4900.475` |  |
| `companies[].profit_billion_usd` | number or null | `58.63` |  |
| `companies[].forbes_company_link` | string | `"https://www.forbes.com/companies/jpmorganchase/?list=global2000"` |  |
| `companies[].market_value_billion_usd` | number or null | `797.985` |  |

**Example input**

```json
{
  "max_results": 50
}
```

**Example output**

```json
{
  "year": 2026,
  "companies": [
    {
      "rank": 1,
      "company": "JPMorganChase",
      "country": "United States",
      "industry": "Banking",
      "sales_billion_usd": 284.791,
      "assets_billion_usd": 4900.475,
      "profit_billion_usd": 58.63,
      "forbes_company_link": "https://www.forbes.com/companies/jpmorganchase/?list=global2000",
      "market_value_billion_usd": 797.985
    },
    {
      "rank": 2,
      "company": "Amazon",
      "country": "United States",
      "industry": "Retail and Wholesale",
      "sales_billion_usd": 742.776,
      "assets_billion_usd": 916.63,
      "profit_billion_usd": 90.798,
      "forbes_company_link": "https://www.forbes.com/companies/amazon/?list=global2000",
      "market_value_billion_usd": 2841.38
    },
    {
      "rank": 3,
      "company": "Berkshire Hathaway",
      "country": "United States",
      "industry": "Insurance",
      "sales_billion_usd": 375.394,
      "assets_billion_usd": 1252.271,
      "profit_billion_usd": 72.471,
      "forbes_company_link": "https://www.forbes.com/companies/berkshire-hathaway/?list=global2000",
      "market_value_billion_usd": 1041.121
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_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.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

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=180) 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.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_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);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/forbes`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_company_rankings`: Get company rankings. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_person_net_worth`: Get person net worth. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_billionaires`: List billionaires. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_global_2000`: List global 2000. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-forbes https://api.fous.com/mcp/tools/forbes --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## 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

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Forbes tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. 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. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified 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/tools/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/tools/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/tools/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/tools/glassdoor.md): Employee reviews and company ratings.
- [SEC EDGAR API](https://fous.com/tools/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/tools/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/tools/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/tools/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 tools](https://fous.com/tools/category/finance)