Forbes Lists Scraper

Scrape the Forbes ranked lists — World Billionaires, Forbes 400, Global 2000, Self-Made Women, Best Employers for Diversity/Women, and more — with full metadata including rank, net worth, industry, country, CEO, and financial metrics.

---

What it does

• Fetches Forbes list data from the official Forbes public JSON API (forbes.com/ajax/list/data)
• Supports 8 pre-configured lists plus a custom slug mode for any Forbes list URI
• Returns flat, omit-empty records with rank, profile URL, image URL, and all available metadata
• No browser required — pure HTTP, Tier 1

---

Input

Field	Type	Description
mode	Select	Which Forbes list to scrape (default: billionaires)
listYear	Integer	Year of the list (2010–2026, default: 2025)
listSlug	String	Forbes list slug for byListSlug mode (e.g. billionaires)
listType	Select	person or organization for byListSlug mode
minNetWorth	Number	Filter: min net worth in $ billions (person lists only)
country	String	Filter: keep only records from this country
industry	String	Filter: keep only records where industry contains this text
maxItems	Integer	Max records to emit (1–5000, default: 100)

Available Modes

Mode	List
billionaires	World Billionaires (Real-Time)
forbes400	Forbes 400 — America's Richest People
global2000	Forbes Global 2000 — World's Largest Public Companies
selfMadeWomen	America's Richest Self-Made Women
bestEmployersDiversity	Best Employers for Diversity
bestEmployersWomen	Best Employers for Women
bestLargeEmployers	Best Large Employers
bestMidsizeEmployers	Best Midsize Employers
byListSlug	Any Forbes list by its URL slug

---

Output

Person records (billionaires, forbes400, selfMadeWomen)

Field	Description
rank	List rank
name	Full name
firstName	First name
lastName	Last name
profileUrl	Forbes profile URL
imageUrl	Profile image URL
netWorth	Net worth (numeric)
netWorthUnit	B (billions) or M (millions)
netWorthChangeToday	Today's net worth change in millions USD (real-time lists only: billionaires, forbes400)
asOf	Date the real-time figures were last updated (real-time lists only)
source	Source of wealth
industry	Industry category
citizenship	Country of citizenship
state	US state (for US-based individuals)
age	Age
gender	M or F
title	Professional title
listName	Forbes list identifier
listYear	Year of the list
sourceUrl	Forbes list URL
scrapedAt	ISO timestamp
recordType	person

Company records (global2000, bestEmployers*)

Field	Description
rank	List rank
name	Company name
url	Forbes company URL
logoUrl	Company logo URL
revenue / revenueUnit	Revenue in B or M USD
profit / profitUnit	Net profit in B or M USD
assets / assetsUnit	Total assets in B or M USD
marketValue / marketValueUnit	Market capitalization in B or M USD
country	Country of headquarters
industry	Industry category
employees	Employee count
ceo	CEO name
ceoTitle	CEO title
websiteUrl	Company website
headquarters	Headquarters location
state	US state
listName	Forbes list identifier
listYear	Year of the list
sourceUrl	Forbes list URL
scrapedAt	ISO timestamp
recordType	company

---

Example: Top 20 Billionaires

{
  "mode": "billionaires",
  "listYear": 2025,
  "maxItems": 20
}

Sample output:

{
  "rank": 1,
  "name": "Elon Musk",
  "firstName": "Elon",
  "lastName": "Musk",
  "profileUrl": "https://www.forbes.com/profile/elon-musk/",
  "imageUrl": "https://specials-images.forbesimg.com/...",
  "netWorth": 311.0,
  "netWorthUnit": "B",
  "source": "Tesla, SpaceX",
  "industry": "Automotive",
  "citizenship": "United States",
  "age": 53,
  "gender": "M",
  "listName": "billionaires",
  "listYear": 2025,
  "sourceUrl": "https://www.forbes.com/lists/billionaires/?year=2025",
  "scrapedAt": "2025-01-15T10:30:00+00:00",
  "recordType": "person"
}

---

FAQs

Q: Does it require an API key or login? A: No. Forbes list data is publicly accessible via their JSON API.

Q: How many records can I get? A: The Billionaires list has 3000+ entries. Global 2000 has 2000 entries. Set maxItems up to 5000.

Q: Can I filter by country or industry? A: Yes — use the country (exact match) and industry (substring) input fields.

Q: What years are supported? A: 2010 through 2026. Note that not all lists have data for all years.

Q: Can I scrape any Forbes list? A: Yes — use mode=byListSlug and set listSlug to the Forbes URI slug, i.e. the part of the list's URL after forbes.com/lists/ (e.g. self-made-women for forbes.com/lists/self-made-women/). Set listType to person or organization to match the list's record type.

Q: Why is net worth in billions vs millions? A: Records with net worth ≥ $1B show netWorthUnit=B with a billions value. Smaller values show netWorthUnit=M with a millions value.