# CompaniesMarketCap API: List largest companies

> Ranks public companies worldwide, or by country and industry, by market cap, revenue, earnings, employees or dividend yield. When both a country and an industry are set, the industry ranking order is kept and only companies from that country are shown.

Unofficial. Not affiliated with or endorsed by CompaniesMarketCap.

- Page: https://fous.com/methods/companiesmarketcap.com/list-largest-companies
- Method: `companiesmarketcap.com/list_largest_companies`, version 1
- Website: companiesmarketcap.com
- Returns: rank, company name, ticker, ranking value, share price, today's change, country, company page link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `country` | string | no | `"Germany"` | Country name, such as Germany; World for all countries. Default "World". |
| `rank_by` | string | no | `"market_cap"` | Measure for ranking companies, such as revenue. One of "market_cap", "revenue", "earnings", "employees", "dividend_yield". Default "market_cap". |
| `industry` | string | no | `"semiconductors"` | Industry name, such as semiconductors; All for all industries. Default "All". |
| `max_results` | integer | no | `10` | Maximum number of companies, such as 50. Default 50. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "country": "Germany",
  "rank_by": "market_cap",
  "industry": "semiconductors",
  "max_results": 10
}
```

Its output:

```json
{
  "companies": [
    {
      "rank": 1,
      "ticker": "IFX.DE",
      "country": "Germany",
      "company_name": "Infineon",
      "ranking_unit": "USD",
      "ranking_value": 72835919839,
      "share_price_usd": 56.05,
      "company_page_link": "https://companiesmarketcap.com/infineon/marketcap/",
      "ranking_value_shown": "$72.83 B",
      "todays_change_percent": 0.02
    },
    {
      "rank": 2,
      "ticker": "AIXA.F",
      "country": "Germany",
      "company_name": "Aixtron",
      "ranking_unit": "USD",
      "ranking_value": 3783178675,
      "share_price_usd": 33.54,
      "company_page_link": "https://companiesmarketcap.com/aixtron/marketcap/",
      "ranking_value_shown": "$3.78 B",
      "todays_change_percent": 2.23
    },
    {
      "rank": 3,
      "ticker": "ELG.DE",
      "country": "Germany",
      "company_name": "Elmos Semiconductor",
      "ranking_unit": "USD",
      "ranking_value": 2360640453,
      "share_price_usd": 137.05,
      "company_page_link": "https://companiesmarketcap.com/elmos-semiconductor/marketcap/",
      "ranking_value_shown": "$2.36 B",
      "todays_change_percent": -0.49
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"companiesmarketcap.com/list_largest_companies","input":{"country":"Germany","rank_by":"market_cap","industry":"semiconductors","max_results":10}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the top 20 companies in Germany ranked by revenue
- What are the biggest semiconductor companies in the world by market cap?
- List the top 30 companies with the highest dividend yield worldwide
- Which Japanese banks have the largest market capitalization on companiesmarketcap.com?
- Rank the world's top 50 companies by number of employees

## Input schema

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "World",
      "description": "Country name, such as Germany; World for all countries."
    },
    "rank_by": {
      "enum": [
        "market_cap",
        "revenue",
        "earnings",
        "employees",
        "dividend_yield"
      ],
      "type": "string",
      "default": "market_cap",
      "description": "Measure for ranking companies, such as revenue."
    },
    "industry": {
      "type": "string",
      "default": "All",
      "description": "Industry name, such as semiconductors; All for all industries."
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of companies, such as 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "companies"
  ],
  "properties": {
    "companies": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "company_name",
          "ranking_value_shown",
          "ranking_unit",
          "company_page_link"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "ticker": {
            "type": [
              "string",
              "null"
            ]
          },
          "country": {
            "type": [
              "string",
              "null"
            ]
          },
          "company_name": {
            "type": "string"
          },
          "ranking_unit": {
            "enum": [
              "USD",
              "employees",
              "percent"
            ],
            "type": "string"
          },
          "ranking_value": {
            "type": [
              "number",
              "null"
            ]
          },
          "share_price_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "company_page_link": {
            "type": "string"
          },
          "ranking_value_shown": {
            "type": "string"
          },
          "todays_change_percent": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [CompaniesMarketCap API: Get company size](https://fous.com/methods/companiesmarketcap.com/get-company-size.md): Looks up a public company's size, financial figures and completed-year market-cap history from its name or ticker.
- [CoinMarketCap API: List top coins by market cap](https://fous.com/methods/coinmarketcap.com/list-top-coins.md): Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
- [Forbes API: List Forbes Global 2000 companies](https://fous.com/methods/forbes.com/list-global-2000.md): Lists companies in the Forbes Global 2000 in rank order, optionally for a given year, country of headquarters and industry. Financial figures are in billions of US dollars; up to 500 results.
- [TradingView API: Screen stocks by country, sector and size](https://fous.com/methods/tradingview.com/screen-stocks.md): Finds publicly listed stocks in a country, filtered by sector, US-dollar market cap band and minimum dividend yield, in the requested order. Quotes may be delayed.
- [Forbes API: Get company rankings](https://fous.com/methods/forbes.com/get-company-rankings.md): Finds a Forbes company profile by name and returns its Forbes list rankings, company facts and headline financial figures (Forbes list years; market value from the matching Global 2000 list).
- [Similarweb API: List top websites](https://fous.com/methods/similarweb.com/list-top-websites.md): Lists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
- [MSN API: List market movers](https://fous.com/methods/msn.com/list-market-movers.md): Lists MSN Money's current leading stock gainers, losers, or most-active shares in a selected market, in MSN's order. Lists may contain fewer than 50 stocks and prices may be delayed.
- [Yahoo API: List market movers](https://fous.com/methods/finance.yahoo.com/list-market-movers.md): Lists Yahoo Finance's top gainers, top losers, most active stocks, or regional trending tickers in Yahoo's order, with price, change, volume and market cap.
- [All CompaniesMarketCap methods](https://fous.com/methods/companiesmarketcap.com.md)
