---
title: "Forbes billionaires list"
method: GET
path: "/forbes/billionaires"
tags: ["Forbes"]
---

# Forbes billionaires list

`GET /forbes/billionaires`

## Request

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

Returns a paginated Forbes billionaires list from the public Forbes JSON feed. The default field set includes ranking, worth, person identity, citizenship, category, industry, organization, image, and biography fields.

## Query parameters

- `year` integer
- `limit` integer
- `start` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ForbesBillionairesResponseDoc
  - `code` integer
  - `data` ForbesBillionairesResponse
    - `count` integer
    - `items` ForbesBillionaire[]
      - `age` integer
      - `bios` string[]
      - `category` string
      - `country_of_citizenship` string
      - `final_worth` number
      - `first_name` string
      - `gender` string
      - `industries` string[]
      - `last_name` string
      - `organization` string
      - `person` object
      - `person_name` string
      - `qas` unknown
      - `rank` integer
      - `source` string
      - `square_image` string
      - `status` string
      - `uri` string
    - `limit` integer
    - `start` integer
    - `year` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `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/afac9b012a27?raw)