# Humble Bundle — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/get-active-bundles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/get-bundle-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/get-choice-monthly \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/get-free-games \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/get-store-product \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/humble-bundle/search-store \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filter":"<string>","genre":"<string>","page":"<integer>","platform":"<string>","query":"<string>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.