# 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/workflows/fortune-500
- Handle: `@fortune-500`
- Category: [Finance](https://fous.com/workflows/category/finance)
- Source website: https://fortune.com/ranking/fortune500
- Last verified: Sep 29, 2026
- Fous is not affiliated with Fortune 500.

## Methods

### Get company rank

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

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 call.

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 | `2025` | Year of the Fortune 500 list. |
| `currency` | string | `"USD"` | Currency code for monetary values. |
| `companies` | array |  | Matching companies in rank order. |
| `companies[].rank` | integer | `214` | Fortune 500 rank. |
| `companies[].sector` | string or null | `"Retailing"` | Sector. |
| `companies[].company` | string | `"Group 1 Automotive"` | Company name. |
| `companies[].industry` | string or null | `"Automotive Retailing, Services"` | Industry. |
| `companies[].employees` | integer or null | `20413` | Employee count. |
| `companies[].headquarters_city` | string or null | `"Houston"` | Headquarters city. |
| `companies[].headquarters_state` | string or null | `"Texas"` | Headquarters state. |
| `companies[].assets_millions_usd` | number or null | `9824.2` | Assets, in millions of US dollars. |
| `companies[].profit_millions_usd` | number or null | `498.1` | Profit, in millions of US dollars. |
| `companies[].fortune_profile_link` | string or null | `"https://fortune.com/company/group-1-automotive/"` | Fortune company profile link. |
| `companies[].revenue_millions_usd` | number or null | `19934.3` | Revenue, in millions of US dollars. |
| `companies[].profit_change_percent` | number or null | `-17.2` | Profit change as a percentage. |
| `companies[].revenue_change_percent` | number or null | `11.5` | Revenue change as a percentage. |
| `companies[].market_value_millions_usd` | number or null | `4981.1` | Market value, in millions of US dollars. |

**Example input**

```json
{
  "year": 2025,
  "state": "Texas",
  "max_results": 20,
  "industry_or_sector": "Retail"
}
```

**Example output**

```json
{
  "year": 2025,
  "currency": "USD",
  "companies": [
    {
      "rank": 214,
      "sector": "Retailing",
      "company": "Group 1 Automotive",
      "industry": "Automotive Retailing, Services",
      "employees": 20413,
      "headquarters_city": "Houston",
      "headquarters_state": "Texas",
      "assets_millions_usd": 9824.2,
      "profit_millions_usd": 498.1,
      "fortune_profile_link": "https://fortune.com/company/group-1-automotive/",
      "revenue_millions_usd": 19934.3,
      "profit_change_percent": -17.2,
      "revenue_change_percent": 11.5,
      "market_value_millions_usd": 4981.1
    },
    {
      "rank": 479,
      "sector": "Retailing",
      "company": "Rush Enterprises",
      "industry": "Automotive Retailing, Services",
      "employees": 7882,
      "headquarters_city": "New Braunfels",
      "headquarters_state": "Texas",
      "assets_millions_usd": 4617.5,
      "profit_millions_usd": 304.2,
      "fortune_profile_link": "https://fortune.com/company/rush-enterprises/",
      "revenue_millions_usd": 7804.7,
      "profit_change_percent": -12.4,
      "revenue_change_percent": -1.5,
      "market_value_millions_usd": 4284.1
    }
  ]
}
```

## 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": "@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.
# 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\": \"@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=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": "@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);
```

Or describe the data in plain language: send `{"api":"@fortune-500","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 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

### Is Fous affiliated with Fortune 500?

No. Fous is not affiliated with Fortune 500. This workflow reads the public fortune.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 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; 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.

### 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/workflows/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/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.
- [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.
- [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.
- [Macrotrends API](https://fous.com/workflows/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/workflows/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 workflows](https://fous.com/workflows/category/finance)