# Ruby Lane — 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 antiques, collectibles, and jewelry listings on Ruby Lane, view detailed item information including prices and descriptions, and discover shop profiles and inventory. Find exactly what you're looking for across multiple shops or explore specific categories to compare items and sellers.

**Category:** Marketplaces | **Website:** [ruby-lane.com/](https://ruby-lane.com/) | **Docs:** [parse.bot/marketplace/ac9388f7-93d1-4262-bdcd-18c2eaa1de9a/ruby-lane-com-api](https://parse.bot/marketplace/ac9388f7-93d1-4262-bdcd-18c2eaa1de9a/ruby-lane-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-ruby-lane-com-api-ac9388f7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_category

Browse item listings by category. Returns paginated results for the specified category with the same item structure as search. Each page returns up to 60 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug used in the URL path (e.g. jewelry, dolls, art, pottery-glass, furniture) |
| `page` | integer | No | Page number for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ruby-lane-com-api-ac9388f7/browse_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### get_item_details

Retrieve full details for a single item listing by its URL. Returns structured data from the item's JSON-LD metadata including name, description, price, currency, seller, and item type/condition.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full item listing URL on rubylane.com (e.g. https://www.rubylane.com/item/1603951-05298/19-c-Rosewood-Inlaid-Mother-Pearl) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ruby-lane-com-api-ac9388f7/get_item_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_shop

Retrieve shop profile information including name, about description, item count, and location. The shop_slug is the hyphenated form used in shop URLs (e.g. antique-matchmaker).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shop_slug` | string | Yes | Shop slug from the URL path (e.g. antique-matchmaker, assay-jewelers). Found in item listing shop links. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ruby-lane-com-api-ac9388f7/get_shop \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shop_slug":"<string>"}'
```

### search_items

Full-text search across all Ruby Lane listings. Returns paginated item results with title, price, shop name, and image. Results default to 'Best Match' sorting. Each page returns up to 60 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword or phrase |
| `sort` | string | No | Sort order for results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ruby-lane-com-api-ac9388f7/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<string>"}'
```