# Amoeba — 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.

> Search and browse Amoeba Music's catalog of vinyl records and CDs, including used listings, to find product details and discover new releases. Check store information to plan your visits to Amoeba's physical locations.

**Category:** Music | **Website:** [amoeba.com/](https://amoeba.com/) | **Docs:** [parse.bot/marketplace/a66a1550-b10c-4d43-9db4-e41226471a35/amoeba-com-api](https://parse.bot/marketplace/a66a1550-b10c-4d43-9db4-e41226471a35/amoeba-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/amoeba/`
**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

### Browse vinyl and cd

Browse the Vinyl & CD catalog with optional filters for type (new/used) and genre. Returns paginated results sorted by date added, with pricing information. 20 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | integer | No | Numeric genre ID (0 for all genres) |
| `page` | integer | No | Page number (1-based) |
| `type` | string | No | Type filter: 'new', 'used', or 'all' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amoeba/browse-vinyl-and-cd \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<integer>","page":"<integer>","type":"<string>"}'
```

### Get new releases

Get the latest music releases with optional genre filtering. Returns paginated results sorted by release date. 20 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | integer | No | Numeric genre ID (0 for all genres) |
| `page` | integer | No | Page number (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amoeba/get-new-releases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<integer>","page":"<integer>"}'
```

### Get product detail

Fetch full details for a specific album or product by its URL on amoeba.com. Returns title, artist, metadata (genre, release date, label, catalog number, format), track listing, and new/used listings with pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the product page on amoeba.com (e.g., 'https://www.amoeba.com/feather-fur-fin-cd-danny-michel/albums/2942323/') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amoeba/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### Get store info

Get information about Amoeba Music physical store locations including addresses, hours of operation, and phone numbers. No parameters needed.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amoeba/get-store-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search catalog

Full-text search across the Amoeba Music catalog. Returns matching artists and albums with links to their detail pages. Results are not paginated; the site returns all matches for the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'Beatles', 'Miles Davis') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/amoeba/search-catalog \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

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