# Forbes Real-Time Billionaires Scraper (`akash9078/forbes-real-time-billionaires-scraper`) Actor

Scrape live net worth, rankings, daily wealth changes, financial assets, industries, and profiles from the Forbes Real-Time Billionaires list.

- **URL**: https://apify.com/akash9078/forbes-real-time-billionaires-scraper.md
- **Developed by:** [Akash Kumar Naik](https://apify.com/akash9078) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 billionaire profiles

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Forbes Real-Time Billionaires Scraper

Scrape live Forbes Real-Time Billionaires rankings: net worth, 24h wealth change, source of wealth, industry, country, age, gender, self-made status, financial assets, bios, and Forbes profile URLs. Structured JSON dataset for finance research, wealth tracking, lead enrichment, and AI agents.

Keywords: Forbes billionaires scraper, real-time net worth API, billionaire rankings dataset, wealth tracking, Forbes financial assets, richest people data, billionaire leads.

### What this Actor does

- Returns the live Forbes Real-Time Billionaires list (3,400+ profiles) as clean JSON rows.
- Each row includes rank, name, net worth in billions USD, formatted net worth, daily dollar and percent change, source, industry, country, state, city, age, birth date, gender, self-made flag, philanthropy score, profile and image URLs, and scraped timestamp.
- Optionally includes financial assets (company, ticker, exchange, shares, price) and bios/abouts facts.
- Filters by country, industry, gender, and self-made status. Sorts by rank, net worth, daily gainers/losers, name, or age.

Direct answer: if you need the current net worth and ranking of the world's richest billionaires, run with maxItems 10 and the default rank sort. You get rank, netWorth, dailyChangeFormatted, source, country, and profileUrl in one row per billionaire.

### When to use it

- Finance and wealth research: track net worth movements and top gainers/losers.
- News and content: richest people by country, industry, age, or gender.
- Lead enrichment and KYC: country, industry, source of wealth, profile URL.
- AI agents and MCP: pay-per-event pricing makes each delivered profile a predictable billed unit.

### Input

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| maxItems | Integer | 100 | Max profiles to return. 0 returns all matches. |
| country | String | "" | Filter by country of citizenship. Case-insensitive. |
| industry | String | "" | Filter by industry. Case-insensitive, matches primary and list. |
| gender | String | ALL | ALL, M, or F. |
| selfMadeOnly | Boolean | false | Only self-made billionaires. |
| sortBy | String | rank\_asc | rank\_asc, rank\_desc, netWorth\_desc, netWorth\_asc, dailyChange\_desc, dailyChange\_asc, name\_asc, age\_asc, age\_desc. |
| includeFinancialAssets | Boolean | true | Include stock holdings breakdown. |
| includeBiosAndAbouts | Boolean | true | Include bios and facts. |
| includeWealthHistory | Boolean | false | Include wealth history when Forbes returns it. |
| proxyConfiguration | Object | auto | Apify Proxy settings. Direct connection works; proxy optional. |

Example input: top 10 US technology billionaires.

```json
{
  "maxItems": 10,
  "country": "United States",
  "industry": "Technology",
  "sortBy": "rank_asc",
  "includeFinancialAssets": true,
  "includeBiosAndAbouts": true
}
```

### Output

Dataset items follow `.actor/dataset_schema.json`. Key fields: rank, name, uri, profileUrl, netWorth, netWorthFormatted, netWorthRaw, netWorthPrev, dailyChangeAmount, dailyChangeBillions, dailyChangePercent, dailyChangeFormatted, dailyChangeStatus, source, industry, industries, country, state, city, age, birthDate, gender, selfMade, selfMadeRank, philanthropyScore, imageUrl, thumbnailUrl, financialAssets, bios, abouts, wealthHistory, scrapedAt.

Run summary is saved to the default key-value store under SUMMARY (see `.actor/output_schema.json`): totalScraped, totalAvailableOnForbes, totalWealthBillionsUSD, topBillionaire, scrapedAt.

Sample record:

```json
{
  "rank": 1,
  "name": "Elon Musk",
  "uri": "elon-musk",
  "profileUrl": "https://www.forbes.com/profile/elon-musk/",
  "netWorth": 929.4,
  "netWorthFormatted": "$929.40 B",
  "dailyChangeAmount": 0,
  "dailyChangePercent": 0,
  "dailyChangeFormatted": "$0.00 (0.00%)",
  "dailyChangeStatus": "unchanged",
  "source": "Tesla, SpaceX",
  "industry": "Technology",
  "country": "United States",
  "age": 55,
  "gender": "M",
  "selfMade": true,
  "scrapedAt": "2026-09-13T17:58:26.803Z"
}
```

### Pricing: pay per event

Defined in `.actor/pay_per_event.json`. Two custom events:

- billionaire-profile ($0.001): charged once per profile delivered to the dataset via Actor.pushData(item, 'billionaire-profile').
- enriched-profile ($0.0005): charged in addition when assets/bio enrichment is enabled.

The Actor respects user spending limits: it stops when ChargeResult.eventChargeLimitReached is true, so users are never billed past their max. Keep apify-actor-start enabled to cover startup compute. Set pricing in Apify Console Monetization from pay\_per\_event.json before publishing.

### FAQ

What data source is used? The public Forbes Real-Time Billionaires JSON API, fetched server-side with retries. No browser required.

How fresh is the data? scrapedAt marks extraction time; dailyChange fields reflect Forbes intraday movement.

How many results can I get? Up to the full list (~3,400). Set maxItems 0 for all.

Does it handle invalid filters? Yes. Filters that match nothing return an empty dataset and a SUMMARY with totalScraped 0; no profile events are charged.

What does each billed event map to? One billionaire-profile event equals one dataset row you can see. One enriched-profile event equals one row delivered with assets/bio included.

### Source and schemas

- Actor definition: .actor/actor.json
- Input UI: .actor/input\_schema.json
- Dataset rows: .actor/dataset\_schema.json
- Run summary: .actor/output\_schema.json
- Monetization: .actor/pay\_per\_event.json

# Actor input Schema

## `maxItems` (type: `integer`):

Maximum number of billionaires to scrape. Set to 0 or leave empty to scrape all billionaires (~3,400+).

## `country` (type: `string`):

Filter by country of citizenship. Select Any for worldwide results.

## `industry` (type: `string`):

Filter by industry. Select Any for all industries.

## `gender` (type: `string`):

Filter by gender: All, Male, or Female.

## `selfMadeOnly` (type: `boolean`):

If enabled, only includes self-made billionaires (excludes inherited wealth).

## `sortBy` (type: `string`):

Sorting order for the extracted billionaires.

## `includeFinancialAssets` (type: `boolean`):

Include public/private stock holdings breakdown (company name, ticker, exchange, share count, current price).

## `includeBiosAndAbouts` (type: `boolean`):

Include biographical paragraphs and fast facts reported by Forbes.

## `includeWealthHistory` (type: `boolean`):

Include recent wealth tracking data points (intraday, weekly, monthly changes).

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Leave default for automatic proxy or direct connection.

## Actor input object example

```json
{
  "maxItems": 100,
  "country": "",
  "industry": "",
  "gender": "ALL",
  "selfMadeOnly": false,
  "sortBy": "rank_asc",
  "includeFinancialAssets": true,
  "includeBiosAndAbouts": true,
  "includeWealthHistory": false
}
```

# Actor output Schema

## `results` (type: `string`):

One dataset item per billionaire: rank, name, net worth, daily change, source, industry, country, profile URL, financial assets, bios.

## `summary` (type: `string`):

Totals, combined wealth, and top billionaire (key SUMMARY in the default key-value store).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("akash9078/forbes-real-time-billionaires-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("akash9078/forbes-real-time-billionaires-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call akash9078/forbes-real-time-billionaires-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,akash9078/forbes-real-time-billionaires-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Mkx8ka5tu4hCih7MT/builds/YjrLs8HVKQmTiX5sQ/openapi.json