companiesmarketcap.com APIcompaniesmarketcap.com ↗
Access global market cap rankings, company financial profiles, and historical metrics for publicly traded companies via the companiesmarketcap.com API.
curl -X GET 'https://api.parse.bot/scraper/15cf1f63-f346-498c-b7fe-f15e39921723/get_ranking?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the ranking of companies by market capitalization. Returns 100 companies per page with rank, name, ticker, market cap, price, daily change, and country.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve (100 companies per page). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"companies": "array of company objects with rank, name, ticker, market_cap, price, today_change, and country",
"total_results": "integer, number of companies returned on this page"
},
"sample": {
"data": {
"page": 1,
"companies": [
{
"name": "NVIDIA",
"rank": "1",
"price": {
"formatted": "$225.83",
"raw_value": 22583
},
"ticker": "NVDA",
"country": "USA",
"market_cap": {
"formatted": "$5.469 T",
"raw_value": 5469721067520
},
"today_change": {
"formatted": "2.29%",
"raw_value": 229
}
}
],
"total_results": 100
},
"status": "success"
}
}About the companiesmarketcap.com API
This API exposes 4 endpoints covering global public-company data from companiesmarketcap.com, including paginated market cap rankings, company search, detailed financial profiles, and full historical metric series. The get_ranking endpoint returns up to 100 companies per page with rank, ticker, price, daily change, and country. The get_company_metric_history endpoint lets you pull year-by-year series for metrics like P/E ratio, EPS, dividend yield, and total assets for any tracked company.
Market Cap Rankings and Company Search
The get_ranking endpoint returns ranked lists of publicly traded companies by market capitalization, 100 per page. Each record includes rank, name, ticker, market_cap, price, today_change, and country. Use the page parameter to paginate through the full global list. The search endpoint accepts a company name or ticker symbol via the query parameter and returns matching companies and ETFs with their identifier, name, url, and type — useful for resolving a user-supplied name to the slug or ticker needed by other endpoints.
Company Profiles and Financial History
The get_company_details endpoint accepts a ticker or company slug (e.g., AAPL or tesla) and returns a market_cap_info object containing rank, marketcap, country, share_price, change_1_day, change_1_year, categories, and a text description. It also includes revenue_history and earnings_history arrays, each with annual year, value, and change fields, giving a longitudinal view of top-line and bottom-line performance.
Historical Metric Series
The get_company_metric_history endpoint retrieves the full annual history for any supported metric. Pass a metric string — options include pe-ratio, eps, dividend-yield, shares-outstanding, total-assets, revenue, earnings, operating-margin, and pb-ratio — alongside an identifier. The response returns a history array of { year, value, change } objects, making it straightforward to chart trends or compute derived statistics over time.
Coverage Notes
Data covers globally listed public companies tracked by companiesmarketcap.com. Rankings reflect real-time market capitalization. Historical metric coverage depth varies by company; smaller or recently listed companies may have shorter histories than large-cap incumbents.
- Build a market cap leaderboard that pages through global rankings using
get_rankingwith thepageparameter. - Resolve user-typed company names or tickers to canonical identifiers before querying detailed data via
search. - Chart 10-year P/E ratio trends for any public company using
get_company_metric_historywithmetric=pe-ratio. - Compare annual EPS and operating margin histories across a watchlist of companies.
- Display a company profile card with current market cap, rank, 1-day and 1-year price change from
get_company_details. - Screen stocks by dividend yield history using the
dividend-yieldmetric and flagging multi-year growth patterns. - Aggregate country-level market cap totals by collecting the
countryfield from paginated ranking results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does companiesmarketcap.com offer an official developer API?+
What does `get_company_metric_history` return, and which metrics are supported?+
history array of annual { year, value, change } records for the requested metric. Supported metric strings include pe-ratio, eps, dividend-yield, shares-outstanding, total-assets, revenue, earnings, operating-margin, and pb-ratio, among others available on the site. Pass any of these as the metric parameter along with a ticker or slug as the identifier.Does the API return intraday price data or only daily snapshots?+
today_change (daily change), and a change_1_year figure. Intraday OHLCV bars or minute-level price history are not currently covered. You can fork this API on Parse and revise it to add an endpoint targeting intraday or tick-level data if your source supports it.Are ETFs included in search results?+
search endpoint returns both companies and ETFs, distinguished by the type field in each result object. The get_company_details and get_company_metric_history endpoints work with any identifier returned by search, including ETF slugs, though metric history depth for ETFs may be limited compared to individual equities.Is there a way to filter the ranking by country or sector?+
get_ranking endpoint does not currently accept country or sector filter parameters — it returns the global ranked list paginated by page. The country field is present in each result, so client-side filtering is possible. You can fork this API on Parse and revise it to add country- or category-filtered ranking endpoints if the source exposes those views.