# Auctions Yahoo — 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 active and completed Yahoo Auctions Japan listings, view detailed item information, and identify bargain deals by comparing current prices against market trends. Analyze seller profiles to make informed bidding decisions on Japanese auction items.

**Category:** Marketplaces | **Website:** [auctions.yahoo.co.jp/](https://auctions.yahoo.co.jp/) | **Docs:** [parse.bot/marketplace/086b4ce8-4d77-454d-bc23-4ee67f366b79/auctions-yahoo-co-jp-api](https://parse.bot/marketplace/086b4ce8-4d77-454d-bc23-4ee67f366b79/auctions-yahoo-co-jp-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-auctions-yahoo-co-jp-api-086b4ce8/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### compare_market_price

Compound endpoint that identifies active listings priced significantly below the 180-day market average (less than 80% of average). Fetches completed listings for market stats, then active listings sorted by price ascending, and filters for underpriced items. Returns upstream_error if no market data is available for the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., 'Nintendo Switch') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-auctions-yahoo-co-jp-api-086b4ce8/compare_market_price \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_listing_detail

Fetch full details of a single auction or fixed-price listing including title, current price, bid count, and seller ID. The seller_id can be used with get_seller_profile to retrieve seller information. Returns input_not_found if the listing has expired or does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `item_id` | string | Yes | Auction/Listing ID (e.g., 'm1233190744') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-auctions-yahoo-co-jp-api-086b4ce8/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"<string>"}'
```

### get_seller_profile

Fetch seller profile information including display name, rating score, and positive feedback ratio. The seller_id is obtained from the get_listing_detail response. Returns input_not_found if the seller does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `seller_id` | string | Yes | Seller ID (from get_listing_detail response's seller_id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-auctions-yahoo-co-jp-api-086b4ce8/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seller_id":"<string>"}'
```

### search_completed_listings

Search completed/sold listings to get historical market price data. Returns items with final sold prices and 180-day market statistics (min, avg, max price). Useful for determining fair market value of items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results (max 50) |
| `offset` | integer | No | Pagination offset (starts at 1, increments by limit) |
| `query` | string | No | Search keyword |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-auctions-yahoo-co-jp-api-086b4ce8/search_completed_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","query":"<string>"}'
```

### search_listings

Search active auction and fixed-price listings by keyword and category. Returns paginated results with item title, price, ID, URL, and thumbnail image. Pagination uses an offset parameter that increments by the limit value. Results are sorted by the sort/order combination. An empty query with a category ID returns all items in that category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `auccat` | string | No | Category ID |
| `condition` | string | No | Item condition filter |
| `limit` | integer | No | Number of results per page (max 50) |
| `max_price` | integer | No | Maximum price in Yen |
| `min_price` | integer | No | Minimum price in Yen |
| `offset` | integer | No | Pagination offset (starts at 1, increments by limit) |
| `order` | string | No | Sort order |
| `query` | string | No | Search keyword |
| `sort` | string | No | Sort field |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-auctions-yahoo-co-jp-api-086b4ce8/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auccat":"<string>","condition":"<string>","limit":"<integer>","max_price":"<integer>","min_price":"<integer>","offset":"<integer>","order":"<string>","query":"<string>","sort":"<string>"}'
```