CompaniesMarketCap API: Get company size
Looks up a public company's size, financial figures and completed-year market-cap history from its name or ticker.
Unofficial. Not affiliated with or endorsed by CompaniesMarketCap.
Inputs
Values from the run on Oct 27, 2026, shown under Output.
- Company, required
company Company name or stock ticker, for example Coca-Cola or KO.
Coca-Cola
Input as JSON
{ "company": "Coca-Cola"}Output
{ "ticker": "KO", "country": "United States", "currency": "USD", "employees": 65900, "company_name": "Coca-Cola", "earnings_usd": 18790000000, "market_cap_usd": 398840000000, "share_price_usd": 92.7, "company_page_link": "https://companiesmarketcap.com/coca-cola/marketcap/" , "market_cap_by_year": [ { "year": 1996, "market_cap_usd": 130560000000 }, { "year": 1997, "market_cap_usd": 164760000000 }, { "year": 1998, "market_cap_usd": 165180000000 } ], "dividend_yield_percent": 1.69, "global_market_cap_rank": 34, "price_to_earnings_ratio": 27.8, "revenue_last_12_months_usd": 50120000000}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"companiesmarketcap.com/get_company_size","input":{"company":"Coca-Cola"}}' # 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/get_company_size" , "input": { "company": "Coca-Cola" }})# 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/get_company_size" , "input": { "company": "Coca-Cola" } }), 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/get_company_size# with {"company":"Coca-Cola"}"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", "required": [ "company" ], "properties": { "company": { "type": "string", "description": "Company name or stock ticker, for example Coca-Cola or KO." } }}Output schema
{ "type": "object", "required": [ "company_name", "ticker", "country", "market_cap_usd", "global_market_cap_rank", "revenue_last_12_months_usd", "earnings_usd", "employees", "dividend_yield_percent", "price_to_earnings_ratio", "share_price_usd", "currency", "company_page_link", "market_cap_by_year" ], "properties": { "ticker": { "type": [ "string", "null" ], "description": "Stock ticker." }, "country": { "type": [ "string", "null" ], "description": "Country where the company is based." }, "currency": { "type": [ "string", "null" ], "description": "Currency code for money amounts; USD." }, "employees": { "type": [ "integer", "null" ], "description": "Number of employees." }, "company_name": { "type": [ "string", "null" ], "description": "Company name." }, "earnings_usd": { "type": [ "number", "null" ], "description": "Current earnings in USD, as reported by the site." }, "market_cap_usd": { "type": [ "number", "null" ], "description": "Current market capitalization in USD." }, "share_price_usd": { "type": [ "number", "null" ], "description": "Share price in USD." }, "company_page_link": { "type": [ "string", "null" ], "description": "Link to the company market-cap page." }, "market_cap_by_year": { "type": "array", "items": { "type": "object", "required": [ "year", "market_cap_usd" ], "properties": { "year": { "type": "integer", "description": "Completed calendar year." }, "market_cap_usd": { "type": "number", "description": "Market capitalization in USD at year end." } } }, "description": "Market capitalization at the end of each completed year, oldest first." }, "dividend_yield_percent": { "type": [ "number", "null" ], "description": "Current annual dividend yield, in percent." }, "global_market_cap_rank": { "type": [ "integer", "null" ], "description": "Worldwide market-cap rank." }, "price_to_earnings_ratio": { "type": [ "number", "null" ], "description": "Current P/E ratio." }, "revenue_last_12_months_usd": { "type": [ "number", "null" ], "description": "Revenue in the last 12 months in USD." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
companiesmarketcap.com/get_company_size- Returns
- company name, ticker, country, market cap, rank, revenue, earnings, employees, dividend yield, P/E, share price, market cap by year
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/get_company_size with the inputs above.
Ask your agent
- How many employees does Coca-Cola have and what was its market cap at the end of last year?
- What is KO's current P/E ratio and dividend yield?
- Show me Tesla's revenue, earnings and rank by market capitalization on companiesmarketcap.com
- I need the share price and yearly market cap history for Microsoft (MSFT) over the completed years.
- Which country is Toyota Motor listed in, and what are its annual revenue and earnings figures?
See more
All CompaniesMarketCap methodsRanks 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.
companiesmarketcap.com/list_largest_companiesLooks up a stock by company name or ticker on Stock Analysis and returns its valuation ratios and company statistics, with the date the figures were last updated.
stockanalysis.com/get_key_statisticsFinds 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_rankingsGets a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours.
msn.com/get_stock_quoteLooks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null.
sec.gov/get_company_financialsFinds 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_stocksGet a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null.
finviz.com/get_stock_snapshotGets the public overview of a LinkedIn company from its name or company page link. Details not shown publicly are null.
linkedin.com/get_company_profile