# 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. Each call is automatically billed to your wallet in USDC.

## Access

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

## 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/parse-amoeba-com-api-a66a1550/browse_vinyl_and_cd \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amoeba-com-api-a66a1550/get_new_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amoeba-com-api-a66a1550/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amoeba-com-api-a66a1550/get_store_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-amoeba-com-api-a66a1550/search_catalog \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```