# Humble Bundle — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse and search Humble Bundle's store products, view active bundles with detailed information, and check the latest Humble Choice monthly games and free offerings. Get instant access to current pricing, bundle contents, and game availability to find the best deals.

**Category:** E-commerce | **Website:** [humblebundle.com/](https://humblebundle.com/) | **Docs:** [parse.bot/marketplace/bad60cae-e5ad-4b91-a7dd-b1637087bfba/humblebundle-com-api](https://parse.bot/marketplace/bad60cae-e5ad-4b91-a7dd-b1637087bfba/humblebundle-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_active_bundles

List all currently active bundles on Humble Bundle. Optionally filter by category. Returns bundle names, slugs, descriptions, category, and expiry dates. Use the slug with get_bundle_detail for tier and item information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category filter: games, books, software. Omitting returns bundles from all categories. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/get_active_bundles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_bundle_detail

Get detailed information about a specific active bundle including payment tiers, items per tier, and charity information. Returns stale_input for expired or non-existent bundles. The bundle_slug is obtained from get_active_bundles results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bundle_slug` | string | Yes | The bundle slug from get_active_bundles results. |
| `category` | string | No | Bundle category: games, books, software. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/get_bundle_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bundle_slug":"<string>","category":"<string>"}'
```

### get_choice_monthly

Get the current month's featured games in Humble Choice membership. Returns a list of game titles available this month and a link to the membership page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/get_choice_monthly \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_free_games

Search for free games currently available in the Humble Store. Scans the store catalog for products with a current price of zero. Returns an empty list when no free games are currently offered.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/get_free_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_store_product

Get detailed information about a specific store product by its machine name slug, including description, pricing, system requirements, screenshots, and publisher/developer information. The machine_name slug is obtained from search_store results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_slug` | string | Yes | The product machine_name from search_store results (e.g. timberborn_storefront). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/get_store_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_slug":"<string>"}'
```

### search_store

Search for products in the Humble Store with filters and sorting. Returns paginated results (20 per page) of games and software available for purchase. Supports filtering by genre, platform, sale status, and text search. Results include pricing, platform availability, and delivery methods.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter` | string | No | Sale filter. |
| `genre` | string | No | Genre filter (e.g. indie, strategy, simulation, action, adventure, rpg, puzzle). |
| `page` | integer | No | Page number (0-indexed). |
| `platform` | string | No | Platform filter (e.g. windows, mac, linux). |
| `query` | string | No | Search keyword to filter results by name. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-humblebundle-com-api-bad60cae/search_store \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter":"<string>","genre":"<string>","page":"<integer>","platform":"<string>","query":"<string>","sort":"<string>"}'
```