# Yahoo Auctions Japan Scraper

> Yahoo Auctions Japan Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

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

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-ae5ebe74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PGa1KcqFhPi40_QttT54n

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-ae5ebe74 -d '<json body>'
```

Example prompt: Scrape the first 2 pages of Yahoo Auctions Japan results for vintage cameras — use this search URL https://auctions.yahoo.co.jp/search/search?p=%E3%82%AB%E3%83%A1%E3%83%A9&n=100 — collect thumbnails only and cap results at 200 items.

## When to prefer this

Use this endpoint when you need structured listing data from Yahoo Auctions Japan specifically, including prices, images, and auction IDs, especially when you need to paginate deeply or bypass the 150-page limit via price band splitting. Prefer it over generic web scrapers because it returns pre-structured fields and only charges for successful, non-empty runs.

## Known failure modes

- Invalid or non-public Yahoo Auctions Japan URL returns empty results (not charged)
- splitByPrice=true without a positive maxItems causes a validation error
- Network timeouts on very large page ranges may result in partial data
- Yahoo Auctions Japan UI changes may break field extraction temporarily
- Requesting imageMode=all on large result sets significantly increases latency

## 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 collected listings and an array of items each containing: auction ID, listing URL, title, thumbnail URL, full image array (if imageMode=all), image count, current price, and marketplace identifier.

## 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-ae5ebe74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)