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.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country Country name, such as Germany; World for all countries.
Germany
Default
World.- Rank by optional
rank_by Measure for ranking companies, such as revenue.
market_cap
One of
market_cap,revenue,earnings,employees,dividend_yield. Defaultmarket_cap.- Industry optional
industry Industry name, such as semiconductors; All for all industries.
semiconductors
Default
All.- Max Results optional
max_results Maximum number of companies, such as 50.
10
Whole number from 1 to 100. Default
50.
Input as JSON
{ "country": "Germany", "rank_by": "market_cap", "industry": "semiconductors", "max_results": 10}Output
{ "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 } ]}Code
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}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "companiesmarketcap.com/list_largest_companies" , "input": { "country": "Germany", "rank_by": "market_cap", "industry": "semiconductors", "max_results": 10 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "companiesmarketcap.com/list_largest_companies" , "input": { "country": "Germany", "rank_by": "market_cap", "industry": "semiconductors", "max_results": 10 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run companiesmarketcap.com/list_largest_companies# with {"country":"Germany","rank_by":"market_cap","industry":"semiconductors","max_results":10}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
companiesmarketcap.com/list_largest_companies- Returns
- rank, company name, ticker, ranking value, share price, today's change, country, company page link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method companiesmarketcap.com/list_largest_companies with the inputs above.
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
See more
All CompaniesMarketCap methodsLooks up a public company's size, financial figures and completed-year market-cap history from its name or ticker.
companiesmarketcap.com/get_company_sizeLists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
coinmarketcap.com/list_top_coinsLists 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.
forbes.com/list_global_2000Finds 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.
tradingview.com/screen_stocksFinds 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).
forbes.com/get_company_rankingsLists 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.
similarweb.com/list_top_websitesLists 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.
msn.com/list_market_moversLists 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.
finance.yahoo.com/list_market_movers