# Yahoo! Auctions Japan Search API Documentation

<p><strong>Yahoo! Auctions Japan Search API Documentation</strong> Search public auction listings by keyword or category. Set status to sold for closed and sold prices. Filter by condition and price range, sort by price or newest and page through results. Each item has id, url, title, price in JPY, bids, watch count, condition, seller, end and start time as ISO 8601 with +09:00, and full-size image URLs. Flea-market rows are excluded. Ids feed the item endpoint unchanged. Each successful request costs 1 credit. A failed request is never billed.</p>

- **Documentation:** [https://scrappa.co/docs/yahoo-auctions-jp-api/yahoo_auctions_jp_search](https://scrappa.co/docs/yahoo-auctions-jp-api/yahoo_auctions_jp_search)
- **API group:** Yahoo! Auctions Japan API
- **Endpoint:** `GET https://scrappa.co/api/yahoo-auctions-jp/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search keywords, for example camera. Required unless category is sent. |
| `category` | string | No | Category id from search results. Up to five comma-separated ids. |
| `condition` | string | No | Comma list of NEW, USED20, USED10 or USED5. |
| `min_price` | number | No | Lowest price in JPY. |
| `max_price` | number | No | Highest price in JPY. |
| `status` | string | No | open (default) or sold. |
| `sort` | string | No | relevance, price_asc, price_desc or newest. |
| `page` | integer | No | Page number, 1 to 100. Defaults to 1. |

## Example response

```json
{
    "data": {
        "page": 1,
        "items": [
            {
                "id": "v1251814298",
                "url": "https://auctions.yahoo.co.jp/jp/auction/v1251814298",
                "bids": 3,
                "price": 12000,
                "title": "Camera lens",
                "images": [
                    "https://auctions.c.yimg.jp/images.auctions.yahoo.co.jp/image/1200x1200/lens.jpg"
                ],
                "seller": {
                    "name": "camera-shop",
                    "rating": 998,
                    "is_store": true
                },
                "status": "open",
                "currency": "JPY",
                "end_time": "2026-11-18T21:08:32+09:00",
                "condition": {
                    "id": "USED20",
                    "name": "Like new"
                },
                "sold_price": null,
                "original_price": 15000
            }
        ],
        "query": "camera",
        "total": 789000,
        "status": "open",
        "has_next": true,
        "per_page": 50
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A filter is missing or invalid. Upstream is not called and the request is not billed. |
| 503 | Transport Unavailable | Upstream did not answer after several tries. The request is not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
