humblebundle.com APIhumblebundle.com ↗
Access Humble Bundle store products, active bundle tiers, Humble Choice games, and free game listings via 6 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/ddefcc32-cd81-406c-9ba8-7f18abdc11d5/search_store?page=0&sort=bestselling&query=resident+evil' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products in the Humble Store with filters and sorting. Returns paginated results of games and software available for purchase.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed). |
| sort | string | Sort order. Confirmed working value: bestselling. |
| genre | string | Genre filter (e.g. indie, strategy, simulation). |
| query | string | Search keyword. Note: text search may be slower than browsing by sort/filter. |
| filter | string | Filter: all, onsale. |
| platform | string | Platform filter (e.g. windows, mac, linux). |
{
"type": "object",
"fields": {
"results": "array of product objects with machine_name, human_name, current_price, full_price, platforms, delivery_methods",
"num_pages": "integer total number of pages",
"num_results": "integer total number of matching results"
},
"sample": {
"data": {
"results": [
{
"platforms": [
"mac",
"windows"
],
"sale_type": "normal",
"full_price": {
"amount": 34.99,
"currency": "USD"
},
"human_name": "Timberborn",
"machine_name": "timberborn_storefront",
"current_price": {
"amount": 27.99,
"currency": "USD"
}
}
],
"num_pages": 787,
"num_results": 15740
},
"status": "success"
}
}About the humblebundle.com API
The Humble Bundle API provides 6 endpoints covering store search, product detail, active bundle listings, per-bundle tier breakdowns, Humble Choice monthly games, and free game discovery. The get_bundle_detail endpoint returns full tier structures including per-item machine names, pricing labels, and charity information for any live bundle. Use search_store with genre, platform, and sort parameters to page through the full Humble Store catalog.
Store Search and Product Detail
The search_store endpoint accepts query, genre, platform, sort, and filter parameters and returns paginated results — each product object includes machine_name, human_name, current_price, full_price, platforms, and delivery_methods. Pagination is zero-indexed via the page parameter, and num_pages / num_results in the response let you walk the full result set. Text search via query is supported but performs slower than browsing with sort or genre filters. Once you have a machine_name, pass it as product_slug to get_store_product to retrieve HTML description, developer and publisher arrays, system requirements, and both current_price and full_price as currency-aware objects.
Bundle Listings and Tier Data
get_active_bundles accepts an optional category parameter (games, books, or software) and returns an array of live bundles with name, url, slug, category, end_date, and description. Pass a bundle_slug from that result set to get_bundle_detail to get the full tier breakdown: each tier includes a price_label, a tier_id, and an items array where every entry carries machine_name, human_name, and content_type. The response also exposes charity_name, num_purchases, and an ISO end_date. If the slug refers to a bundle that has expired or does not exist, the endpoint returns a stale_input indicator rather than an error.
Humble Choice and Free Games
get_choice_monthly takes no parameters and returns the current month's Humble Choice game titles as a string array alongside the canonical membership page URL. get_free_games also takes no parameters and returns a results array of currently free titles in the Humble Store, structured the same way as search_store results. Both endpoints reflect the current state of the respective offerings at the time of the request.
- Track Humble Bundle deal expiration dates and alert users before a bundle's
end_datepasses - Build a game library enrichment tool that resolves
machine_nameslugs to developer, publisher, and platform data viaget_store_product - Monitor Humble Choice monthly lineup changes to notify subscribers when new titles appear in the
gamesarray - Aggregate charity beneficiaries across active bundles using the
charity_namefield fromget_bundle_detail - Filter Humble Store inventory by platform and genre using
search_storeto power a cross-store deal comparison feed - Surface currently free Humble Store games via
get_free_gamesin a daily digest or Slack bot - Analyze bundle tier pricing and content counts to identify which tiers offer the most titles per dollar
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Humble Bundle have an official public developer API?+
What does `get_bundle_detail` return if a bundle slug has expired?+
bundle_slug refers to a bundle that is no longer active or does not exist, the endpoint returns a stale_input indicator in the response rather than a structured bundle object. This lets callers detect stale slugs without catching HTTP errors. Only currently active bundles return full tier and charity data.Does the API cover historical or past bundles?+
get_active_bundles and get_bundle_detail only cover bundles currently live on Humble Bundle. Past or archived bundles are not accessible. The API covers current store products, active bundle tiers, the current Humble Choice lineup, and present-state free games. You can fork the API on Parse and revise it to add an endpoint targeting historical bundle data if a suitable data source becomes available.Can I retrieve user account data, purchase history, or library contents?+
How does the `search_store` `filter` parameter behave compared to `genre`?+
filter parameter accepts all or onsale and controls whether results are restricted to discounted items. The genre parameter is a separate dimension and accepts string values like indie, strategy, or simulation. Both can be combined in a single request along with platform and sort. Note that using the query text search parameter is documented to run slower than filtering by sort or genre alone.