# Forbes API: List Forbes Global 2000 companies > 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. Unofficial. Not affiliated with or endorsed by Forbes. - Page: https://fous.com/methods/forbes.com/list-global-2000 - Method: `forbes.com/list_global_2000`, version 1 - Website: forbes.com - Returns: year, rank, company, country, industry, sales, profit, assets, market value, Forbes 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 | |---|---|---|---|---| | `year` | integer | no | | Ranking year, such as 2025. Defaults to the most recent published list. | | `country` | string | no | | Country of headquarters, such as Japan. Omit for all countries. Default "". | | `industry` | string | no | | Industry name, such as Banking. Omit for all industries. Default "". | | `max_results` | integer | no | `500` | Maximum companies to return, such as 50. Up to 500. Default 50. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "max_results": 500 } ``` Its output: ```json { "year": 2026, "companies": [ { "rank": 1, "company": "JPMorganChase", "country": "United States", "industry": "Banking", "sales_billion_usd": 284.791, "assets_billion_usd": 4900.475, "profit_billion_usd": 58.63, "forbes_company_link": "https://www.forbes.com/companies/jpmorganchase/?list=global2000", "market_value_billion_usd": 797.985 }, { "rank": 2, "company": "Amazon", "country": "United States", "industry": "Retail and Wholesale", "sales_billion_usd": 742.776, "assets_billion_usd": 916.63, "profit_billion_usd": 90.798, "forbes_company_link": "https://www.forbes.com/companies/amazon/?list=global2000", "market_value_billion_usd": 2841.38 }, { "rank": 3, "company": "Berkshire Hathaway", "country": "United States", "industry": "Insurance", "sales_billion_usd": 375.394, "assets_billion_usd": 1252.271, "profit_billion_usd": 72.471, "forbes_company_link": "https://www.forbes.com/companies/berkshire-hathaway/?list=global2000", "market_value_billion_usd": 1041.121 } ] } ``` ## 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":"forbes.com/list_global_2000","input":{"max_results":500}}' ``` 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 Japanese banks on the Forbes Global 2000 for 2024, with their sales, profits, assets and market value - Which German companies made the 2025 list of the world's 2,000 largest public companies, and how do they rank? - I need the 100 highest-ranked oil and gas firms globally by the latest Global 2000 ranking, with revenue and profit figures in billions - List Indian companies in the 2023 Forbes ranking of the world's biggest public companies, including market cap and assets - Pull the top 10 semiconductor companies from this year's global 2000 largest companies list along with their links on forbes.com ## Input schema ```json { "type": "object", "properties": { "year": { "type": "integer", "description": "Ranking year, such as 2025. Defaults to the most recent published list." }, "country": { "type": "string", "default": "", "description": "Country of headquarters, such as Japan. Omit for all countries." }, "industry": { "type": "string", "default": "", "description": "Industry name, such as Banking. Omit for all industries." }, "max_results": { "type": "integer", "default": 50, "maximum": 500, "minimum": 1, "description": "Maximum companies to return, such as 50. Up to 500." } } } ``` ## Output schema ```json { "type": "object", "required": [ "year", "companies" ], "properties": { "year": { "type": "integer" }, "companies": { "type": "array", "items": { "type": "object", "required": [ "rank", "company", "country", "industry", "sales_billion_usd", "profit_billion_usd", "assets_billion_usd", "market_value_billion_usd", "forbes_company_link" ], "properties": { "rank": { "type": "integer" }, "company": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "industry": { "type": [ "string", "null" ] }, "sales_billion_usd": { "type": [ "number", "null" ] }, "assets_billion_usd": { "type": [ "number", "null" ] }, "profit_billion_usd": { "type": [ "number", "null" ] }, "forbes_company_link": { "type": "string" }, "market_value_billion_usd": { "type": [ "number", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [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). - [Forbes API: List billionaires](https://fous.com/methods/forbes.com/list-billionaires.md): Lists the richest people in rank order from Forbes Real-Time Billionaires, with net worth, daily change and profile details. Filter by country of citizenship or industry; wealth and changes are in billions of US dollars. - [Forbes API: Get billionaire net worth](https://fous.com/methods/forbes.com/get-person-net-worth.md): Looks up a billionaire by name on the Forbes real-time billionaires list and returns their real-time net worth, today's change, rank and public profile details. Wealth figures change throughout the trading day. - [Fortune API: List Fortune 500 companies](https://fous.com/methods/fortune.com/list-fortune-500.md): Lists the Fortune 500 for a year. You can filter by industry or sector and by headquarters state. Each company comes with its public financial and company details. - [Fortune API: Get company Fortune 500 rank](https://fous.com/methods/fortune.com/get-company-rank.md): Gets 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. - [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: List recent IPOs](https://fous.com/methods/stockanalysis.com/list-recent-ipos.md): Lists US IPOs from a chosen year, newest first. Each IPO comes with its IPO price, current price and return since IPO. Coverage begins in 2019. - [IMF API: List country rankings](https://fous.com/methods/imf.org/list-country-rankings.md): Ranks countries by a World Economic Outlook indicator for a chosen year, excluding regional and group totals and countries without a value. - [All Forbes methods](https://fous.com/methods/forbes.com.md)