# 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. - Page: https://fous.com/methods/companiesmarketcap.com/get-company-size - Method: `companiesmarketcap.com/get_company_size`, version 1 - Website: companiesmarketcap.com - Returns: company name, ticker, country, market cap, rank, revenue, earnings, employees, dividend yield, P/E, share price, market cap by year - 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 | |---|---|---|---|---| | `company` | string | yes | `"Coca-Cola"` | Company name or stock ticker, for example Coca-Cola or KO. | ## Output From a run on Oct 27, 2026, shortened. Its input: ```json { "company": "Coca-Cola" } ``` Its output: ```json { "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 } ``` ## 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/get_company_size","input":{"company":"Coca-Cola"}}' ``` 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 - 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? ## Input schema ```json { "type": "object", "required": [ "company" ], "properties": { "company": { "type": "string", "description": "Company name or stock ticker, for example Coca-Cola or KO." } } } ``` ## Output schema ```json { "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." } } } ``` ## See more - [CompaniesMarketCap API: List largest companies](https://fous.com/methods/companiesmarketcap.com/list-largest-companies.md): 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. - [Stock Analysis API: Get key statistics](https://fous.com/methods/stockanalysis.com/get-key-statistics.md): Looks 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. - [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). - [MSN API: Get stock quote](https://fous.com/methods/msn.com/get-stock-quote.md): Gets 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. - [SEC EDGAR API: Get company financials](https://fous.com/methods/sec.gov/get-company-financials.md): Looks 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. - [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. - [Finviz API: Get stock snapshot](https://fous.com/methods/finviz.com/get-stock-snapshot.md): Get 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. - [LinkedIn API: Get company profile](https://fous.com/methods/linkedin.com/get-company-profile.md): Gets the public overview of a LinkedIn company from its name or company page link. Details not shown publicly are null. - [All CompaniesMarketCap methods](https://fous.com/methods/companiesmarketcap.com.md)