Docs menu

Forbes API endpoint

Forbes billionaires list API

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.

GETapiKey3 credits/requestForbesforbes.billionairesResponseDoc/forbes/billionaires

Endpoint facts

Method: GET
API path: /forbes/billionaires
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Forbes
Response schema: #/definitions/forbes.billionairesResponseDoc

Forbes API Try Forbes billionaires list API in Playground Forbes API documentation

How this endpoint behaves

Returns a paginated Forbes billionaires list from Forbes's public JSON feed. The default response includes ranking, worth, age, citizenship, source, category, person identity, industries, organization, gender, name, square image, and biography fields.

Parameters:

year query: optional Forbes list year; defaults to the current year.
limit query: optional page size from 1 through 100; defaults to 50.
start query: optional zero-based offset; defaults to 0.
x-api-key header: required API key.

The upstream reports its total in count; an offset beyond the available rows returns an empty items page. Years outside the supported range are rejected before the upstream request.

Live monitoring

Monitored request: GET /forbes/billionaires?limit=3&start=0&year=2026
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.54 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /forbes/billionaires?limit=20&start=0&year=2026
Items in items: 20
Fields filled in every checked item: 16
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
uri	20	“elon-musk” and 19 other values
rank	20	1 to 20, median 10
final_worth	20	100,000 to 839,000, median 146,000
age	20	41 to 95, median 70
country_of_citizenship	20	United States (15), France (2), Spain (1) and 2 more
source	20	“Tesla, SpaceX” and 15 other values
qas	4	median 2 entries
status	20	U (16), D (3), E (1)
category	20	Technology (10), Fashion & Retail (6), Finance & Investments (3) and 1 more
person	20
person_name	20
industries	20	median 1 entry
organization	14	“Tesla” and 12 other values
gender	20
first_name	20
last_name	20
square_image	20	median 143 characters
bios	20	median 5 entries

Request parameters

Parameter	Type	Required	Description
year	integer	No	Forbes list year
limit	integer	No	Page size (1-100)
start	integer	No	Zero-based offset
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/forbes/billionaires?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "year": 2026,
    "count": 3028,
    "start": 0,
    "limit": 50,
    "items": [
      {
        "uri": "vladimir-lisin",
        "rank": 101,
        "final_worth": 25500,
        "age": 69,
        "country_of_citizenship": "Russia",
        "source": "Steel, transport",
        "status": "D",
        "category": "Metals & Mining",
        "person_name": "Vladimir Lisin",
        "industries": [
          "Metals & Mining"
        ],
        "first_name": "Vladimir",
        "last_name": "Lisin",
        "square_image": "//specials-images.forbesimg.com/...",
        "bios": [
          "Vladimir Lisin is chairman of NLMK Group..."
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/forbes.billionairesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	forbes.BillionairesResponse	No
data.count	integer	No
data.items	array	No
data.items[].age	integer	No
data.items[].bios	array	No
data.items[].category	string	No
data.items[].country_of_citizenship	string	No
data.items[].final_worth	number	No
data.items[].first_name	string	No
data.items[].gender	string	No
data.items[].industries	array	No
data.items[].last_name	string	No
data.items[].organization	string	No
data.items[].person	object	No
data.items[].person_name	string	No
data.items[].qas	unknown	No
data.items[].rank	integer	No
data.items[].source	string	No
data.items[].square_image	string	No
data.items[].status	string	No
data.items[].uri	string	No
data.limit	integer	No
data.start	integer	No
data.year	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/forbes/billionaires?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Forbes endpoint docs Forbes API Forbes article API documentation Forbes Author Profile API documentation Forbes editorial sections API documentation Forbes section headlines API documentation Forbes person profile API documentation

Open in Playground Back to group

Docs menu

Forbes API endpoint

Forbes billionaires list API

GETapiKey3 credits/requestForbesforbes.billionairesResponseDoc/forbes/billionaires

Endpoint facts

Method: GET
API path: /forbes/billionaires
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Forbes
Response schema: #/definitions/forbes.billionairesResponseDoc

Forbes API Try Forbes billionaires list API in Playground Forbes API documentation

How this endpoint behaves

Parameters:

year query: optional Forbes list year; defaults to the current year.
limit query: optional page size from 1 through 100; defaults to 50.
start query: optional zero-based offset; defaults to 0.
x-api-key header: required API key.

The upstream reports its total in count; an offset beyond the available rows returns an empty items page. Years outside the supported range are rejected before the upstream request.

Live monitoring

Monitored request: GET /forbes/billionaires?limit=3&start=0&year=2026
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.54 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /forbes/billionaires?limit=20&start=0&year=2026
Items in items: 20
Fields filled in every checked item: 16
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
uri	20	“elon-musk” and 19 other values
rank	20	1 to 20, median 10
final_worth	20	100,000 to 839,000, median 146,000
age	20	41 to 95, median 70
country_of_citizenship	20	United States (15), France (2), Spain (1) and 2 more
source	20	“Tesla, SpaceX” and 15 other values
qas	4	median 2 entries
status	20	U (16), D (3), E (1)
category	20	Technology (10), Fashion & Retail (6), Finance & Investments (3) and 1 more
person	20
person_name	20
industries	20	median 1 entry
organization	14	“Tesla” and 12 other values
gender	20
first_name	20
last_name	20
square_image	20	median 143 characters
bios	20	median 5 entries

Request parameters

Parameter	Type	Required	Description
year	integer	No	Forbes list year
limit	integer	No	Page size (1-100)
start	integer	No	Zero-based offset
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/forbes/billionaires?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "data": {
    "year": 2026,
    "count": 3028,
    "start": 0,
    "limit": 50,
    "items": [
      {
        "uri": "vladimir-lisin",
        "rank": 101,
        "final_worth": 25500,
        "age": 69,
        "country_of_citizenship": "Russia",
        "source": "Steel, transport",
        "status": "D",
        "category": "Metals & Mining",
        "person_name": "Vladimir Lisin",
        "industries": [
          "Metals & Mining"
        ],
        "first_name": "Vladimir",
        "last_name": "Lisin",
        "square_image": "//specials-images.forbesimg.com/...",
        "bios": [
          "Vladimir Lisin is chairman of NLMK Group..."
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/forbes.billionairesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	forbes.BillionairesResponse	No
data.count	integer	No
data.items	array	No
data.items[].age	integer	No
data.items[].bios	array	No
data.items[].category	string	No
data.items[].country_of_citizenship	string	No
data.items[].final_worth	number	No
data.items[].first_name	string	No
data.items[].gender	string	No
data.items[].industries	array	No
data.items[].last_name	string	No
data.items[].organization	string	No
data.items[].person	object	No
data.items[].person_name	string	No
data.items[].qas	unknown	No
data.items[].rank	integer	No
data.items[].source	string	No
data.items[].square_image	string	No
data.items[].status	string	No
data.items[].uri	string	No
data.limit	integer	No
data.start	integer	No
data.year	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/forbes/billionaires?limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Forbes billionaires list API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Forbes billionaires list API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related