Humble Bundle Scraper

Extract game bundles, book bundles, and software bundles from Humble Bundle — including tier prices, bundled items, end dates, and partner details. No account required.

What This Actor Does

• Current Bundles — list all live bundles (games, books, software) with tier prices, item lists, and end dates
• Store Search — search the Humble Store by keyword and retrieve product details
• By URL — fetch any specific bundle or store product page by URL

---

Output Fields

Each record contains the following fields (omit-empty — fields absent when not available):

Field	Type	Description
bundleTitle	string	Name of the bundle or product
url	string	Direct URL to the bundle/product page
bundleType	string	Type: games, books, software, or store
tierPrices	array	Pricing tiers: [{price, itemCount, tierName}]
items	array	Bundled items: [{title, platforms, developer}]
itemCount	integer	Total number of items in the bundle
endDate	string	ISO-8601 date when the bundle ends
startDate	string	ISO-8601 date when the bundle started
partnerName	string	Charity or partner receiving a share of proceeds
imageUrl	string	Cover/tile image URL
scrapedAt	string	ISO-8601 timestamp of when the record was scraped

Example Output

{
  "bundleTitle": "Indie Games Mega Bundle 2024",
  "url": "https://www.humblebundle.com/games/indie-games-mega-bundle-2024",
  "bundleType": "games",
  "tierPrices": [
    { "price": 1.0, "itemCount": 3 },
    { "price": 8.0, "itemCount": 7 },
    { "price": 15.0, "itemCount": 12 }
  ],
  "items": [
    { "title": "Super Adventure Game", "platforms": ["windows", "mac"], "developer": "Indie Dev Studio" },
    { "title": "Puzzle Quest Pro", "platforms": ["windows"] }
  ],
  "itemCount": 12,
  "endDate": "2024-12-31T23:59:59+00:00",
  "startDate": "2024-12-01T00:00:00+00:00",
  "partnerName": "Save the Children",
  "imageUrl": "https://cdn.humblebundle.com/bundles/image.jpg",
  "scrapedAt": "2024-12-15T10:30:00+00:00"
}

---

Input Configuration

Mode

Value	Description
currentBundles	Fetch all live bundles (default)
storeSearch	Search the Humble Store
byUrl	Fetch a specific URL

Input Fields

Field	Type	Default	Description
mode	select	currentBundles	Scraping mode
bundleType	select	all	Filter by bundle type: all, games, books, software
searchQuery	string	rpg	Search keyword (mode=storeSearch)
sortBy	select	bestselling	Sort order for store search results
startUrls	array	[]	URLs to fetch (mode=byUrl)
maxItems	integer	10	Maximum records to return (1–500)

Sort Options (mode=storeSearch)

Value	Description
bestselling	Best Selling (default)
relevance	Most Relevant
newlyreleased	Newly Released
priceasc	Price: Low to High
pricedesc	Price: High to Low

---

Use Cases

• Game deal monitoring — track when new bundles launch and what games are included
• Book research — find upcoming book bundles and author lineups
• Price comparison — compare Humble Bundle deals against other storefronts
• Content calendars — monitor bundle end dates for editorial planning
• Game library building — identify high-value bundles for Steam key collection

---

FAQ

Does this require a Humble Bundle account?
No. All data is scraped from public pages with no login required.

How often does Humble Bundle release new bundles?
New bundles typically launch weekly. Most bundles run for 2–3 weeks.

Why might tierPrices or items be missing?
Some bundles use dynamic pricing that loads after page render. The actor attempts multiple extraction strategies. If extraction fails, the bundle title and URL are still captured.

Can I monitor a specific bundle URL?
Yes — use mode=byUrl and provide the bundle URL in startUrls.

What's the typical bundle structure?
Humble Bundles have 2–4 tiers. Paying more unlocks additional items. The tierPrices array reflects this structure.

Does this work for the Humble Choice subscription?
The actor focuses on time-limited bundles and store products. Humble Choice subscription content may not be captured.