# Fortune 500 API

> Fortune 500 returns company rankings and financial details as a workflow and API.

Fortune 500 lists companies ranked 1–500 with financial and company details; filter by year, state, industry or sector, and result count. Get company rank returns a company’s Fortune 500 or Fortune 1000 rank and headline figures; provide a company name and optionally a list year.

- Page: https://fous.com/tools/fortune-500
- Handle: `@fortune-500`
- Category: [Finance](https://fous.com/tools/category/finance)
- Source website: https://fortune.com/ranking/fortune500
- Last verified: Sep 29, 2026

## Methods

### Get company rank

Operation `get_company_rank`, 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.

Get a company’s Fortune 500 or Fortune 1000 rank and headline figures for a list year. CEO, ticker and website come from the current company profile and may not reflect a historical year.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `2025` | List year, for example 2025. Omit for the latest available list. |
| `company` | string | yes | `"Apple"` | Company name, for example Walmart. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "company"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "List year, for example 2025. Omit for the latest available list.",
      "examples": [
        2025,
        2024
      ]
    },
    "company": {
      "type": "string",
      "description": "Company name, for example Walmart.",
      "examples": [
        "Apple",
        "Walmart",
        "Amazon.com"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "year": 2025,
      "company": "Apple"
    },
    {
      "company": "Walmart"
    },
    {
      "year": 2024,
      "company": "Walmart"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `ceo` | string or null | `"John Ternus"` | CEO listed on the current company profile. |
| `year` | integer | `2025` | Fortune 500 list year. |
| `sector` | string or null | `"Technology"` | Sector on the selected year’s list. |
| `ticker` | string or null | `"AAPL"` | Stock ticker listed on the current company profile. |
| `company` | string | `"Apple"` | Company name on the list. |
| `website` | string or null | `"https://www.apple.com"` | Website listed on the current company profile. |
| `industry` | string or null | `"Computers, Office Equipment"` | Industry on the selected year’s list. |
| `employees` | integer or null | `164000` | Number of employees. |
| `rank_last_year` | integer or null | `3` | Previous year’s rank, if published. |
| `rank_this_year` | integer | `4` | Rank on the chosen Fortune 500/1000 list. |
| `headquarters_city` | string or null | `"Cupertino"` | Headquarters city. |
| `headquarters_state` | string or null | `"California"` | Headquarters state. |
| `assets_millions_usd` | number or null | `364980` | Assets in millions of U.S. dollars. |
| `profit_millions_usd` | number or null | `93736` | Profit in millions of U.S. dollars. |
| `fortune_profile_link` | string | `"https://fortune.com/company/apple/"` | Fortune company profile link. |
| `revenue_millions_usd` | number or null | `391035` | Revenue in millions of U.S. dollars. |
| `revenue_change_percent` | number or null | `2` | Revenue change in percent. |
| `market_value_millions_usd` | number or null | `3336853.1` | Market value in millions of U.S. dollars. |

**Example input**

```json
{
  "year": 2025,
  "company": "Apple"
}
```

**Example output**

```json
{
  "ceo": "John Ternus",
  "year": 2025,
  "sector": "Technology",
  "ticker": "AAPL",
  "company": "Apple",
  "website": "https://www.apple.com",
  "industry": "Computers, Office Equipment",
  "employees": 164000,
  "rank_last_year": 3,
  "rank_this_year": 4,
  "headquarters_city": "Cupertino",
  "headquarters_state": "California",
  "assets_millions_usd": 364980,
  "profit_millions_usd": 93736,
  "fortune_profile_link": "https://fortune.com/company/apple/",
  "revenue_millions_usd": 391035,
  "revenue_change_percent": 2,
  "market_value_millions_usd": 3336853.1
}
```

### List fortune 500

Operation `list_fortune_500`, 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 Fortune 500 by year, industry or sector, and headquarters state, with publicly shown financial and company details. Returns only ranks 1–500; unavailable values are null.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `2025` | List year, such as 2025. Defaults to the latest available year. |
| `state` | string | no | `"Texas"` | Headquarters state name or two-letter code, such as Texas or TX. Defaults to all. |
| `max_results` | integer | no | `20` | Maximum companies to return, such as 100. |
| `industry_or_sector` | string | no | `"Retail"` | Industry or sector to match, such as Retail. Defaults to all. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 1996,
      "description": "List year, such as 2025. Defaults to the latest available year.",
      "examples": [
        2025
      ]
    },
    "state": {
      "type": "string",
      "description": "Headquarters state name or two-letter code, such as Texas or TX. Defaults to all.",
      "examples": [
        "Texas",
        "TX"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "description": "Maximum companies to return, such as 100.",
      "x-fous-developer": true,
      "examples": [
        20,
        10
      ]
    },
    "industry_or_sector": {
      "type": "string",
      "description": "Industry or sector to match, such as Retail. Defaults to all.",
      "examples": [
        "Retail",
        "Unfindable Industry XYZ"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {},
    {
      "year": 2025,
      "state": "Texas",
      "max_results": 20,
      "industry_or_sector": "Retail"
    },
    {
      "state": "TX",
      "max_results": 10
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `year` | integer | `2026` | Year of the Fortune 500 list. |
| `currency` | string | `"USD"` | Currency code for monetary values. |
| `companies` | array |  | Matching companies in rank order. |
| `companies[].rank` | integer | `1` | Fortune 500 rank. |
| `companies[].sector` | string or null | `"Retailing"` | Sector. |
| `companies[].company` | string | `"Amazon"` | Company name. |
| `companies[].industry` | string or null | `"Internet Services and Retailing"` | Industry. |
| `companies[].employees` | integer or null | `1576000` | Employee count. |
| `companies[].headquarters_city` | string or null | `"Seattle"` | Headquarters city. |
| `companies[].headquarters_state` | string or null | `"Washington"` | Headquarters state. |
| `companies[].assets_millions_usd` | number or null | `818042` | Assets, in millions of US dollars. |
| `companies[].profit_millions_usd` | number or null | `77670` | Profit, in millions of US dollars. |
| `companies[].fortune_profile_link` | string or null | `"https://fortune.com/company/amazon-com/"` | Fortune company profile link. |
| `companies[].revenue_millions_usd` | number or null | `716924` | Revenue, in millions of US dollars. |
| `companies[].profit_change_percent` | number or null | `31.1` | Profit change as a percentage. |
| `companies[].revenue_change_percent` | number or null | `12.4` | Revenue change as a percentage. |
| `companies[].market_value_millions_usd` | number or null | `2235762` | Market value, in millions of US dollars. |

**Example input**

```json
{}
```

**Example output**

```json
{
  "year": 2026,
  "currency": "USD",
  "companies": [
    {
      "rank": 1,
      "sector": "Retailing",
      "company": "Amazon",
      "industry": "Internet Services and Retailing",
      "employees": 1576000,
      "headquarters_city": "Seattle",
      "headquarters_state": "Washington",
      "assets_millions_usd": 818042,
      "profit_millions_usd": 77670,
      "fortune_profile_link": "https://fortune.com/company/amazon-com/",
      "revenue_millions_usd": 716924,
      "profit_change_percent": 31.1,
      "revenue_change_percent": 12.4,
      "market_value_millions_usd": 2235762
    },
    {
      "rank": 2,
      "sector": "Retailing",
      "company": "Walmart",
      "industry": "General Merchandisers",
      "employees": 2100000,
      "headquarters_city": "Bentonville",
      "headquarters_state": "Arkansas",
      "assets_millions_usd": 284668,
      "profit_millions_usd": 21893,
      "fortune_profile_link": "https://fortune.com/company/walmart/",
      "revenue_millions_usd": 713163,
      "profit_change_percent": 12.6,
      "revenue_change_percent": 4.7,
      "market_value_millions_usd": 990810.2
    },
    {
      "rank": 3,
      "sector": "Health Care",
      "company": "UnitedHealth Group",
      "industry": "Health Care: Insurance and Managed Care",
      "employees": 390000,
      "headquarters_city": "Eden Prairie",
      "headquarters_state": "Minnesota",
      "assets_millions_usd": 309581,
      "profit_millions_usd": 12056,
      "fortune_profile_link": "https://fortune.com/company/unitedhealth-group/",
      "revenue_millions_usd": 447567,
      "profit_change_percent": -16.3,
      "revenue_change_percent": 11.8,
      "market_value_millions_usd": 245608
    }
  ]
}
```

## 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": "@fortune-500",
  "visibility": "public",
  "operation": "get_company_rank",
  "version": 1,
  "input": {
    "year": 2025,
    "company": "Apple"
  },
  "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\": \"@fortune-500\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_company_rank\",\n  \"version\": 1,\n  \"input\": {\n    \"year\": 2025,\n    \"company\": \"Apple\"\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": "@fortune-500",
  "visibility": "public",
  "operation": "get_company_rank",
  "version": 1,
  "input": {
    "year": 2025,
    "company": "Apple"
  },
  "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/fortune-500`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_company_rank`: Get company rank. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_fortune_500`: List Fortune 500. 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-fortune-500 https://api.fous.com/mcp/tools/fortune-500 --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 company revenue across industries and years
- Find companies headquartered in a particular state
- Review a company’s rank and financial figures
- Track changes in company revenue and profit

## 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 Fortune 500 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 Fortune 500 account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from fortune.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.

### What is a company’s Fortune 500 rank?

Get company rank returns the company’s rank for a selected list year when you provide its name.

### Which companies are in a particular industry or state?

List fortune 500 filters ranked companies by industry or sector and headquarters state.

### What revenue and profit figures are listed for a company?

Get company rank returns revenue and profit figures for a named company; List fortune 500 returns these figures for matching companies.

## Related

- [Forbes API](https://fous.com/tools/forbes.md): Forbes provides business news, real-time billionaire rankings and wealth that can change during the trading day, plus ranked Global 2000 companies with financial figures and company profiles.
- [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.
- [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.
- [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.
- [Macrotrends API](https://fous.com/tools/macrotrends.md): Macrotrends provides long-term financial and economic charts, company metric histories, and yearly commodity and index prices; current-year prices may be incomplete.
- [MSN Money API](https://fous.com/tools/msn-money.md): MSN Money provides stock quotes, key facts, financial news, and market data, including current market movers; quotes and prices may be delayed.
- [All Finance tools](https://fous.com/tools/category/finance)