Fortune API endpoint
Returns every year accepted by Fortune's public ranking source for a selected list, including the 2023-2026 Fortune China 500 editions.
/fortune/ranking/yearsReturns every year accepted by a Fortune ranking list and identifies that list's current year. Fortune China 500 currently exposes the English editions 2026, 2025, 2024, and 2023.
Query parameters:
list (optional): a slug from /fortune/ranking/lists (104 lists as of 2026-09-23: the Fortune 500 franchise plus Fortune's award/culture rankings). Defaults to fortune500.
Accepted values: fortune500, global500, fortune500-europe, southeast-asia-500, fortune-china-500, 100-fastest-growing-companies, 40-under-40, ai-innovators, aiq, americas-most-innovative-companies, asia-future, best-companies, best-companies-europe, best-companies-southeast-asia, best-large-workplaces-in-technology, best-large-workplaces-parents, best-medium-workplaces, best-medium-workplaces-in-technology, best-places-families, best-places-retire-affordably, best-small-workplaces, best-small-workplaces-aging-services-senior-housing-care, best-small-workplaces-bay-area, best-small-workplaces-biotechnology-pharmaceuticals, best-small-workplaces-chicago-area, best-small-workplaces-construction, best-small-workplaces-consulting-professional-services, best-small-workplaces-financial-services-insurance, best-small-workplaces-for-women, best-small-workplaces-health-care, best-small-workplaces-in-technology, best-small-workplaces-manufacturing-production, best-small-workplaces-millennials, best-small-workplaces-new-york, best-small-workplaces-parents, best-small-workplaces-real-estate, best-small-workplaces-retail, best-small-workplaces-technology, best-small-workplaces-texas, best-workplaces-advertising-marketing, best-workplaces-aging-services-at-home-care, best-workplaces-aging-services-senior-housing-care, best-workplaces-baby-boomers, best-workplaces-bay-area, best-workplaces-biotechnology-pharmaceuticals, best-workplaces-camaraderie, best-workplaces-chicago-area, best-workplaces-construction, best-workplaces-consulting-professional-services, best-workplaces-finance-insurance, best-workplaces-financial-services-insurance, best-workplaces-flexibility, best-workplaces-for-african-americans, best-workplaces-for-asian-americans, best-workplaces-for-diversity, best-workplaces-for-hispanics-and-latinos, best-workplaces-for-retirement, best-workplaces-for-women, best-workplaces-gen-x, best-workplaces-giving-back, best-workplaces-health-care, best-workplaces-manufacturing-production, best-workplaces-millennials, best-workplaces-new-york, best-workplaces-parents, best-workplaces-real-estate, best-workplaces-recent-college-graduates, best-workplaces-retail, best-workplaces-technology, best-workplaces-texas, businessperson-of-the-year, candidates-working-women-times-up, change-the-world, creator-25, crypto, cyber, europes-most-innovative-companies, fintech-innovators-asia, food-drink-women-innovators, fortunate50, future-50, global-best-companies, heroes-of-the-fortune-500, impact20, inner-city-100, international-20, lgbtq-leaders, mejores-companias-latinos-hispanos, modern-board-25, most-fantastical-comic-book-businesses, most-important-private-companies, most-powerful-people, most-powerful-rising-executives, most-powerful-women, most-powerful-women-asia, most-powerful-women-europe-middle-east-africa, most-powerful-women-international, nfty-50, the-ledger-40-under-40, unicorns, women-tech-leaders-europe, worlds-best-workplaces, worlds-greatest-leaders, worlds-most-admired-companies.| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| list | string | No | fortune500 | Accepted values: fortune500, global500, fortune500-europe, southeast-asia-500, fortune-china-500, 100-fastest-growing-companies, 40-under-40, ai-innovators, aiq, americas-most-innovative-companies, asia-future, best-companies, best-companies-europe, best-companies-southeast-asia, best-large-workplaces-in-technology, best-large-workplaces-parents, best-medium-workplaces, best-medium-workplaces-in-technology, best-places-families, best-places-retire-affordably, best-small-workplaces, best-small-workplaces-aging-services-senior-housing-care, best-small-workplaces-bay-area, best-small-workplaces-biotechnology-pharmaceuticals, best-small-workplaces-chicago-area, best-small-workplaces-construction, best-small-workplaces-consulting-professional-services, best-small-workplaces-financial-services-insurance, best-small-workplaces-for-women, best-small-workplaces-health-care, best-small-workplaces-in-technology, best-small-workplaces-manufacturing-production, best-small-workplaces-millennials, best-small-workplaces-new-york, best-small-workplaces-parents, best-small-workplaces-real-estate, best-small-workplaces-retail, best-small-workplaces-technology, best-small-workplaces-texas, best-workplaces-advertising-marketing, best-workplaces-aging-services-at-home-care, best-workplaces-aging-services-senior-housing-care, best-workplaces-baby-boomers, best-workplaces-bay-area, best-workplaces-biotechnology-pharmaceuticals, best-workplaces-camaraderie, best-workplaces-chicago-area, best-workplaces-construction, best-workplaces-consulting-professional-services, best-workplaces-finance-insurance, best-workplaces-financial-services-insurance, best-workplaces-flexibility, best-workplaces-for-african-americans, best-workplaces-for-asian-americans, best-workplaces-for-diversity, best-workplaces-for-hispanics-and-latinos, best-workplaces-for-retirement, best-workplaces-for-women, best-workplaces-gen-x, best-workplaces-giving-back, best-workplaces-health-care, best-workplaces-manufacturing-production, best-workplaces-millennials, best-workplaces-new-york, best-workplaces-parents, best-workplaces-real-estate, best-workplaces-recent-college-graduates, best-workplaces-retail, best-workplaces-technology, best-workplaces-texas, businessperson-of-the-year, candidates-working-women-times-up, change-the-world, creator-25, crypto, cyber, europes-most-innovative-companies, fintech-innovators-asia, food-drink-women-innovators, fortunate50, future-50, global-best-companies, heroes-of-the-fortune-500, impact20, inner-city-100, international-20, lgbtq-leaders, mejores-companias-latinos-hispanos, modern-board-25, most-fantastical-comic-book-businesses, most-important-private-companies, most-powerful-people, most-powerful-rising-executives, most-powerful-women, most-powerful-women-asia, most-powerful-women-europe-middle-east-africa, most-powerful-women-international, nfty-50, the-ledger-40-under-40, unicorns, women-tech-leaders-europe, worlds-best-workplaces, worlds-greatest-leaders, worlds-most-admired-companies. Defaults to fortune500. | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/fortune/ranking/years" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"data": {
"list": "fortune500",
"years": [
"2026",
"2025",
"2024",
"2023",
"2022",
"2021",
"2020",
"2019",
"2018",
"2017",
"2016",
"2015",
"2014",
"2013",
"2012",
"2011",
"2010",
"2009",
"2008",
"2007",
"2006",
"2005",
"2004",
"2003",
"2002",
"2001",
"2000",
"1999",
"1998",
"1997",
"1996"
],
"current_year": "2026"
}
}Request schema
No body schema
Response schema
#/definitions/publicnews.fortuneRankingYearsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| data | fortune.RankingYearsResponse | No | ||||
| data.current_year | string | No | ||||
| data.list | string | No | ||||
| data.years | array | No |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/fortune/ranking/years" \
-H "x-api-key: $CRAWLORA_API_KEY"