---
title: "Search a Fortune ranking"
method: GET
path: "/fortune/ranking"
tags: ["Fortune"]
---

# Search a Fortune ranking

`GET /fortune/ranking`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/fortune/ranking`
- Auth: API key in header `x-api-key`

Returns rows from a selected Fortune ranking list and year -- the Fortune 500 franchise (including Fortune China 500) or one of Fortune's award/culture rankings. Search, filters, sorting, and pagination are applied against Fortune's public ranking data and validated against that list/year's filter inventory.

## Query parameters

- `list` string
- `year` string
- `search` string
- `filter` string[]
- `sector` string
- `industry` string
- `state` string
- `profitable` string
- `sort_by` string
- `sort_order` 'asc' | 'desc'
- `offset` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsFortuneRankingResponseDoc
  - `data` FortuneRankingResponse
    - `filters` object
    - `items` FortuneRankingItem[]
      - `data` object
      - `name` string
      - `order` integer
      - `rank` integer
      - `slug` string
      - `url` string
    - `limit` integer
    - `list` string
    - `offset` integer
    - `search` string
    - `search_fields` FortuneRankingSearchField[]
      - `field_name` string
      - `options` string[]
      - `title` string
      - `type` string
    - `sort_by` string
    - `sort_order` string
    - `sortable_fields` FortuneRankingSortableField[]
      - `title` string
      - `type` string
    - `total` integer
    - `year` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)
