# Yahoo Auctions Japan Scraper (x402)

> Yahoo Auctions Japan Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured auction listing data from Yahoo Auctions Japan search results, returning titles, prices, images, and auction IDs per call.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/yahoo?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yahoo-auctions-japan-scraper-x402-867d0ded
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_25TOpxaKyiklVYkxNmmyP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability yahoo-auctions-japan-scraper-x402-867d0ded -d '<json body>'
```

Example prompt: Search Yahoo Auctions Japan for 'vintage camera' using the URL https://auctions.yahoo.co.jp/search/search?p=%E3%82%AB%E3%83%A1%E3%83%A9&n=100, collect up to 200 listings starting from page 1 through page 3, and get the thumbnail images and current prices for each one.

## When to prefer this

Choose this endpoint when you need structured, paginated auction data from Yahoo Auctions Japan specifically — including prices, images, titles, and auction IDs — especially when your search returns more than 150 pages of results and you need price-band splitting. It is pay-per-call with no charge for failed runs, making it cost-efficient for exploratory or conditional scraping. Prefer this over generic web scrapers when you need Yahoo Japan auction-specific fields like auctionId, currentPrice, and seller details.

## Known failure modes

- Empty result set if the search URL returns no listings — not billed
- Invalid or malformed startUrl causes a scrape failure
- Rate limits or blocks from Yahoo Auctions Japan may return empty results
- splitByPrice enabled without a positive maxItems value causes validation error
- Network timeout if Yahoo Auctions Japan is slow or unavailable
- Pages beyond the 150-page cap return no results unless splitByPrice is enabled

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of items found, a product identifier ('yahoo'), and an array of listing objects each containing the auction URL, title, auction ID, current price, thumbnail URL, full image array (if imageMode is 'all'), image count, and marketplace label. Failed or empty runs are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "endPage": {
   "type": "integer",
   "default": 1,
   "minimum": 0,
   "description": "Last result page to collect. 0 continues to the available page limit. Ignored when price splitting is enabled."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Hard cap on unique listings. 0 means no cap in normal mode; a positive value is required when price splitting is enabled."
  },
  "startUrl": {
   "type": "string",
   "default": "https://auctions.yahoo.co.jp/search/search?p=%E3%82%AB%E3%83%A1%E3%83%A9&n=100",
   "description": "Public Yahoo Auctions Japan search or category URL, including any filters and sort order you want to keep."
  },
  "imageMode": {
   "enum": [
    "thumbnail",
    "all"
   ],
   "type": "string",
   "default": "thumbnail",
   "description": "Thumbnail collects listing data from result pages. All opens each item to collect its full gallery, description, condition, and seller details."
  },
  "startPage": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "First result page to collect. 0 starts on page 1. Ignored when price splitting is enabled."
  },
  "splitByPrice": {
   "type": "boolean",
   "default": false,
   "description": "Divide large searches into current price bands to reach listings beyond the site's 150-page cap. Requires a positive maximum item count."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": null,
    "title": null,
    "images": null,
    "auctionId": null,
    "thumbnail": null,
    "imageCount": null,
    "marketplace": null,
    "currentPrice": null
   }
  ],
  "product": "yahoo"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yahoo-auctions-japan-scraper-x402-867d0ded/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)
