---
title: "Search the Fortune company directory"
method: GET
path: "/fortune/companies"
tags: ["Fortune"]
---

# Search the Fortune company directory

`GET /fortune/companies`

## Request

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

Searches Fortune's company directory, 30 companies per page, with `page` starting at 1. Filter by `search` (company name), `country`, `industry` (exact title), `ranking` with `year`, and ranges `min_revenue` and `max_revenue` (in $M) and `min_employees` and `max_employees`. Each item has name, slug, URL, country, revenues and description. Invalid `country` or `industry` values return `400`.

## Query parameters

- `search` string
- `country` string
- `industry` string
- `ranking` string
- `year` string
- `min_revenue` integer
- `max_revenue` integer
- `min_employees` integer
- `max_employees` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PublicnewsFortuneCompaniesResponseDoc
  - `data` FortuneCompaniesResponse
    - `country` string
    - `has_more` boolean
    - `industry` string
    - `items` FortuneCompanyListItem[]
      - `country` string
      - `description` string
      - `name` string
      - `revenues` string
      - `slug` string
      - `url` string
    - `page` integer
    - `per_page` integer
    - `ranking` string
    - `search` string
    - `total` integer
    - `total_pages` integer

## 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)